Festero LogoFestero

API, webhooks e MCP

Integre o Festero aos seus sistemas e à sua IA.

Leia eventos, orçamentos, CRM, visitas e financeiro por uma API, receba avisos por webhook quando algo muda e conecte assistentes de IA, como o Claude, pelo servidor MCP.

Abrir a documentaçãoVer os planos

Faz parte dos planos Premium e Enterprise. A documentação é aberta, sem cadastro.

Terminal
# 1. Pedir o token
curl -X POST https://auth.festero.com.br/oauth2/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  -d "scope=festero-api/events:read"

# 2. Chamar a API com o access_token da resposta
curl https://platform.festero.com.br/v1/me \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Três formas de integrar

Do seu sistema ao seu assistente, com os mesmos dados

API de leitura

REST com JSON e OAuth 2.0. Liste e busque eventos, orçamentos, oportunidades, visitas e recebíveis, com paginação por cursor e o filtro updatedSince para sincronizar só o que mudou.

Início rápido

Webhooks

Um aviso no seu endereço HTTPS quando um evento é criado, um orçamento é aceito, uma visita é marcada ou uma parcela é paga. Cada aviso vem assinado e é reenviado se o seu servidor não responder.

Como funcionam

Servidor MCP

Conecte o Claude, o Claude Code, o Cursor ou outro cliente MCP e pergunte em português. São 10 ferramentas, todas de leitura: o assistente nunca altera nada no Festero.

Conectar um assistente

O que dá para ler

Cinco áreas do Festero, cada uma com o seu escopo

Cada credencial lê só as áreas marcadas nela. Os webhooks avisam das mudanças nas mesmas áreas.

  • Eventos

    events:read

    Os eventos da empresa e seus dados principais.

    event.createdevent.status_changedevent.cancelled
  • Orçamentos

    quotes:read

    Orçamentos com as opções e os itens de cada um.

    quote.sentquote.acceptedquote.rejected
  • CRM

    crm:read

    Oportunidades de venda e as etapas do funil.

    opportunity.createdopportunity.stage_changed
  • Visitas

    visits:read

    Visitas agendadas por clientes interessados.

    visit.scheduledvisit.confirmedvisit.cancelled
  • Financeiro

    finance:read

    Recebíveis e o resumo de vendas do período.

    receivable.paidreceivable.overdue

Para assistentes de IA

Pergunte ao Claude como vai o seu buffet

O servidor MCP deixa um assistente consultar os dados da sua empresa e responder em português: quanto foi vendido no mês, quais parcelas estão vencidas, em que etapa está cada oportunidade.

  1. 01No Claude, abra o diretório de conectores e procure Festero.
  2. 02Clique em Conectar e entre com o seu usuário do Festero.
  3. 03Escolha a empresa, marque o que o assistente pode ler e autorize. Pronto: é só perguntar.

O Festero está no diretório de conectores do Claude e vale na web, no computador e no celular, sem chave para copiar. O Claude Code, o Cursor e outros clientes MCP usam o endereço https://platform.festero.com.br/v1/mcp com uma chave MCP criada no Festero.

ClaudeFestero conectado
Dados fictícios

Pergunte em português, do jeito que você falaria com um colega.

Pergunte ao Claude…

Experimente perguntar

Segurança e limites

Feita para rodar em produção

Só leitura

A API, os webhooks e o servidor MCP levam dados para fora. Nada é criado, alterado ou apagado no Festero por eles.

OAuth 2.0 com escopos

A credencial troca o client_id e o client_secret por um token de 60 minutos e lê só as áreas marcadas nela. O segredo aparece uma única vez.

Isolamento por empresa

Cada credencial e cada assistente conectado valem para uma empresa e enxergam só os dados dela.

Webhooks assinados

Todo aviso traz o cabeçalho Festero-Signature para o seu servidor conferir a origem. Sem resposta, o Festero tenta de novo seis vezes, de 1 minuto até 24 horas depois.

Limites por plano

Premium: 120 chamadas por minuto e 100 mil por dia. Enterprise: 600 por minuto e 1 milhão por dia. Cada credencial tem a sua cota.

Status público

A situação da API, dos webhooks e da documentação é publicada em status.festero.com.br, com o histórico de 90 dias.

Status dos serviços

Documentação

Tudo documentado em developers.festero.com.br

Exemplos em curl, JavaScript, Python e C#, a referência de cada rota e uma versão em Markdown de cada página para o seu assistente ler.

Início rápidoDa credencial à primeira chamada.AutenticaçãoClient credentials, token de 60 minutos e escopos.Referência interativaTodas as rotas, parâmetros e respostas, para testar no navegador.WebhooksEventos, reentregas e verificação da assinatura.Servidor MCPComo conectar o Claude, o Claude Code e o Cursor.llms.txtÍndice para agentes de IA. Toda página também existe em Markdown.

FAQ

Perguntas sobre a API

Leve os dados do Festero para onde você precisa

A documentação é aberta, sem cadastro. Para criar a credencial, a empresa precisa estar no plano Premium ou Enterprise.

Criar minha conta grátisAbrir a documentação