API de Calendários

Sincronize Calendários e Automatize Gravações de Reuniões

A API de Calendários permite sincronizar automaticamente calendários do Outlook e do Google Workspace para fazer deploy de bots em reuniões agendadas.

Isso facilita:

  • Automatizar gravação e participação em reuniões sem intervenção manual
  • Conectar tanto calendários do Google Workspace quanto do Microsoft Outlook
  • Receber atualizações em tempo real quando eventos do calendário forem alterados
  • Aplicar lógica de negócio para determinar quais reuniões gravar

A API segue um padrão simples que permite conectar provedores de calendário, listar e gerenciar eventos e agendar automaticamente bots de gravação quando as reuniões ocorrem.

Principais Funcionalidades

  • Suporte a Múltiplos Calendários: Conecte tanto calendários do Google Workspace quanto do Microsoft Outlook
  • Autenticação OAuth: Integração segura com provedores de calendário usando OAuth
  • Webhooks em Tempo Real: Receba notificações imediatas quando eventos do calendário forem alterados
  • Gravação Seletiva: Implemente suas próprias regras de negócio para decidir quais reuniões gravar
  • Configuração de Bot: Personalize as configurações de gravação para cada reunião
  • Suporte a Reuniões Recorrentes: Gerencie séries de reuniões recorrentes com eficiência

Processo de Implementação

  • Configuração de Autenticação: Conecte calendários usando credenciais OAuth
  • Seleção de Calendário: Escolha quais calendários sincronizar
  • Gerenciamento de Eventos: Liste, filtre e processe eventos do calendário
  • Configuração de Gravação: Agende bots para reuniões específicas
  • Processamento de Webhook: Receba e trate atualizações de calendário em tempo real
  • Manutenção: Gerencie a renovação de credenciais e a recuperação de erros

Uso da API

A API de Calendários faz parte da plataforma Meeting BaaS e fornece endpoints para:

  • Criar e gerenciar integrações de calendário
  • Listar e filtrar eventos do calendário
  • Agendar bots de gravação para reuniões específicas
  • Gerenciar webhooks para atualizações em tempo real

A API é totalmente documentada e suporta operações REST padrão com payloads JSON. A autenticação é realizada usando sua chave de API do Meeting BaaS junto com tokens OAuth para acesso ao provedor de calendário.

Exemplo de Uso da API

Abaixo está um exemplo de como usar a API de Calendários para agendar bots em reuniões de equipe:

Este código demonstra como interagir com a API de Calendários para recuperar eventos e agendar bots de gravação.

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 do Calendário

Veja como recuperar eventos de um calendário 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);
}

Agendar Gravação para Eventos

Agende automaticamente bots para reuniões futuras:

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

Começar

Pronto para automatizar suas gravações de reuniões com integração de calendário? Confira nossa documentação completa: