Docs

Webhooks

Como configurar webhooks no TicketBird para receber notificações de pedido confirmado.

Webhooks conectam o TicketBird ao seu sistema em tempo real. No fluxo atual, você recebe notificações quando um pedido é confirmado, sem depender de consulta manual no painel.

Quando usar

  • Quando seu time precisa automatizar ações após confirmação de pedido.
  • Quando você quer integrar CRM, ERP, automações internas ou ferramentas de comunicação.

Como configurar (passo a passo)

  1. No painel, acesse Organização → Webhooks.
  2. Clique em Novo webhook.
  3. Em Evento, selecione Pedido confirmado.
  4. Informe a URL do endpoint que receberá o evento.
  5. Clique em Criar webhook.
  6. Use Testar webhook para enviar um evento de teste e validar o payload.

Evento disponível hoje

  • ORDER_CONFIRMED (Pedido confirmado)

Regras e limites

  • A URL precisa ser válida e usar HTTPS.
  • O botão Testar webhook não altera o status do webhook.
  • Você pode editar URL, desativar/ativar e excluir o webhook.
  • Webhooks desativados não enviam novos eventos.

Boas práticas de integração

  • Use um caminho exclusivo para o TicketBird (ex.: /webhooks/ticketbird).
  • Registre logs de recebimento no seu servidor para auditoria.
  • Trate reenvios e idempotência no seu endpoint para evitar processamento duplicado.
Onde costuma dar errado
  • Publicar webhook sem testar payload e descobrir falha em produção.
  • Usar endpoint genérico e misturar eventos de múltiplas origens.
  • Desativar webhook por manutenção e esquecer de reativar depois.
Próximo: Novidades