Los webhooks y las claves API en Empower le permiten automatizar la transferencia de sus datos de llamadas a sus sistemas internos, CRM y herramientas de BI. En esta guía, aprenderá cómo crear y configurar un webhook, personalizar sus activadores y generar claves API seguras.

Los webhooks y las claves API en Empower

1. Acceder al menú y crear un webhook

Acceda al espacio de configuración para desarrolladores para añadir un nuevo punto de conexión (endpoint).

1. Vaya a la sección Ajustes de su interfaz Empower
2. En el menú de la izquierda, haga clic en la opción Desarrollador.
3. Consulte la lista de sus webhooks existentes o haga clic en Añadir nuevo.
4. Introduzca el Nombre de su webhook en el campo dedicado
5. Introduzca la URL de solicitud (punto de conexión HTTP, p. ej., https://webhook.site/...) en el campo URL. Haga clic en Verificar para validar la URL hasta que aparezca el icono "Verificado".
6. Introduzca un token secreto o clave personalizada para asegurar las solicitudes entrantes.

2. Configurar los activadores del webhook

Activación de los disparadores

Defina los eventos precisos que desencadenarán el envío automático de datos a su sistema.

1. Active o desactive los interruptores (toggles) según sus necesidades de gestión de llamadas:
   • Llamadas: Se activa cuando se crea y procesa una llamada.
   • Etiquetas, Banderas y Notas: Se activa al añadir o eliminar una etiqueta, una bandera o una nota.
   • Momentos: Se activa al añadir o quitar un momento de llamada.
   • Resumen y Puntuación de llamada: Se activa cuando se modifica un resumen de llamada o una puntuación.
   • Análisis de Marco de Referencia: Se activa cuando se actualiza manualmente un análisis de marco.

Probar el webhook

Simule un envío de datos reales para verificar la recepción de la carga útil (payload) JSON antes de la puesta en producción.

1. Haga clic en el botón Probar activador para simular la creación y el procesamiento de una llamada.
2. Haga clic en el botón Copiar carga útil para verificar la estructura del JSON enviado (incluidos los detalles de la llamada y la puntuación de evaluación).
3. Una vez que la prueba se realice con éxito, haga clic en Guardar webhook para validar la configuración.

• La prueba simula una solicitud POST con datos de ejemplo enviados a su sistema para comprobar la correcta recepción. 
• La carga útil JSON estándar enviada automáticamente tras el análisis de una llamada suele incluir los call_details (identificadores de la llamada) y el call_score (detalles de la evaluación automatizada).
• Una vez verificada la conexión y configurados sus activadores, guarde el webhook para activar la configuración. Podrá eliminarlo fácilmente más adelante si ya no lo necesita.

Ejemplo de carga útil (Payload) de Webhook 

A continuación se muestra un ejemplo del JSON enviado automáticamente a su webhook tras el análisis de una llamada:

4. Generar y gestionar sus claves API en Empower

Cree claves de acceso API para asegurar la autenticación de sus aplicaciones de terceros.

1. En el menú lateral izquierdo de la sección Desarrollador, haga clic en la pestaña Claves API.
2. Haga clic en el botón Añadir una clave API
3. Introduzca el Nombre de la clave API en el campo correspondiente.
4. Busque y seleccione el Usuario asociado en el menú desplegable
5. Haga clic en Mostrar y luego en Copiar para guardar su clave API en un lugar seguro.

Puede modificar o revocar una clave API en cualquier momento haciendo clic en el botón de edición situado junto a la clave en su lista

🎉 ¡Ahora ya sabe cómo configurar webhooks y claves API en Empower y puede automatizar la transferencia de sus datos de llamadas a sus herramientas internas con total seguridad!