L'API Calendriers vous permet de synchroniser automatiquement les calendriers d'Outlook et Google Workspace pour déployer des bots dans les réunions programmées.

Cela facilite :

• L'automatisation de l'enregistrement et de la participation aux réunions sans intervention manuelle
• La connexion aux calendriers Google Workspace et Microsoft Outlook
• La réception de mises à jour en temps réel lorsque les événements de calendrier changent
• L'application de logique métier pour déterminer quelles réunions enregistrer

L'API suit un modèle simple vous permettant de connecter des fournisseurs de calendrier, lister et gérer les événements, et programmer automatiquement des bots d'enregistrement lorsque les réunions se produisent.

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 calendrier utilisant OAuth
• Webhooks en temps réel : Recevez des notifications immédiates lorsque les événements de calendrier changent
• Enregistrement sélectif : Implémentez vos propres règles métier pour décider quelles réunions enregistrer
• Configuration des bots : Personnalisez les paramètres d'enregistrement pour chaque réunion
• Support des réunions récurrentes : Gérez efficacement les séries de réunions récurrentes

Processus d'implémentation

• Configuration de l'authentification : Connectez les calendriers en utilisant les identifiants OAuth
• Sélection de calendrier : Choisissez quels calendriers synchroniser
• Gestion des événements : Listez, filtrez et traitez les événements de calendrier
• Configuration de l'enregistrement : Programmez des bots pour des réunions spécifiques
• Traitement des webhooks : Recevez et gérez les mises à jour de calendrier en temps réel
• Maintenance : Gérez le renouvellement des identifiants et la récupération d'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 les intégrations de calendrier
• Lister et filtrer les événements de calendrier
• Programmer des bots d'enregistrement pour des réunions 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 charges utiles JSON. L'authentification est effectuée en utilisant votre clé API Meeting BaaS avec des jetons OAuth pour l'accès aux fournisseurs de calendrier.

Exemple d'utilisation de l'API

Ci-dessous est un exemple de comment utiliser l'API Calendriers pour programmer des bots pour les réunions d'équipe :

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

import { createBaasClient } from "@meeting-baas/sdk";
 
const client = createBaasClient({
  api_key: "your-api-key",
  timeout: 30000 // optionnel, défaut: 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("Calendrier créé:", data.calendar.name);
  console.log("UUID du calendrier:", data.calendar.uuid);
} else {
  console.error("Erreur lors de la création du calendrier:", error);
}

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 de calendrier

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

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

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

// Lister les événements d'un calendrier spécifique
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("Événements trouvés:", data.events.length);
  data.events.forEach(event => {
    console.log(`- ${event.summary} (${event.start_time})`);
  });
} else {
  console.error("Erreur lors de la liste des événements:", error);
}

Programmer l'enregistrement pour les événements

Programmez automatiquement des bots pour les réunions à venir :

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

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

// Programmer l'enregistrement pour un événement de calendrier spécifique
const { success, data, error } = await client.scheduleRecording({
  calendar_uuid: "your-calendar-uuid",
  event_id: "event-id-from-calendar",
  bot_config: {
    bot_name: "Enregistreur de réunion",
    recording_mode: "speaker_view",
    speech_to_text: {
      provider: "Default"
    }
  }
});

if (success) {
  console.log("Enregistrement programmé:", data.scheduled_recording.id);
} else {
  console.error("Erreur lors de la programmation de l'enregistrement:", error);
}

Commencer

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

• Documentation API
• SDK TypeScript
• Guide Webhook
• Guide de démarrage rapide