Si utilizas la API de Zenvia Customer Cloud para enviar mensajes, es importante configurar un webhook para seguir el estado de los envíos realizados y monitorear los mensajes enviados. Este artículo explica cómo funciona este proceso.
¿Por qué los mensajes enviados por API no aparecen en la plataforma?
Los mensajes enviados directamente por la API no se muestran en la interfaz de la plataforma porque la consulta y el monitoreo de esos mensajes ocurren fuera del entorno de la plataforma. Para seguir estos envíos, necesitas configurar un webhook en tu organización, asegurando que los datos de estado sean recibidos automáticamente.
¿Qué es un webhook y cómo funciona?
Un webhook es un punto de recepción donde la plataforma envía notificaciones en tiempo real siempre que haya actualizaciones relevantes sobre un evento, como el envío, la entrega o la lectura de un mensaje. Con él, puedes:
- Monitorear el estado de los envíos realizados por la API.
- Consolidar la información en informes personalizados.
- Automatizar flujos de trabajo basados en los datos recibidos.
¿Cómo configurar un webhook para monitorear mensajes?
- Crea una URL de recepción:
- Configura un endpoint en tu sistema para recibir las notificaciones enviadas por la plataforma. Este endpoint debe estar preparado para procesar solicitudes HTTP POST.
- Registra el webhook en la plataforma:
- Accede a la sección de configuración de webhooks en la plataforma.
- Ingresa la URL creada en el paso anterior.
- Especifica los eventos que deseas monitorear (como "mensaje enviado", "mensaje entregado" o "mensaje leído").
- Valida el funcionamiento:
- Realiza pruebas para asegurarte de que el webhook está recibiendo las notificaciones correctamente.
- Verifica los registros de recepción en tu sistema para confirmar los eventos.
Documentación de la API
Para más detalles sobre cómo configurar un webhook, consulta la documentación técnica en Zenvia APIs - Webhooks.
En esta documentación, encontrarás:
- Ejemplos de código para crear un webhook.
- Detalles sobre los eventos disponibles.
Próximos pasos
- Configura tu webhook y asegúrate de que está funcionando correctamente.
- Utiliza las notificaciones recibidas para crear informes o paneles de control personalizados.