Tecnologia
API, webhooks e MCP no Festero: o que o seu buffet ganha
Até aqui, para ver os números do buffet fora do Festero, alguém tinha que exportar uma planilha, colar em outra e mandar no grupo. Toda segunda-feira, do mesmo jeito. A partir de agora existe outro caminho: o Festero passou a entregar os dados da sua empresa para os seus sistemas e para a sua inteligência artificial, sem ninguém copiar e colar.
São três peças novas: uma API de leitura, webhooks e um servidor MCP. Os nomes são técnicos, mas a ideia é simples, e este texto explica cada uma sem jargão, mostra o que dá para fazer com elas e deixa claro o que elas não fazem.
As três peças, em português de dono de buffet
API de leitura: outro sistema pergunta, o Festero responde
A API é uma porta por onde um programa consulta os dados do Festero. O seu ERP, o painel de BI da rede ou o site do buffet pergunta “quais eventos estão confirmados para março?” e recebe a resposta pronta, em formato que computador entende. Ninguém precisa abrir o Festero e exportar nada.
Webhooks: o Festero avisa quando algo acontece
O webhook faz o caminho inverso. Em vez de o seu sistema perguntar de tempos em tempos se algo mudou, o Festero avisa na hora: um orçamento foi aceito, uma parcela foi paga, uma visita foi marcada, um evento foi cancelado. O aviso chega no endereço que você cadastrou e dispara o que você quiser do outro lado.
Servidor MCP: a sua IA consulta o Festero
MCP (Model Context Protocol) é o padrão que assistentes de IA como o Claude usam para conversar com outros sistemas. Com o servidor MCP do Festero, você conecta o Claude à sua empresa e pergunta em português: “quanto vendemos em outubro e quanto ainda falta receber?”. O assistente consulta o Festero e responde com os seus números. O passo a passo está em como conectar o Claude ao Festero.
As três usam os mesmos dados, as mesmas permissões e a mesma segurança. A diferença é quem pergunta: um sistema, o próprio Festero avisando, ou uma IA.
O que dá para ler do Festero
Os dados foram divididos em cinco áreas. Cada acesso que você cria escolhe quais delas pode ler, e nada além disso:
- Eventos: data, horário, situação, tipo, cliente e valor total de cada evento
- Orçamentos: os orçamentos enviados, com as opções e os itens de cada um
- CRM: as oportunidades de venda e a etapa do funil em que cada uma está
- Visitas: as visitas agendadas por clientes interessados
- Financeiro: os recebíveis, parcela por parcela, e o resumo de vendas de qualquer período
Os webhooks avisam das mudanças nessas mesmas áreas: são 13 avisos diferentes, de “orçamento aceito” a “parcela vencida”. A lista completa, com exemplos de uso, está no post sobre automações com webhooks no buffet.
O que cada tipo de empresa ganha
Buffet de uma unidade: respostas sem abrir três telas
Para o dono que cuida de tudo, o ganho mais imediato é o MCP. Em vez de abrir o financeiro, depois a agenda, depois o CRM, você pergunta ao Claude e recebe a resposta consolidada: as parcelas vencidas, as visitas da semana, os orçamentos enviados que ainda não tiveram resposta. Sem programador, sem configuração técnica.
O segundo ganho são os avisos. Um webhook ligado a uma ferramenta de automação pode, por exemplo, mandar uma mensagem no canal da equipe sempre que um orçamento é aceito. A cozinha e a produção ficam sabendo da festa nova no mesmo minuto em que o cliente aprova.
Rede de buffets e franquias: uma visão só de todas as unidades
Em uma rede, cada unidade é uma empresa no Festero, com os próprios dados. A API deixa o escritório central puxar as vendas, os eventos e os recebíveis de cada unidade para um painel único, atualizado sozinho. É o fim do e-mail de fechamento que cada gerente manda num formato diferente. Sobre a gestão de redes, vale ler também como gerir múltiplas unidades com controle central.
Empresa com ERP, BI ou contabilidade própria: dados no lugar certo
Casas de eventos que fazem parte de um grupo maior, hotéis com salão de festas e empresas com ERP corporativo precisam que o faturamento dos eventos apareça no sistema da empresa. A API entrega os recebíveis e o resumo de vendas; o webhook avisa quando uma parcela é paga. A integração deixa de depender de alguém lembrar de lançar. Os detalhes estão no post sobre integração do sistema de buffet com BI e ERP.
Agências e times de marketing: o funil de verdade
Quem cuida dos anúncios de um buffet normalmente só enxerga o lead chegando. O que acontece depois (visita, orçamento, contrato) fica no sistema do buffet. Com a área de CRM liberada, o painel de marketing passa a mostrar quantas oportunidades viraram visita e quantas viraram venda, e a conversa sobre resultado deixa de ser no achismo.
Desenvolvedores e integradores: documentação aberta
A documentação completa está em developers.festero.com.br, aberta e sem cadastro, com exemplos em curl, JavaScript, Python e C#, uma referência interativa para testar cada rota no navegador e o contrato no padrão OpenAPI. Cada página também existe em Markdown, e o índice llms.txt deixa um assistente de IA ler a documentação inteira para ajudar a escrever a integração.
O que a API, os webhooks e o MCP não fazem
Vale ser direto, porque isso define o que esperar:
- Não alteram nada no Festero. As três peças só leem. Não existe forma de criar orçamento, dar baixa em parcela ou cancelar evento por elas. O cadastro continua sendo feito no Festero
- Não entregam contato de pessoas. Telefone, e-mail e documento de clientes e leads não saem pela API
- Não entregam custo nem margem. Todo valor em dinheiro é o preço ao cliente. O resultado de cada festa continua visível só dentro do Festero, para quem tem permissão
- A API e os webhooks pedem alguém técnico. Alguém precisa escrever a integração do lado do seu sistema. Para conectar o Claude, não: é login e autorização
Essas escolhas foram de propósito. Integração que escreve dados abre espaço para erro em massa, e integração que entrega telefone de cliente abre espaço para vazamento. O detalhe de como cada proteção funciona está em o que sai do Festero e o que nunca sai.
Planos e limites
A API, os webhooks e o servidor MCP fazem parte dos planos Premium e Enterprise. O que muda entre eles é o volume de uso:
- Premium: 120 chamadas por minuto e 100 mil por dia
- Enterprise: 600 chamadas por minuto e 1 milhão por dia
Para comparar, um painel que se atualiza a cada 15 minutos consome algumas centenas de chamadas por dia. O limite do Premium sobra para a imensa maioria dos buffets. Veja o que mais entra em cada plano na página de planos.
Como começar
- Confira se a sua empresa está no plano Premium ou Enterprise
- Garanta que quem vai configurar tenha a permissão Gerenciar a API pública e as chaves MCP, em Perfis e Permissões
- Para conectar o Claude: no diretório de conectores do Claude, procure Festero, entre com o seu usuário e autorize
- Para a API e os webhooks: no Festero, abra API do Festero no menu lateral, crie uma credencial com as áreas que a integração precisa e entregue os dados ao seu desenvolvedor, junto com o link da documentação
O item API do Festero aparece no menu à medida que a API é liberada para cada empresa. Se a sua tem o plano certo e o item ainda não apareceu, fale com o suporte.
Perguntas frequentes
Preciso de um programador para usar?
Depende da peça. Para conectar o Claude pelo MCP, não: você procura o Festero no diretório de conectores, entra com o seu usuário e autoriza. Para a API e os webhooks, sim, porque alguém precisa escrever a integração do lado do sistema que vai receber os dados.
A integração pode apagar ou mudar dados do meu buffet?
Não. A API, os webhooks e o servidor MCP são somente de leitura. Nenhum deles cria, altera ou apaga informação no Festero.
Quem da minha equipe pode criar um acesso?
Só quem tem a permissão Gerenciar a API pública e as chaves MCP. E o acesso criado nunca enxerga mais do que a própria pessoa enxerga no Festero: quem não vê o financeiro não consegue liberar o financeiro para uma integração.
Funciona com o ChatGPT?
O conector do ChatGPT está em teste e ainda não foi liberado. Hoje funcionam o Claude (na web, no computador e no celular), o Claude Code, o Cursor e outros clientes compatíveis com MCP.
Como sei se a API está funcionando?
A situação da API, dos webhooks e da documentação é publicada em status.festero.com.br, com o histórico dos últimos 90 dias.
Os dados do buffet onde você precisa deles
Um sistema de gestão guarda a operação inteira do buffet: venda, contrato, agenda, financeiro. Com a API, os webhooks e o MCP, esses dados deixam de ficar presos numa tela e passam a alimentar o painel da rede, o ERP do grupo, o canal da equipe e o assistente de IA que você já usa, sempre com a segurança de que nada é alterado e nada sensível sai.
Veja tudo o que a integração oferece na página de API e integrações, conheça o sistema para buffet ou comece o teste de 15 dias. Se preferir conversar antes, agende uma demonstração.