Webhooks no buffet: 7 automações que começam no Festero

Imagine ligar para a portaria a cada cinco minutos perguntando se a encomenda chegou. Funciona, mas cansa todo mundo e quase sempre a resposta é “ainda não”. O jeito sensato é o porteiro interfonar quando ela chegar.

Webhook é o interfone dos sistemas. Em vez de o seu sistema perguntar ao Festero o tempo todo se algo mudou, o Festero avisa na hora em que acontece: orçamento aceito, contrato assinado, parcela paga, visita marcada. O aviso chega num endereço que você cadastrou e, do outro lado, dispara o que você quiser.

Este texto mostra os avisos que o Festero envia, sete automações que fazem sentido num buffet e, no fim, o que a pessoa técnica precisa saber para implementar.

Os 13 avisos, pelo momento do negócio

Venda

• opportunity.created: nasceu uma oportunidade no CRM, seja por cadastro, por mensagem num canal de atendimento conectado, por pedido de orçamento na vitrine ou por agendamento de visita na página pública
• opportunity.stage_changed: a oportunidade mudou de etapa do funil, inclusive quando foi fechada como ganha ou perdida
• quote.sent: um orçamento foi enviado ao cliente, ou teve a validade renovada
• quote.accepted: o orçamento foi aceito, pelo cliente no link ou pela empresa no Festero
• quote.rejected: o orçamento foi recusado

Visita

• visit.scheduled: uma visita foi agendada ou reagendada
• visit.confirmed: a empresa confirmou um pedido de visita
• visit.cancelled: a visita foi cancelada, pela empresa ou pelo cliente, ou o pedido foi recusado

Evento

• event.created: um evento foi criado, inclusive quando nasce de um orçamento aprovado
• event.status_changed: a situação do evento mudou. O aviso diz o que provocou a mudança: contrato enviado, contrato assinado, contrato cancelado, mudança feita à mão ou importação
• event.cancelled: o evento foi cancelado ou excluído

Dinheiro

• receivable.paid: o Festero registrou um pagamento, total ou parcial, numa parcela
• receivable.overdue: uma parcela passou a vencida. O aviso sai uma vez, na virada

Você escolhe quais desses avisos quer receber. E só aparecem para escolha os avisos das áreas que você mesmo enxerga no Festero: quem não tem acesso ao financeiro não consegue assinar os avisos de parcela.

7 automações que fazem sentido num buffet

1. Comemorar a venda no canal da equipe

Aviso: quote.accepted. O cliente aprovou o orçamento pelo link às 22h de um domingo. Na segunda de manhã, o comercial descobre, conta para a cozinha, que conta para a produção. Com o webhook, a mensagem cai no canal da equipe no mesmo minuto, com a data da festa. Parece detalhe, mas venda comemorada em público é combustível para o time comercial, e a operação ganha dias de antecedência para se planejar.

2. Abrir o checklist de produção quando o contrato é assinado

Aviso: event.status_changed com a origem “contrato assinado”. Muitos buffets controlam a produção numa ferramenta de tarefas à parte. A assinatura do contrato é o momento certo para abrir o cartão do evento lá, com o checklist padrão: degustação, decoração, equipe, fornecedores. Ninguém precisa lembrar de criar.

3. Datas disponíveis do site sempre certas

Avisos: event.status_changed e event.cancelled. Se o site do buffet mostra as datas livres, alguém atualiza essa lista à mão, e ela vive desatualizada. Com os avisos de evento, o site marca a data como ocupada quando o evento é agendado e libera quando ele é cancelado. O cliente para de pedir orçamento para um sábado que já foi vendido.

4. Parcela paga direto no ERP ou na contabilidade

Aviso: receivable.paid. Para quem tem um ERP do grupo ou manda movimento para o escritório de contabilidade, cada pagamento registrado no Festero pode virar lançamento lá, na hora. O aviso diz se o pagamento foi total ou parcial, e o valor vem da API, pelo endereço que acompanha o aviso.

5. Fila do financeiro para parcela vencida

Aviso: receivable.overdue. A cobrança automática do Festero já lembra o cliente. O webhook serve para o que vem depois: criar uma tarefa para o financeiro ligar quando a parcela vencida passa de certo valor, ou avisar o dono quando uma festa grande atrasa. A régua cuida do volume; a pessoa cuida das exceções.

6. Visita marcada chega a quem vai atender

Avisos: visit.scheduled, visit.confirmed e visit.cancelled. Visita é o momento de maior chance de fechar. Levar o aviso de visita marcada, remarcada ou cancelada para onde a equipe já está, seja o canal do time ou o painel da recepção, evita a cena clássica do cliente chegando para conhecer o espaço sem ninguém esperando por ele.

7. Funil de marketing em tempo real

Avisos: opportunity.created e opportunity.stage_changed. A agência que cuida dos anúncios costuma enxergar só o lead chegando. Com esses avisos, o painel de marketing acompanha cada oportunidade até virar visita, proposta e venda, e a conversa sobre o retorno dos anúncios passa a ser feita com dados do funil de vendas, não com impressão.

Onde os avisos chegam

O destino do webhook é um endereço HTTPS na internet. Ele pode ser:

• Um sistema próprio, quando a empresa tem desenvolvedor ou fornecedor de TI
• Uma plataforma de automação que recebe webhooks, como n8n, Make ou Zapier, onde alguém com perfil técnico monta o fluxo sem escrever um sistema inteiro. Nesse caso, inclua no fluxo a conferência da assinatura do aviso

Cada empresa cadastra um endereço. Para mandar o mesmo aviso a vários lugares, o destino distribui: é exatamente o que as plataformas de automação fazem bem.

Por que o aviso é curto

Um aviso do Festero traz o tipo do acontecimento, os identificadores, a situação e as datas. Não traz contato de pessoas, custo, margem nem texto livre. Veja um orçamento aceito:

O detalhe, como o valor do orçamento e os itens, vem da API, pelo endereço que acompanha o aviso (resource_url) e com uma credencial que tenha permissão para ler aquela área. Assim o webhook nunca entrega mais do que a API deixaria ler, e mesmo um aviso que caísse no lugar errado não exporia dados de clientes.

Para quem vai implementar

Se você é a pessoa técnica do projeto, estas são as regras do contrato de entrega. A documentação completa, com código em Node, Python e C#, está em developers.festero.com.br/webhooks.

• Cadastro: na tela API do Festero, seção Webhook. Endereço HTTPS na porta 443, com domínio público (nada de IP, localhost ou rede interna). O Festero não segue redirecionamentos
• Ativação: o Festero envia um ping de teste, e o endereço só passa a receber avisos reais depois de responder 2xx a ele
• Assinatura: todo aviso traz o cabeçalho Festero-Signature, um HMAC-SHA256 do instante e do corpo bruto com o segredo whsec_ do endereço. Confira sempre e recuse avisos com instante a mais de 5 minutos do seu relógio
• Resposta: qualquer 2xx em até 10 segundos. Verifique, guarde numa fila, responda e processe depois
• Reentregas: sem 2xx, o Festero tenta de novo depois de 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas e 24 horas, num total de 7 tentativas ao longo de cerca de 33 horas
• Duplicidade e ordem: o mesmo aviso pode chegar mais de uma vez, então deduplique pelo Festero-Event-Id. A ordem não é garantida: busque o estado atual pelo resource_url
• Desativação: 10 falhas seguidas, com a primeira há mais de 24 horas, desativam o endereço e avisam quem gerencia a API. Corrigido o problema, é só reativar na tela
• Volume: até 3.000 entregas por hora por endereço. O excedente é adiado para a hora seguinte, sem descarte
• Acompanhamento: a tabela Entregas recentes mostra cada tentativa, a resposta do seu endereço e de quem foi a falha, e permite reenviar avisos de até 7 dias

Perguntas frequentes

Preciso de um programador?

Precisa de alguém técnico: um desenvolvedor, o fornecedor de TI ou uma pessoa que domine uma plataforma de automação. O cadastro do endereço no Festero é simples, mas alguém precisa construir o que acontece do outro lado.

O webhook manda mensagem para o meu cliente?

Não. O webhook avisa os seus sistemas. As mensagens para clientes, como contrato para assinar e lembrete de parcela, continuam saindo pelo próprio Festero.

E se o meu sistema ficar fora do ar?

O Festero tenta entregar por cerca de 33 horas. Se ainda assim o aviso não chegar, o dado continua disponível na API: o seu sistema recupera o período consultando só o que mudou desde a última sincronização.

Posso escolher quais avisos receber?

Sim. No cadastro do endereço você marca os avisos que interessam, entre os das áreas que você enxerga no Festero.

Em quais planos os webhooks estão disponíveis?

Nos planos Premium e Enterprise, junto com a API de leitura e o servidor MCP. Veja a página de planos.

Deixe o Festero avisar

Toda informação que alguém repassa à mão é uma informação que chega atrasada, chega errada ou não chega. Os webhooks tiram esse intermediário: o acontecimento no Festero vira ação no sistema certo, no mesmo minuto.

Veja todos os avisos e áreas na página de API e integrações, leia a visão geral de API, webhooks e MCP no Festero ou comece o teste de 15 dias.