Gestionar webhooks

Los webhooks envían eventos de Klang a tu servidor. Úsalos para actualizar un CRM, publicar en un chat o iniciar un proceso cuando termina de procesarse una reunión.

Cada webhook es personal y solo recibe eventos del contenido al que su propietario tiene acceso.

Crear un webhook

1. Abre Ajustes → Desarrolladores → Webhooks
2. Haz clic en Crear webhook

3. Escribe la URL HTTPS pública que recibirá los eventos
4. Opcional: añade una Descripción
5. Selecciona los eventos; los tres están marcados de forma predeterminada
6. Haz clic en Crear

Klang muestra una sola vez el secreto de firma. Cópialo y guárdalo en un lugar seguro para verificar que las solicitudes proceden de Klang.

Eventos disponibles

• conversation.ready: la transcripción y el análisis de IA están listos
• conversation.failed: ha fallado el procesamiento de una reunión o un archivo
• conversation.deleted: se ha eliminado una reunión o un archivo

Cada carga incluye un identificador, el tipo y una referencia a la conversación. Consulta la documentación de webhooks para ver el esquema, el encabezado de firma y ejemplos de verificación.

Supervisar las entregas

Haz clic en un webhook para abrir sus detalles.

La página muestra:

• Estado y URL, con un control para pausar las entregas
• Secreto de firma, con Mostrar y Copiar
• Estadísticas de 24 horas: entregas, tasa de errores, tiempo medio de respuesta y actividad
• Últimas entregas: cuerpo de la solicitud y respuesta del servidor para cada intento

Klang reintenta las entregas fallidas hasta seis veces con esperas crecientes. El webhook se pausa automáticamente tras 25 fallos consecutivos. Corrige el endpoint y vuelve a activar Recibir eventos.

Enviar un evento de prueba

1. Abre la página de detalles
2. Haz clic en Enviar evento de prueba
3. Si está suscrito a varios eventos, elige uno
4. Observa la fila nueva en Últimas entregas

Las pruebas llevan la etiqueta TEST y un identificador que comienza por evt_test_. Su esquema coincide con el de un evento real.

Pausar o eliminar

• Desactiva Recibir eventos para pausar los envíos conservando el historial.
• Haz clic en Editar y después en Eliminar webhook para borrarlo.

También puedes hacerlo desde el menú … de la lista.

Siguientes pasos

• Consulta la documentación de webhooks
• Gestiona tus integraciones para usar servicios como Slack
• Crea un flujo para transformar contenido antes de enviarlo