Saltar al contenido principal
Si su organización tiene webhooks configurados, la plataforma enviará una petición HTTP POST a la URL que nos haya indicado cada vez que ocurran ciertos eventos (consulta creada, expirada, finalizada, o participante entró/salió de la videollamada). Así su sistema puede actualizarse en tiempo real sin consultar la API de forma continua.

​
Requisitos de su lado

  • URL pública HTTPS que acepte POST y responda en menos de 30 segundos.
  • Conocer el secret de webhook que configuró con Kairo Connect; se usa solo para verificar la firma de cada petición y asegurarse de que el contenido es auténtico.

​
Encabezados que enviamos

EncabezadoDescripción
Content-Typeapplication/json
X-Telehealth-SignatureFirma HMAC-SHA256 del cuerpo raw de la petición, en hexadecimal minúsculas. Debe verificar esta firma con su secret antes de confiar en el contenido.
X-Telehealth-EventNombre del evento (ej. consultation.created, session_started).
X-Telehealth-DeliveryIdentificador único del envío (útil para idempotencia y logs).
User-AgentTelehealth-Webhooks/1.0

​
Respuesta que debe devolver su URL

  • 200 OK (u otro 2xx) cuando acepte o procese correctamente el evento.
  • 401 Unauthorized si la firma no es válida.
  • Si responde con error o no responde a tiempo, la plataforma puede reintentar el envío. Se recomienda procesamiento idempotente (por ejemplo usando X-Telehealth-Delivery para detectar duplicados).
Consulte Eventos, Validación de la firma y Verificación por lenguaje.