Meetings

Notas de reuniones con IA

Agrega notas de reuniones con transcripciones, grabaciones y webhooks.

Usa Horato desde tu backend para agregar notas de reuniones a tu producto. Tu app inicia el notetaker, consulta el estado, recupera transcripciones y recibe webhooks.

Cómo funciona

Llama la API de grabaciones desde tu backend con el link de la reunión, nombre del bot, configuración de transcripción, idioma y metadata.

Horato sigue el ciclo de vida del notetaker y envía eventos firmados cuando la reunión pasa de entrada a grabación y transcripción lista.

Los inicios automáticos son una política de aplicación, no un default global. Usa `manual` para inicios explícitos por API o botón, `ask_before_join` para prompts en tu UI y `auto_owned_only` cuando eventos virtuales creados por Horato deban iniciar el notetaker.

  • Usa `POST /v1/recordings/bots` para iniciar o reutilizar un notetaker para una reunión existente.
  • Usa `GET/PATCH /v1/recordings/policy` para leer o cambiar la política de dispatch.
  • Usa endpoints de estado, transcripción y media para mostrar el resultado en tu producto.
  • Usa webhooks de grabación para actualizar workflows cuando cambie la transcripción o grabación.

Superficie API

Usa estas rutas de Horato desde tu backend. Mantienen los detalles internos fuera del producto que ven tus clientes.

Iniciar notetakerbash
curl -X POST https://api.hora.to/v1/recordings/bots \
  -H "Authorization: Bearer $HORATO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"meeting_url":"https://meet.google.com/abc-defg-hij","bot_name":"Acme Notetaker","recording_enabled":true,"transcribe_enabled":true}'
Configurar política de dispatchbash
curl -X PATCH https://api.hora.to/v1/recordings/policy \
  -H "Authorization: Bearer $HORATO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"auto_owned_only","meeting_types":["google_meet"],"bot_name":"Acme Notetaker"}'
Leer transcripciónbash
curl https://api.hora.to/v1/recordings/recbot_123/transcript \
  -H "Authorization: Bearer $HORATO_API_KEY"

Eventos de ciclo de vida

Los webhooks de grabación permiten reaccionar cuando inicia un notetaker, cambia el estado de la reunión, se actualiza una transcripción o termina el procesamiento post-call.

  • `recording.bot.started`
  • `recording.meeting.status_change`
  • `recording.transcript.updated`
  • `recording.recording.completed`

Experiencia del cliente

Las notas de reuniones deben sentirse parte de tu producto. Guarda los IDs devueltos junto a tu cliente, cuenta, reserva o evento de calendario para alimentar workflows de seguimiento.

Alcance actual

La ruta pública v1 es transcripción y grabación después de la llamada. Mantén la transcripción en vivo fuera del copy para clientes salvo que esté aprobada para el despliegue.

  • Empieza desde un link de reunión existente.
  • Auto-start solo para políticas habilitadas; `manual` sigue siendo el default.
  • El nombre visible del bot debe usar tu marca o la marca del tenant, con Horato como fallback.
  • Consulta estado, transcripción y media de grabación mediante Horato.
  • Usa webhooks firmados para actualizar tu app después de la llamada.