API de Calendarios

Sincronice Calendarios y Automatice las Grabaciones de Reuniones

La API de Calendarios le permite sincronizar automáticamente calendarios de Outlook y Google Workspace para deploy de bots en reuniones programadas.

Esto facilita:

  • Automatizar la grabación y participación en reuniones sin intervención manual
  • Conectarse a calendarios de Google Workspace y Microsoft Outlook
  • Recibir actualizaciones en tiempo real cuando cambian los eventos del calendario
  • Aplicar lógica de negocio para determinar qué reuniones grabar

La API sigue un patrón simple que le permite conectar proveedores de calendarios, listar y gestionar eventos, y programar automáticamente bots de grabación cuando ocurren reuniones.

Características Principales

  • Soporte Multi-Calendario: Conéctese a calendarios de Google Workspace y Microsoft Outlook
  • Autenticación OAuth: Integración segura con proveedores de calendarios mediante OAuth
  • Webhooks en Tiempo Real: Reciba notificaciones inmediatas cuando cambien los eventos del calendario
  • Grabación Selectiva: Implemente sus propias reglas de negocio para decidir qué reuniones grabar
  • Configuración de Bot: Personalice los ajustes de grabación para cada reunión
  • Soporte para Reuniones Recurrentes: Gestione series de reuniones recurrentes de manera eficiente

Proceso de Implementación

  • Configuración de Autenticación: Conecte calendarios utilizando credenciales OAuth
  • Selección de Calendario: Elija qué calendarios sincronizar
  • Gestión de Eventos: Liste, filtre y procese eventos del calendario
  • Configuración de Grabación: Programe bots para reuniones específicas
  • Procesamiento de Webhook: Reciba y gestione actualizaciones de calendario en tiempo real
  • Mantenimiento: Gestione la renovación de credenciales y la recuperación de errores

Uso de la API

La API de Calendarios es parte de la plataforma Meeting BaaS y proporciona endpoints para:

  • Crear y gestionar integraciones de calendarios
  • Listar y filtrar eventos del calendario
  • Programar bots de grabación para reuniones específicas
  • Gestionar webhooks para actualizaciones en tiempo real

La API está completamente documentada y admite operaciones REST estándar con payload JSON. La autenticación se realiza utilizando su API key de Meeting BaaS junto con tokens OAuth para el acceso al proveedor de calendarios.

Ejemplo de Uso de la API

A continuación se muestra un ejemplo de cómo usar la API de Calendarios para programar bots en reuniones de equipo:

Este código demuestra cómo interactuar con la API de Calendarios para recuperar eventos y programar bots de grabación.

calendars_api.ts
import { createBaasClient } from "@meeting-baas/sdk";
 
const client = createBaasClient({
  api_key: "your-api-key",
  timeout: 30000 // optional, default: 30000
});

const { success, data, error } = await client.createCalendar({
  oauth_client_id: "your-oauth-client-id",
  oauth_client_secret: "your-oauth-client-secret",
  oauth_refresh_token: "your-oauth-refresh-token",
  platform: "Google",
  raw_calendar_id: "optional-calendar-id"
});
 
if (success) {
  console.log("Calendar created:", data.calendar.name);
  console.log("Calendar UUID:", data.calendar.uuid);
} else {
  console.error("Error creating calendar:", error);
}
create_calendar.sh
curl -X POST "https://api.meetingbaas.com/calendars/" \
  -H "x-meeting-baas-api-key: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "oauth_client_id": "string",
    "oauth_client_secret": "string",
    "oauth_refresh_token": "string",
    "platform": "Google",
    "raw_calendar_id": "string"
  }'

Listar Eventos del Calendario

A continuación se muestra cómo recuperar eventos de un calendario conectado:

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

const client = createBaasClient({
  api_key: "your-api-key"
});

// List events from a specific calendar
const { success, data, error } = await client.listCalendarEvents({
  calendar_uuid: "your-calendar-uuid",
  start_time: "2024-01-01T00:00:00Z",
  end_time: "2024-01-31T23:59:59Z"
});

if (success) {
  console.log("Events found:", data.events.length);
  data.events.forEach(event => {
    console.log(`- ${event.summary} (${event.start_time})`);
  });
} else {
  console.error("Error listing events:", error);
}

Programar Grabación para Eventos

Programe automáticamente bots para próximas reuniones:

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

const client = createBaasClient({
  api_key: "your-api-key"
});

// Schedule recording for a specific calendar event
const { success, data, error } = await client.scheduleRecording({
  calendar_uuid: "your-calendar-uuid",
  event_id: "event-id-from-calendar",
  bot_config: {
    bot_name: "Meeting Recorder",
    recording_mode: "speaker_view",
    speech_to_text: {
      provider: "Default"
    }
  }
});

if (success) {
  console.log("Recording scheduled:", data.scheduled_recording.id);
} else {
  console.error("Error scheduling recording:", error);
}
Meeting BaaS API Preview Features

Comenzar

¿Listo para automatizar sus grabaciones de reuniones con integración de calendario? Consulte nuestra documentación completa: