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.
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}'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"}'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.