Webhooks¶
Webhooks são notificações HTTP enviadas pela Moonu para uma URL configurada por você. Eles permitem atualizar CRM, relatórios, automações e outros sistemas sem consultar continuamente a plataforma.
Fluxo de uma entrega¶
- A Moonu gera um evento quando ocorre uma ação relevante na plataforma.
- Cada endpoint ativo inscrito no evento recebe uma requisição HTTP
POST. - Sua aplicação valida a assinatura, processa o corpo e responde com um status
2xx. - Se a entrega falhar, a Moonu poderá tentar novamente. Por isso, o processamento deve ser idempotente.
Não assuma ordem nem entrega única
Webhooks têm entrega at-least-once. Uma mesma entrega pode ser recebida mais de uma vez e eventos podem chegar fora de ordem. Use eventId para deduplicar e occurredAt para ordenar dados no seu domínio quando necessário.
Correlação de chamadas
Em eventos que descrevem uma chamada, use data.call.id para correlacionar registros da mesma chamada. Não use eventId para isso: ele identifica o evento/entrega individual.
Evento disponível¶
| Evento | Versão | Descrição |
|---|---|---|
call.completed |
1 |
Uma chamada foi concluída e seu registro público foi consolidado. |
recording.available |
1 |
Uma gravação está disponível para download temporário. |