Saltar al contenido
Hedy

Hedy API

Configuracion de acceso a la API mostrando URLs de endpoints y generacion de API key

¿Que es la Hedy API?

La Hedy API proporciona acceso programatico a sus datos de reuniones, transcripciones, resumenes e informacion generada por IA. Ya sea que este construyendo integraciones personalizadas, automatizando flujos de trabajo o conectandose con herramientas como Zapier, la API le da el poder de extender las capacidades de Hedy mas alla de la aplicacion. Todas las funciones de la API requieren una suscripcion Pro con Cloud Sync habilitado.

Comenzar con la API

  1. Abra la aplicacion Hedy y navegue a Account Settings

  2. Desplacese hasta la seccion API Access

  3. Haga clic en Generate New API Key (se requiere suscripcion Pro)

  4. Copie su API key y guardela de forma segura; no podra verla de nuevo

  5. Visite nuestra documentacion de la API en SwaggerHub para informacion detallada sobre los endpoints, o acceda a la especificacion OpenAPI sin procesar en https://api.hedy.bot/v1/docs

Nota de seguridad: Su API key proporciona acceso completo a sus datos de Hedy. Mantengala segura y nunca la comparta publicamente ni la incluya en el control de versiones.

Capacidades de la API

La Hedy API ofrece acceso integral a su inteligencia de reuniones:

  • Sesiones: Liste y recupere sus sesiones de reuniones, incluyendo transcripciones completas, resumenes de IA y puntos clave

  • Destacados: Recupere momentos importantes de sus reuniones con informacion generada por IA

  • Temas: Cree, actualice, elimine y organice sesiones por temas con instrucciones de contexto personalizadas

  • Tareas pendientes: Recupere y gestione elementos de accion en todas las sesiones

  • Contextos de sesion: Cree y gestione instrucciones reutilizables que guian como Hedy analiza sus reuniones

  • Webhooks: Configure y gestione endpoints de webhook a traves de la API para notificaciones de eventos en tiempo real

  • Informacion del usuario: Recupere los detalles de su cuenta a traves del endpoint /me

Autenticacion

Todas las solicitudes a la API requieren autenticacion usando su API key. Incluyala en el encabezado de autorizacion:

Authorization: Bearer YOUR_API_KEY

Webhooks

Configure webhooks para recibir notificaciones en tiempo real cuando ocurran eventos en su cuenta de Hedy:

  1. En la seccion de API Access, haga clic en Manage Webhooks

  2. Haga clic en el boton + para agregar un nuevo webhook

  3. Ingrese la URL de su endpoint HTTPS

  4. Seleccione los eventos que desea recibir:

    • session.created - Cuando comienza una nueva sesion de grabacion

    • session.ended - Cuando una sesion de grabacion completa el procesamiento

    • session.exported - Cuando el usuario exporta manualmente una sesion

    • highlight.created - Cuando se agrega un nuevo destacado

    • todo.exported - Cuando se exportan tareas pendientes de una sesion

  5. Guarde su webhook y anote el secreto de firma para la verificacion de la carga util

Tambien puede gestionar webhooks programaticamente a traves de la API usando GET, POST y DELETE en el endpoint /webhooks. Cada cuenta puede tener hasta 50 webhooks.

Verificacion de firma de webhook

Cada entrega de webhook incluye una firma en el encabezado X-Hedy-Signature para que pueda verificar que proviene de Hedy. La firma es un hash HMAC-SHA256 del cuerpo sin procesar de la solicitud, firmado con el secreto de firma de su webhook. Verifique la firma en su servidor antes de procesar la carga util para garantizar la autenticidad. Cada entrega tambien incluye un encabezado X-Hedy-Event que indica el tipo de evento (ej. session.ended).

Contextos de sesion

Los contextos de sesion le permiten crear conjuntos reutilizables de instrucciones personalizadas que le dicen a Hedy como analizar sus reuniones. Por ejemplo, puede crear un contexto para “Llamadas de ventas” que se enfoque en elementos de accion y objeciones de clientes, o uno para “Reuniones de standup” que rastree bloqueos y actualizaciones.

Use la API para gestionar sus contextos de sesion:

  • GET /contexts - Lista todos sus contextos de sesion

  • GET /contexts/{id} - Obtener un contexto especifico por ID

  • POST /contexts - Crear un nuevo contexto (titulo y contenido)

  • PATCH /contexts/{id} - Actualizar un contexto existente

  • DELETE /contexts/{id} - Eliminar un contexto

Establezca un contexto como predeterminado y se aplicara automaticamente a todas las nuevas sesiones. Las cuentas del nivel gratuito estan limitadas a 1 contexto de sesion.

Gestion de temas a traves de la API

Los temas le ayudan a organizar sus sesiones en categorias. La API soporta la gestion completa de temas:

  • GET /topics - Lista todos los temas con informacion generada por IA y conteos de sesiones

  • GET /topics/{id} - Obtener los detalles de un tema especifico

  • POST /topics - Crear un nuevo tema con nombre, descripcion, color e icono

  • PATCH /topics/{id} - Actualizar las propiedades de un tema o su contexto personalizado

  • DELETE /topics/{id} - Eliminar un tema (las sesiones se desvinculan, no se eliminan)

  • GET /topics/{id}/sessions - Listar todas las sesiones dentro de un tema

Los temas pueden incluir un campo topicContext con instrucciones personalizadas (hasta 20,000 caracteres) que guian como Hedy analiza las sesiones asignadas a ese tema.

Casos de uso comunes

  • Integracion con gestion de proyectos: Cree automaticamente tareas en su herramienta de PM a partir de elementos de accion de reuniones

  • Gestion del conocimiento: Indexe el contenido de reuniones en la base de conocimiento de su empresa

  • Integracion con CRM: Actualice registros de clientes con informacion de reuniones

  • Paneles de analitica: Construya informes personalizados sobre patrones de reuniones y productividad

  • Automatizacion de flujos de trabajo: Active acciones basadas en el contenido o finalizacion de reuniones

  • Integracion con Zapier: Conecte Hedy a miles de aplicaciones usando Zapier (agregue ?format=zapier a los endpoints para respuestas de arreglo plano compatibles con Zapier)

Limites y mejores practicas de la API

  • Limites de velocidad: 200 solicitudes por minuto por API key

  • Paginacion: Use el parametro limit (predeterminado 50, maximo 100) y el parametro de cursor after para paginar los resultados

  • Almacene en cache las respuestas cuando sea posible para reducir las llamadas a la API

  • Maneje los errores con gracia usando retroceso exponencial

  • Use webhooks para actualizaciones en tiempo real en lugar de sondeo

Exportacion automatica de tareas pendientes

Habilite la exportacion automatica de tareas pendientes para enviar elementos de accion a sus sistemas integrados:

  1. En la seccion de API Access, active Auto Export Todos

  2. Las tareas pendientes se enviaran automaticamente a sus endpoints de webhook configurados

  3. Cada tarea pendiente incluye contexto, sugerencias de asignacion y referencia de la reunion

Ejemplos de codigo

Aqui tiene un ejemplo simple para obtener sus sesiones recientes:

curl -X GET "https://api.hedy.bot/v1/sessions?limit=10" \  -H "Authorization: Bearer YOUR_API_KEY"

Para mas ejemplos y la referencia completa de endpoints, visite nuestra documentacion de la API.

Solucion de problemas

Error 401 Unauthorized

  • Verifique que su API key sea correcta y tenga el formato adecuado

  • Asegurese de tener una suscripcion Pro activa

  • Compruebe que Cloud Sync este habilitado en su cuenta

  • Confirme que la API key no haya sido regenerada (las claves antiguas se invalidan)

Respuesta vacia o datos faltantes

  • Asegurese de que Cloud Sync este habilitado; la API solo accede a datos sincronizados en la nube

  • Espere unos minutos despues de grabar para que los datos se sincronicen

  • Verifique sus filtros de fecha y parametros de paginacion

  • Compruebe que esta usando el endpoint correcto para su tipo de datos

El webhook no recibe eventos

  • Confirme que la URL de su endpoint use HTTPS (requerido)

  • Verifique que su servidor responda con estado 200 OK

  • Compruebe el encabezado X-Hedy-Signature si esta implementando verificacion de firma

  • Pruebe su webhook usando el boton “Test Webhook”

  • Verifique que las reglas del firewall no esten bloqueando los servidores de Hedy

Limite de velocidad excedido

  • Implemente almacenamiento en cache para reducir llamadas redundantes a la API

  • Use webhooks para actualizaciones en tiempo real en lugar de sondeo

  • Agrupe operaciones cuando sea posible

  • Contacte al soporte si necesita limites mas altos

Consejo profesional: Use webhooks en lugar de sondeo para actualizaciones en tiempo real. Esto es mas eficiente y proporciona notificaciones instantaneas cuando sus datos cambian.

Privacidad y seguridad

La seguridad de sus datos es nuestra prioridad:

  • Toda la comunicacion de la API usa encriptacion HTTPS

  • Las API keys se pueden regenerar en cualquier momento (invalida la clave anterior)

  • Las cargas utiles de webhook se firman con HMAC-SHA256 para verificacion

  • Los datos solo son accesibles con autenticacion valida

  • Todos los endpoints aplican encabezados de seguridad estrictos

Obtener ayuda

Para preguntas especificas sobre la API:

Artículos Relacionados

Importación de archivos de audio y video a Hedy Importación de videos en línea Importación de transcripciones existentes a Hedy

¿Esto respondió a su pregunta?