Se você utiliza a API do Zenvia Customer Cloud para enviar mensagens, é importante configurar um webhook para acompanhar o status dos disparos realizados e monitorar as mensagens enviadas. Este artigo explica como funciona esse processo.
Por que mensagens enviadas via API não aparecem na plataforma?
As mensagens enviadas diretamente pela API não são exibidas na interface da plataforma porque a consulta e o monitoramento dessas mensagens ocorrem fora do ambiente da plataforma. Para acompanhar esses envios, você precisa configurar um webhook na organização, garantindo que os dados de status sejam recebidos de forma automática.
O que é um webhook e como ele funciona?
Um webhook é um ponto de recepção onde a plataforma envia notificações em tempo real sempre que há atualizações relevantes sobre um evento, como o envio, entrega ou leitura de uma mensagem. Com ele, você pode:
- Monitorar o status dos disparos realizados pela API.
- Consolidar as informações em relatórios personalizados.
- Automatizar fluxos de trabalho com base nos dados recebidos.
Como configurar um webhook para monitorar mensagens?
- Crie uma URL de recepção:
- Configure um endpoint em seu sistema para receber as notificações enviadas pela plataforma. Esse endpoint deve estar preparado para processar requisições HTTP POST.
- Cadastre o webhook na plataforma:
- Acesse a seção de configuração de webhooks na plataforma.
- Insira a URL criada no passo anterior.
- Especifique os eventos que deseja monitorar (como "mensagem enviada", "mensagem entregue" ou "mensagem lida").
- Valide o funcionamento:
- Realize testes para garantir que o webhook esteja recebendo as notificações corretamente.
- Verifique os logs de recebimento no seu sistema para confirmar os eventos.
Documentação da API
Para mais detalhes sobre como configurar um webhook, consulte a documentação técnica em Zenvia APIs - Webhooks.
Nessa documentação, você encontra:
- Exemplos de código para criar um webhook.
- Detalhes sobre os eventos disponíveis.
Próximos passos
- Configure seu webhook e certifique-se de que ele está funcionando corretamente.
- Utilize as notificações recebidas para criar relatórios ou dashboards customizados.