París, 5 de diciembre de 2025

Después de 5 meses de desarrollo, nos complace presentar Meeting BaaS API v2. Es una reimaginación completa de nuestro backend, que incluye tanto la API pública como los servicios internos. La v2 aborda el 90% de los desafíos que hemos enfrentado con nuestros usuarios y desarrolladores durante 2 años de construcción de Meeting BaaS. Está diseñada para soportar millones de grabaciones por mes.

Construido con Sus Comentarios

Los principales desafíos que enfrentamos a escala para nosotros y nuestros usuarios incluían:

• gestión de webhooks a escala,
• manejo elegante de errores,
• necesidad de mayor visibilidad en las operaciones
• mayor control sobre la seguridad.

API v2 ofrece una respuesta a cada uno de estos obstáculos con funcionalidades para hacer la API más potente.

Inicio Rápido con v2

Comenzar con API v2 es sencillo. Así es como enviar su primer bot, usando el SDK oficial de TypeScript o HTTP directo:

pnpm add @meeting-baas/sdk

import { createBaasClient } from "@meeting-baas/sdk";

const client = createBaasClient({
  api_key: "YOUR_API_KEY",
});

async function sendBot() {
  const { success, data, error } = await client.joinMeeting({
    meeting_url: "https://meet.google.com/abc-defg-hij",
    bot_name: "Meeting Assistant",
    recording_mode: "speaker_view",
    transcription_enabled: true,
    transcription_config: {
      provider: "gladia",
    },
  });

  if (success) {
    console.log("Bot created:", data.bot_id);
  } else {
    console.error("Error creating bot:", error);
  }
}

curl -X POST "https://api.meetingbaas.com/v2/bots" \
     -H "Content-Type: application/json" \
     -H "x-meeting-baas-api-key: YOUR_API_KEY" \
     -d '{
           "meeting_url": "https://meet.google.com/abc-defg-hij",
           "bot_name": "Meeting Assistant",
           "recording_mode": "speaker_view",
           "transcription_enabled": true,
           "transcription_config": {
             "provider": "gladia"
           }
         }'

import requests

response = requests.post(
    "https://api.meetingbaas.com/v2/bots",
    headers={
        "Content-Type": "application/json",
        "x-meeting-baas-api-key": "YOUR_API_KEY"
    },
    json={
        "meeting_url": "https://meet.google.com/abc-defg-hij",
        "bot_name": "Meeting Assistant",
        "recording_mode": "speaker_view",
        "transcription_enabled": True,
        "transcription_config": {"provider": "gladia"}
    }
)
# Response: {"success": true, "data": {"bot_id": "..."}}
print(response.json())

Novedades en v2

Mayor poder para los Desarrolladores:

• Operaciones en Lote: Cree hasta 100 bots en una sola solicitud con soporte de éxito parcial — ideal para operaciones masivas
• Filtrado Avanzado: Potentes parámetros query para listar bots y eventos, reduciendo la necesidad de filtrado del lado del cliente
• Webhooks Completos: Eventos webhook detallados para cada operación, con múltiples endpoints para enrutar diferentes eventos a diferentes sistemas
• Códigos de Error Estandarizados: Códigos como FST_ERR_BOT_NOT_FOUND_BY_ID, FST_ERR_INSUFFICIENT_TOKENS, FST_ERR_BOT_ALREADY_EXISTS permiten un manejo programático de errores directo
• Documentación OpenAPI Mejorada: Schemas OpenAPI completos para todos los endpoints, habilitando mejores herramientas y seguridad de tipos. Puede abrirla o descargarla usando curl para su LLM.

Seguridad de Nivel Empresarial

• Firma de Webhooks: Todos los webhooks están firmados criptográficamente usando Svix, que alojamos nosotros mismos dentro de nuestra infraestructura, garantizando la integridad y autenticidad de los mensajes
• Múltiples Claves API: Cree claves separadas para diferentes entornos, servicios o permisos — sin necesidad de compartir una sola clave en toda su infraestructura
• Permisos Granulares: Control de acceso detallado con claves de "Acceso de Envío" para operaciones de solo escritura, ideal para aislar los servicios de creación de bots
• Rotación de Secretos: Si aloja Meeting BaaS por su cuenta, rote los secretos de webhook sin tiempo de inactividad, cumpliendo con los requisitos de conformidad sin interrupción del servicio

Integración de Calendario Mejorada

La integración de calendario en v2 ha sido reconstruida de extremo a extremo para facilitar la programación y automatización a gran escala, de forma más confiable y mucho más transparente.

• Calendarios en Todos los Planes: La integración de calendario ahora está disponible en todos los planes, desde Pago por uso hasta Enterprise, por lo que ya no necesita un contrato empresarial solo para sincronizar eventos y activar bots desde calendarios.

• Credenciales Propias: Use sus propias aplicaciones OAuth para Google y Microsoft en lugar de depender de integraciones compartidas y opacas. Al crear una conexión a través de POST /v2/calendars, usted proporciona oauth_client_id, oauth_client_secret, oauth_refresh_token y raw_calendar_id, lo que le otorga control total sobre la rotación de credenciales, pantallas de consentimiento y postura de seguridad.

• Endpoints de Calendario más Completos: La v2 expone un conjunto completo de endpoints para gestionar todo el ciclo de vida del calendario desde su backend:

  • POST /v2/calendars – Cree conexiones de calendario para usuarios específicos o cuentas de servicio
  • GET /v2/calendars / GET /v2/calendars/:calendar_id – Liste todas las conexiones e inspeccione una conexión individual en detalle
  • POST /v2/calendars/list-raw – Previsualice los calendarios del proveedor antes de crear una conexión, ideal para flujos de vinculación de cuentas
  • POST /v2/calendars/:calendar_id/sync – Fuerce una resincronización de eventos cuando necesite consistencia inmediata
  • POST /v2/calendars/:calendar_id/bots – Programe bots para eventos de calendario sin calcular manualmente los tiempos
  • PATCH /v2/calendars/:calendar_id / DELETE /v2/calendars/:calendar_id – Actualice credenciales o elimine conexiones de forma limpia

• Soporte de Eventos y Series: Puede trabajar con eventos individuales y series recurrentes de manera uniforme usando:

  • GET /v2/calendars/:calendar_id/events – Liste los próximos eventos de un calendario
  • GET /v2/calendars/:calendar_id/events/:event_id – Obtenga los detalles completos de un evento específico
  • GET /v2/calendars/:calendar_id/series – Inspeccione series recurrentes y sus instancias

• Sincronización en Tiempo Real de Calendario de Microsoft: La v2 añade capacidades de sincronización en tiempo real para calendarios de Microsoft, de modo que los cambios en los calendarios de Outlook y Microsoft 365 se reflejen en Meeting BaaS en segundos en lugar de minutos, haciendo que los flujos de scheduleCalendarRecordEvent sean más predecibles.

• Webhooks de Calendario Dedicados y Confiabilidad: Nuevos eventos webhook como calendar.connection_created, calendar.connection_error, calendar.events_synced, calendar.event_created, calendar.event_updated, and calendar.event_cancelled le brindan una imagen clara del estado de sincronización y los cambios a lo largo del tiempo. Los endpoints dedicados para resuscribirse y resincronizar le permiten recuperarse rápidamente de problemas del proveedor sin intervención manual.

• Interfaz de Calendario Dedicada: El dashboard v2 incluye una interfaz de calendario dedicada donde puede inspeccionar conexiones, ver el estado de sincronización y los webhooks recientes, hacer debug de fallos y confirmar qué eventos tienen bots asignados — sin revisar los logs en bruto.

• Bots Vinculados a Eventos: En v2, los bots programados son ciudadanos de primera clase en el flujo del calendario. Puede crear, actualizar y cancelar bots directamente en eventos de calendario, lo que elimina gran parte del código de integración personalizado, reduce las condiciones de carrera en torno a cambios de último minuto y convierte «grabar cada standup en este calendario» en una configuración de una sola línea en lugar de un workflow personalizado.

Una Base para el Futuro

Mejor visibilidad en las operaciones de sus bots:

• Respuestas de Error Estandarizadas: Cada error sigue un formato consistente {success, data, error} con códigos de error programáticos
• Claridad en el Rate Limit: Rate limits claros por equipo con mensajes de error transparentes cuando se acercan a los límites
• Gestión de Tokens: Visibilidad en tiempo real del consumo, reserva y disponibilidad de tokens con dashboards de uso detallados
• Seguimiento de Entrega de Webhooks: Monitoree el estado de entrega de webhooks, vea el historial de mensajes y reenvíe entregas fallidas

Ejemplo de estructura de response v2:

{
  "success": true,
  "data": {
    "bot_id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "joining"
  }
}

Ejemplo de response de error:

{
  "success": false,
  "error": "Not Found",
  "message": "Bot with ID 'bot_abc123' not found",
  "code": "FST_ERR_BOT_NOT_FOUND_BY_ID",
  "statusCode": 404,
  "details": null
}

Eventos Webhook en v2

v2 proporciona eventos webhook completos con una estructura de payload consistente:

• Resumen de Webhooks — Guía completa del comportamiento de webhooks de bot y calendario en v2
• Referencia de Callbacks — Payloads de callback normalizados para bot.completed y bot.failed

{
  "event": "bot.completed",
  "data": {
    "bot_id": "123e4567-e89b-12d3-a456-426614174000",
    "meeting_url": "https://meet.google.com/abc-defg-hij",
    "raw_transcription": "https://s3.amazonaws.com/.../raw_transcription.json",
    "transcription": "https://s3.amazonaws.com/.../output_transcription.json",
    "transcription_ids": ["gladia-job-12345"],
    "transcription_provider": "gladia",
    "recording": "https://s3.amazonaws.com/.../recording.mp4"
  },
  "sent_at": "2025-12-05T11:01:45Z"
}

Nuevos tipos de eventos webhook en v2:

• bot.status_change — Transiciones de estado del bot
• bot.completed — Bot finalizó la grabación
• bot.failed — Bot falló con detalles del error
• calendar.connection_created — Conexión de calendario establecida
• calendar.events_synced — Eventos de calendario sincronizados
• calendar.event_created / calendar.event_updated / calendar.event_cancelled

Si necesita recuperarse de problemas de entrega, puede reenviar el webhook final o reintentar un callback de bot para un bot específico. Para una descripción completa de los payloads de callback y su comportamiento, consulte la documentación de Callbacks.

Operaciones en Lote

Cree múltiples bots en una sola solicitud con soporte de éxito parcial:

curl -X POST "https://api.meetingbaas.com/v2/bots/batch" \
     -H "Content-Type: application/json" \
     -H "x-meeting-baas-api-key: YOUR_API_KEY" \
     -d '[
           {
             "meeting_url": "https://meet.google.com/abc-defg-hij",
             "bot_name": "Bot 1",
             "recording_mode": "speaker_view"
           },
           {
             "meeting_url": "https://zoom.us/j/123456789",
             "bot_name": "Bot 2",
             "recording_mode": "gallery_view"
           }
         ]'

Capacidades Adicionales

v2 hace escalable cualquier lógica de negocio que involucre bots de reunión:

Lo que Viene a Continuación

• Proveedores de Transcripción Adicionales: Una API unificada para todos los principales servicios de transcripción. Los proveedores planificados incluyen:
  • Deepgram
  • Gladia
  • Assembly AI
  • OpenAI Whisper
  • Speechmatics
  • Google Speech
  • Azure Speech
  • ... Dado que la transcripción en v2 está concebida con BYOK como prioridad, cada solicitud se ejecuta en su propia cuenta del proveedor — todos los trabajos, el uso y la facturación permanecen visibles en el dashboard del proveedor, y devolvemos el ID de trabajo único del proveedor para que pueda cruzar referencias en los logs, hacer debug de problemas y auditar la actividad de extremo a extremo.
• Almacenamiento de Datos por Región: Almacene los datos de sus reuniones en regiones geográficas específicas para cumplir con los requisitos de conformidad y residencia de datos
• Captura de Video en Vista de Galería: Grabación de video mejorada con modo de vista de galería para una mejor cobertura de reuniones con múltiples participantes

Migración Simplificada

Entendemos que migrar APIs puede ser una tarea significativa. Por eso hemos hecho la transición lo más fluida posible:

• Operación en Paralelo: Tanto v1 como v2 funcionan simultáneamente — migre a su propio ritmo
• Guía de Migración Completa: Instrucciones paso a paso para pasar de v1 a v2
• Importación de Tokens: Importe sus tokens v1 restantes a v2 a través del dashboard — puede importar varias veces según sea necesario
• Misma Autenticación: Use el header x-meeting-baas-api-key — sin nuevos flujos de autenticación que aprender

Comenzar

API v2 ya está disponible. Tanto v1 como v2 funcionarán en paralelo, dándole tiempo para evaluar y migrar cuando esté listo. Para nuevas integraciones, recomendamos comenzar con v2 para aprovechar todas las mejoras desde el primer día.

Recursos:

• Acceder al Dashboard v2
• Explorar la Documentación de API v2
• Ver Nuevas Funcionalidades
• Guía de Migración
• Guía de Inicio Rápido
• Webhooks y Callbacks — Referencia completa de eventos y callbacks para bots y calendarios
• TypeScript SDK — SDK oficial v6.0.0 para Meeting BaaS API v2 (npm)

¿Preguntas o comentarios? Nos encantaría escucharlos. API v2 representa meses de trabajo, pero es solo el comienzo. Sus comentarios dan forma a lo que construimos a continuación.

© 2025 SAS SPOKE — Meeting BaaS (Meeting Bot as a Service) 🐟