Ajustes generales
Webhooks
Recibir automáticamente un evento en sus sistemas en cuanto una llamada de Leexi ha sido transcrita y analizada.
Definición: Un webhook avisa a sus sistemas sin que tenga que consultar Leexi. En cuanto una llamada se transcribe y sus insights de IA se generan, Leexi envía una petición a la URL que ha configurado, con el contenido de la llamada.
Vídeo de la funcionalidad
No hay ningún vídeo disponible por el momento.
¿A quién va dirigido?
- A los equipos técnicos que quieren desencadenar un tratamiento automático al final de cada llamada.
- A los administradores que alimentan un almacén de datos, una herramienta interna o una automatización propia.
Permisos y licencias
- Consultar los webhooks requiere el permiso de lectura de los webhooks; crearlos y modificarlos, el permiso de escritura.
- Los datos enviados siguen el formato de la API pública: la referencia de los webhooks la describe en detalle.
Guía de uso
Abrir la página Webhooks
Vaya a Ajustes > Configuración avanzada > Webhooks. La lista muestra para cada webhook su nombre, sus reglas de acceso, su URL, su descripción y su estado.
Crear un webhook
Haga clic en "Añadir" e indique un nombre, la URL que recibirá los eventos y una descripción. La URL debe ser accesible desde Internet y solo puede ser utilizada por un webhook de su empresa.
Definir las reglas de acceso
Hay tres modos disponibles:
- Vinculado a un usuario: el webhook solo recibe los eventos de las llamadas a las que ese usuario tiene acceso.
- Acceso a todo: el webhook recibe los eventos de todas las llamadas de la empresa.
- Acceso personalizado: después de guardar, se le redirige a la página Reglas de acceso para delimitar el alcance exacto.
Tratar los eventos recibidos
Su endpoint recibe una petición POST que contiene el tipo de evento y los datos de la llamada. Responda con un código de éxito y trate el contenido por su lado.
Activar o suspender un webhook
El interruptor de la columna "Activo" suspende el envío de los eventos sin eliminar la configuración, por ejemplo mientras realiza un mantenimiento por su lado.
Para profundizar
- Hoy solo existe un tipo de evento,
call.processed, enviado una vez que la transcripción y los insights de IA se han generado por completo. - El cuerpo de la petición contiene el nombre del evento y los datos de la llamada, en el mismo formato que la llamada detallada de la API pública.
- Si su endpoint no responde o devuelve un error, Leexi lo reintenta hasta diez veces con un retardo creciente: 10 segundos, 1 minuto, 5, 15 y 30 minutos, 1 hora, 6 horas y después cada 24 horas.
- Pasados esos diez intentos, el webhook se desactiva automáticamente y los administradores de la empresa reciben un correo informándoles. Reactívelo en cuanto su endpoint esté restablecido.
- Las claves API cubren la necesidad inversa: consultar Leexi en el momento que le convenga en lugar de esperar un evento.
Preguntas frecuentes
Cualquier respuesta de éxito es suficiente. Cualquier respuesta de error, igual que la ausencia de respuesta, desencadena un nuevo intento.
Porque diez intentos de envío consecutivos han fallado. Compruebe que su URL es accesible y que responde correctamente, y reactive después el webhook.
No, ambos funcionan de forma independiente. Una clave API sigue siendo útil si quiere recuperar datos complementarios tras recibir un evento.
Sí, configurando un acceso personalizado y las reglas de acceso correspondientes.
Puntos de atención
- La petición no va firmada: utilice una URL difícil de adivinar y, si necesita validar los datos recibidos, vuelva a consultar la API pública.
- Un endpoint lento o no disponible acaba desactivando el webhook: es mejor acusar recibo rápidamente y tratar el contenido después.
- Los eventos no se reenvían para el periodo en el que el webhook estuvo inactivo: las llamadas procesadas durante ese tiempo deben recuperarse a través de la API pública.
- El contenido enviado incluye los datos de la llamada: asegúrese de que el sistema destinatario ofrece el nivel de confidencialidad esperado.