API Calendriers

Synchronisez vos calendriers et automatisez les enregistrements de meeting

L'API Calendriers vous permet de synchroniser automatiquement les calendriers Outlook et Google Workspace pour déployer des bots lors des meetings planifiés.

Cela permet de :

  • Automatiser l'enregistrement et la participation aux meetings sans intervention manuelle
  • Se connecter aux calendriers Google Workspace et Microsoft Outlook
  • Recevoir des mises à jour en temps réel lorsque les événements du calendrier changent
  • Appliquer une logique métier pour déterminer quels meetings enregistrer

L'API suit un schéma simple vous permettant de connecter des fournisseurs de calendriers, de lister et gérer des événements, et de planifier automatiquement des bots d'enregistrement lors des meetings.

Fonctionnalités principales

  • Support multi-calendriers : Connectez-vous aux calendriers Google Workspace et Microsoft Outlook
  • Authentification OAuth : Intégration sécurisée avec les fournisseurs de calendriers via OAuth
  • Webhooks en temps réel : Recevez des notifications immédiates lorsque les événements du calendrier changent
  • Enregistrement sélectif : Implémentez vos propres règles métier pour décider quels meetings enregistrer
  • Configuration des bots : Personnalisez les paramètres d'enregistrement pour chaque meeting
  • Support des meetings récurrents : Gérez efficacement les séries de meetings récurrents

Processus d'implémentation

  • Configuration de l'authentification : Connectez les calendriers à l'aide des identifiants OAuth
  • Sélection du calendrier : Choisissez les calendriers à synchroniser
  • Gestion des événements : Listez, filtrez et traitez les événements du calendrier
  • Configuration de l'enregistrement : Planifiez des bots pour des meetings spécifiques
  • Traitement des webhooks : Recevez et gérez les mises à jour du calendrier en temps réel
  • Maintenance : Gérez le renouvellement des identifiants et la récupération des erreurs

Utilisation de l'API

L'API Calendriers fait partie de la plateforme Meeting BaaS et fournit des endpoints pour :

  • Créer et gérer des intégrations de calendriers
  • Lister et filtrer les événements du calendrier
  • Planifier des bots d'enregistrement pour des meetings spécifiques
  • Gérer les webhooks pour les mises à jour en temps réel

L'API est entièrement documentée et prend en charge les opérations REST standard avec des payload JSON. L'authentification s'effectue à l'aide de votre clé API Meeting BaaS ainsi que des token OAuth pour l'accès au fournisseur de calendriers.

Exemple d'utilisation de l'API

Voici un exemple d'utilisation de l'API Calendriers pour planifier des bots lors de meetings d'équipe :

Ce code illustre comment interagir avec l'API Calendriers pour récupérer des événements et planifier des bots d'enregistrement.

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

Lister les événements du calendrier

Voici comment récupérer les événements d'un calendrier connecté :

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);
}

Planifier l'enregistrement des événements

Planifiez automatiquement des bots pour les prochains meetings :

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

Commencer

Prêt à automatiser vos enregistrements de meeting avec l'intégration du calendrier ? Consultez notre documentation complète :