Webhooks

Visão Geral

Webhooks enviam dados automaticamente para uma URL quando eventos acontecem na Nuria. Ideal para sincronização em tempo real com sistemas externos.

🔗 Acesse: Integrações

- Acesse Configurações > Integrações > Webhooks

- Clique em Novo webhook

- Configure:

- URL: Endpoint que receberá os dados

- Eventos: Quais eventos disparam o webhook

- Secret: Chave para validar a autenticidade

Eventos disponíveis:

- Ticket: criado, atualizado, resolvido, deletado

- Contato: criado, atualizado, deletado

- Deal: criado, movido, ganho, perdido

- Mensagem: recebida, enviada

- Agendamento: criado, cancelado

- Os dados são enviados em formato JSON via POST

- Incluem tipo do evento, timestamp e dados do objeto

- O header inclui a assinatura para validação

- Use o botão Testar para enviar um evento de teste

- Verifique se sua URL recebe e processa corretamente

- Veja o histórico de entregas

- Identifique falhas e reenvie quando necessário

- Sempre valide a assinatura do webhook por segurança

- Implemente retry logic na sua URL de destino

- Monitore falhas de entrega regularmente

- Use HTTPS na URL de destino