Un webhook es un mecanismo potente que le permite recibir automáticamente datos de Empower en una URL personalizada una vez que se ha procesado un evento o una llamada.
Configurar esto facilita la integración de Empower con sus sistemas internos, herramientas de CRM, plataformas de BI y otras aplicaciones de terceros. Los casos de uso típicos incluyen el enriquecimiento automático de registros de clientes en su CRM, la generación de paneles personalizados o la activación de flujos de trabajo internos basados en las puntuaciones de las llamadas.
Configuración de sus webhooks en Empower
1) Cree su Webhook
- Para comenzar, vaya a la sección de Configuración de Empower. Desde allí, navegue a Licencias > Configuración de Webhook (etiquetada como la página de "webhooks y claves API").
En esta página, puede ver una lista de sus webhooks existentes y hacer clic en la flecha junto a ellos para ver detalles, editarlos o eliminarlos.
- Haga clic en "añadir webhook" e introduzca un nombre para su nuevo webhook.
- En el campo URL, introduzca el punto de conexión HTTP (ej: https://webhook.site/...) que recibirá los datos. Haga clic en verificar; una vez que el sistema reconozca correctamente la URL, aparecerá un icono de "Verificado".
- Para asegurar las solicitudes entrantes a su sistema, introduzca un token secreto o una clave API personalizada en el campo Authorization Header.
2) Configure los disparadores (triggers) del Webhook
Puede activar un disparador cuando :
- Se crea y procesa una llamada.
- Se añade o elimina una etiqueta (tag) de una llamada.
- Se añade o elimina un marcador (flag) de una llamada.
- Se añade o elimina una nota de una llamada.
- Se añade o elimina un momento de una llamada.
- El resumen de la llamada ha cambiado.
- La puntuación de la llamada ha cambiado.
3) Probar y Guardar
- Puede activar un disparador para probarlo y copiar la carga útil (payload).
- La prueba simula una solicitud POST con datos de ejemplo enviados a su sistema para verificar que se reciban correctamente.
- La carga útil JSON estándar enviada automáticamente tras el análisis de una llamada suele incluir call_details (identificadores de la llamada) y call_score (detalles de la evaluación automatizada).
- Una vez verificada la conexión y configurados los disparadores, guarde el webhook para activar la configuración. Puede eliminarlo fácilmente más adelante si ya no es necesario.
💡 Para asegurar que su integración funcione de forma fluida y segura, siga estas pautas:
- Asegúrese de que la URL de recepción sea segura (HTTPS).
- Asegúrese de que su servidor esté configurado para aceptar solicitudes POST con datos JSON.
- Gestione siempre la clave de autorización en sus encabezados para filtrar correctamente cualquier solicitud no deseada o maliciosa.
Ejemplo de carga útil (Payload) del Webhook
Aquí tiene un ejemplo del JSON enviado automáticamente a su webhook tras el análisis de una llamada:
🎉 ¡Eso es todo! ¡Ahora ya sabe cómo configurar su Webhook en Empower!