Webhooks

¿Que son los webhooks?

Los webhooks permiten que Hedy envie datos a otras aplicaciones y servicios en tiempo real. Cuando ocurre un evento, como el final de una sesion o la creacion de un punto destacado, Hedy envia los datos a una URL que usted especifique. Esto le permite construir automatizaciones poderosas sin necesidad de programar.

Por ejemplo, podria automaticamente:

• Guardar transcripciones de reuniones en Google Docs o Notion

• Publicar resumenes de sesiones en un canal de Slack

• Crear tareas en Asana o Todoist a partir de elementos de accion

• Registrar datos de sesiones en una hoja de calculo

Requisitos

• Suscripcion Hedy Pro — Los webhooks son una funcionalidad Pro

• Cloud Sync habilitado — Requerido para que Hedy pueda procesar eventos de webhook a traves de la nube

Puede ver sus webhooks sin Cloud Sync, pero necesita tenerlo habilitado para crear, editar o activarlos.

Configurar un webhook

1. Abra Hedy y vaya a Settings

2. Desplacese hasta la seccion API Access

3. Toque Manage Webhooks

4. Toque el boton + para agregar un nuevo webhook

5. Ingrese un nombre (opcional) — una etiqueta para ayudarle a recordar para que sirve este webhook (por ejemplo, “Zapier — Meeting Notes”)

6. Pegue la URL del webhook de su servicio externo — debe ser una URL HTTPS

7. Seleccione los eventos a los que desea suscribirse (vea a continuacion)

8. Toque Create

Puede crear hasta 10 webhooks.

Eventos disponibles

Elija que eventos activan su webhook:

Session Created — Se activa cuando inicia una nueva grabacion. Envia el titulo de la sesion y la hora de inicio.

Session Ended — Se activa cuando finaliza una grabacion. Envia los datos completos de la sesion incluyendo transcripcion, resumen, actas de reunion, puntos destacados e informacion del tema. Este es el evento mas completo.

Session Exported — Se activa cuando exporta manualmente una sesion a sus webhooks. Envia datos similares a Session Ended (transcripcion, resumen, puntos destacados, etc.).

Highlight Created — Se activa cada vez que se captura un punto destacado durante una sesion. Envia el texto del punto destacado, la perspectiva de IA y la marca de tiempo.

Todo Exported — Se activa cuando exporta un elemento de accion. Envia el texto del elemento pendiente, la fecha de vencimiento y la sesion asociada.

Exportar una sesion manualmente

Ademas de los eventos automaticos, puede enviar manualmente cualquier sesion a sus webhooks:

1. Abra una sesion completada

2. Toque Export to Webhook

3. Si tiene multiples webhooks suscritos al evento Session Exported, seleccione a cuales enviar

4. Confirme la exportacion

Probar su webhook

Antes de depender de un webhook, puede verificar que funciona:

1. Vaya a Settings > API Access > Manage Webhooks

2. Toque el boton test en cualquier webhook

3. Hedy envia un payload de prueba a su URL y muestra si tuvo exito, junto con el codigo de estado de la respuesta

Si la prueba falla, verifique que la URL sea correcta y que su servicio externo este listo para recibir solicitudes.

¿Que datos se envian?

Cada solicitud de webhook es un HTTP POST con un cuerpo JSON. Los datos dependen del tipo de evento, pero un evento Session Ended incluye:

• Detalles de la sesion — Titulo, hora de inicio, hora de finalizacion, duracion

• Transcripcion — El texto completo de su sesion

• Conversaciones — Dialogo estructurado participante por participante

• Actas de reunion — Puntos clave de discusion

• Resumen — Resumen generado por IA

• Puntos destacados — Cada punto destacado con su perspectiva de IA, cita y marca de tiempo

• Tema — El nombre del tema y las perspectivas, si la sesion esta asignada a un tema

Seguridad y verificacion

Cada solicitud de webhook incluye una firma para que pueda verificar que genuinamente proviene de Hedy:

• X-Hedy-Signature header — Un hash HMAC-SHA256 del cuerpo de la solicitud, firmado con el secreto unico de su webhook

• X-Hedy-Event header — El tipo de evento (por ejemplo, session.ended)

Todas las URLs de webhook deben usar HTTPS para garantizar que sus datos esten cifrados en transito. Hedy no enviara datos a endpoints HTTP.

Usar webhooks con plataformas populares

Zapier — Cree un Zap con “Webhooks by Zapier” como trigger. Elija “Catch Hook”, copie la URL del webhook y peguela en Hedy.

Make (anteriormente Integromat) — Agregue un modulo “Custom Webhook” como trigger de su escenario. Copie la URL generada y peguela en Hedy.

n8n — Agregue un nodo trigger “Webhook” a su flujo de trabajo. Copie la URL de produccion y peguela en Hedy.

Entrega y reintentos

Hedy reintenta automaticamente las entregas fallidas:

• Errores del servidor (5xx) — Reintentado hasta 2 veces con demoras crecientes

• Limite de tasa (429) — Reintentado una vez, respetando el tiempo de reintento del servicio

• Errores del cliente (4xx) — No reintentado, ya que estos tipicamente indican un problema de configuracion

Solucion de problemas

La prueba del webhook falla — Verifique que la URL sea correcta, use HTTPS y que su servicio externo este escuchando activamente las solicitudes.

No recibe eventos — Verifique que Cloud Sync este habilitado, que el webhook este suscrito al evento correcto y que su suscripcion Pro este activa.

Mensaje “Webhooks require Pro” — Actualice a Hedy Pro en Settings > Subscription para acceder a los webhooks.

Mensaje “Cloud Sync required” — Habilite Cloud Sync en Settings > Cloud Sync, o toque el boton Enable en el banner de advertencia que se muestra en la parte superior de la pantalla de Webhooks.

Consejo profesional: Comience suscribiendose al evento Session Ended — incluye los datos mas completos y es el mas util para construir automatizaciones en torno a sus notas de reuniones.