Como configurar webhooks no Koalendar

Use webhooks para receber atualizações em tempo real — são enviadas solicitações POST quando alguém agendar, remarcar ou cancelar um compromisso na sua página de agendamento.

Isso é útil se você estiver criando automações personalizadas usando plataformas como Zapier, Make (Integromat), n8n ou seu próprio código de back-end.

Passo 1: Crie seu ponto de extremidade do webhook

Abra o Editor da sua página de reservas
Vá até a seção “Após a reserva ”
Insira o endpoint da URL do seu webhook (o destino das solicitações POST)

Etapa 2: Testar e automatizar

Faça uma reserva de teste, remarque ou cancele para acionar um webhook
Verifique os logs do servidor ou a ferramenta de webhook para confirmar o recebimento da solicitação POST
Cada carga útil inclui:
- Tipo de evento:
  - event.created – quando alguém marca uma consulta
  - evento.provisório – quando alguém faz uma reserva provisória
  - evento.remarcado – quando um convidado altera o horário da reserva
  - evento cancelado – quando um convidado cancela sua consulta
- Detalhes da reserva (nome, e-mail, local, hora_de_início, hora_de_término, etc.)
- O convidado responde por meio de campos do convidado —com IDs e valores das perguntas

Você pode usar isso para:

Acionar e-mails ou alertas internos
Atualize seu CRM ou banco de dados
Sincronize dados entre aplicativos por meio do Zapier ou de uma lógica personalizada

Exemplo de carga útil

O campo `invited.fields` contém as respostas às perguntas que você faz no formulário de reserva.

A chave do objeto é oID da pergunta, que você encontra ao editar uma pergunta (na parte superior):

🛠️ O webhook não foi recebido ou chegou atrasado?

Página de reserva correta: cada página de reserva possui seu próprio URL de webhook. Verifique se ele está configurado na página que recebeu a reserva e se você salvou a página.
URL completo: digite o endereço completo, começando por https:// . Um URL inválido é ignorado.
Responda rapidamente: Seu endpoint deve aceitar um POST com um corpo JSON e responder com um 2xx status. Se ocorrer um tempo limite ou for retornado um erro, o Koalendar tenta novamente mais tarde, de modo que o webhook chega com atraso.
Nada bloqueando o acesso: certifique-se de que nenhum login, firewall ou filtro de IP bloqueie as solicitações ao seu endpoint.
Teste a entrega: cole uma URL temporária de uma ferramenta como o webhook.site, faça uma reserva de teste e verifique se a solicitação chega.

ℹ️ Perguntas frequentes

Quais eventos acionam um webhook?

event.created , evento.provisório , evento.remarcado , e evento cancelado

Posso usar o Zapier com webhooks?

Sim! Os webhooks podem ser usados para acionar ações no Zapier ou em qualquer plataforma de integração que aceite solicitações POST. Leia nosso guia sobre o Zapier.

O que acontece se meu webhook falhar?

O Koalendar tentará novamente se o seu endpoint estiver temporariamente inacessível ou retornar um erro.

Posso atualizar ou remover meu webhook mais tarde?

Sim. Basta voltar às configurações de webhook no editor da sua página de reservas.