Webhooks
Webhook é o caminho inverso da API: em vez de o seu sistema perguntar ao Kemera se algo mudou, o Kemera chama um endereço do seu sistema assim que a mudança acontece.
:::info Em preparação
Os webhooks saem junto com a API pública e ainda não estão disponíveis. A lista definitiva de eventos e o conteúdo de cada aviso serão publicados aqui.
:::
Como vai funcionar
- O cadastro é feito na tela do sistema, por um administrador: o endereço que vai receber os avisos e os eventos que interessam.
- Cada aviso vem assinado. O Kemera gera um segredo, mostrado uma única vez no cadastro, e assina cada envio com ele e com a hora do envio. O seu sistema confere a assinatura e recusa avisos antigos, para que ninguém consiga forjar ou repetir um aviso.
- Falhou, o Kemera tenta de novo, algumas vezes, com intervalos crescentes. Um endereço que falha seguidamente é desligado, e o administrador é avisado para corrigir e religar.
Eventos previstos
A lista ainda pode mudar até a publicação. Os eventos em estudo cobrem:
| Assunto | Eventos |
|---|---|
| Conversas | criada, atribuída, resolvida |
| Mensagens | recebida, enviada, com falha no envio |
| Contatos | criado, atualizado |
| Oportunidades | criada, mudou de etapa, ganha, perdida |
| Agendamentos | confirmado, remarcado, cancelado |
| Tarefas | criada, concluída |