Webhooks
Envie eventos do Cosmobots pra sistemas externos em tempo real. Cada evento é um POST HTTP com payload JSON.
Onde fica
Configurações → Integrações → Webhooks.
Criar webhook
- URL — endpoint do sistema externo
- Eventos — checklist de quais eventos quer receber
- Status — ativo/inativo
- Secret (opcional) — pra você validar HMAC do request
Eventos disponíveis
| Evento | Quando dispara |
|---|---|
conversation_created | Conversa nova chega |
conversation_status_changed | Status muda (Pendente→Aberta etc.) |
conversation_resolved | Conversa é resolvida |
message_created | Mensagem nova (ambos lados) |
message_updated | Mensagem editada/reagida |
contact_created | Contato novo |
contact_updated | Atributos do contato mudaram |
Payload exemplo
json
{
"event": "message_created",
"timestamp": "2026-05-04T14:30:00Z",
"data": {
"conversation": { "id": 123, "inbox_id": 5, "status": "open" },
"contact": { "id": 456, "name": "João", "phone": "+5511..." },
"message": {
"id": 789,
"content": "Olá",
"message_type": "incoming",
"created_at": "2026-05-04T14:30:00Z"
}
}
}Test webhook
Botão Disparar evento de teste manda um POST com payload de exemplo. Confira logs no seu sistema.
Logs e retentativas
Se o seu endpoint falhar (5xx ou timeout), o sistema retenta:
- Após 30s
- Após 5min
- Após 1h
- Após 6h
Após isso, descarta. Você vê todos os eventos (sucesso/falha) em Webhooks → Logs.
Diferença pro bloco Webhook em fluxos
| Webhook global | Bloco Webhook | |
|---|---|---|
| Quem dispara | Sistema (eventos) | Bot dentro do fluxo |
| Direção | Cosmobots → externo | Cosmobots → externo (ou ↔) |
| Quando | Eventos automáticos | Lógica do fluxo |