Bots API | Meeting BaaS

L'API Bots vous permet de déployer des bots alimentés par l'IA dans des meetings Google Meet, Microsoft Teams et Zoom pour l'enregistrement, la transcription et la surveillance d'événements en direct.

Envoyez des bots dans des meetings instantanément ou planifiez-les à l'avance
Enregistrez l'audio/vidéo ou rejoignez en mode audio uniquement
Activez la transcription en direct et l'identification des interlocuteurs
Personnalisez le nom du bot, son avatar et son message d'entrée
Recevez des webhook de statut en temps réel et de complétion

Les bots Meeting BaaS agissent comme de véritables participants aux meetings, offrant une intégration transparente pour les cas d'usage d'automatisation, de conformité et d'analytique.

Fonctionnalités clés

Support multi-plateformes : Google Meet, Microsoft Teams, Zoom
Rejoindre instantanément ou planifié : Déployez des bots immédiatement ou réservez-les pour des meetings futurs
Modes d'enregistrement : Vue intervenant, vue galerie ou audio uniquement
Transcription : En direct ou après le meeting, avec plusieurs options de fournisseurs
Bots personnalisables : Nom, avatar, message d'entrée et plus encore
Webhooks : Statut en temps réel, complétion et notifications d'erreurs
Options avancées : Streaming WebSocket, déduplication et plus encore

Types d'événements webhook des bots

Les bots Meeting BaaS envoient les événements webhook suivants à votre endpoint :

complete : Le bot a terminé l'enregistrement, la transcription et le MP4 sont disponibles
failed : Le bot n'a pas réussi à rejoindre ou à enregistrer le meeting (avec les détails de l'erreur)
transcription_complete : Transcription terminée (après une nouvelle transcription ou un job asynchrone)
bot.status_change : Mises à jour de statut en direct (connexion, en appel, enregistrement, en pause, terminé, etc.)

Voir ci-dessous pour des exemples de payload webhook.

{
  "event": "complete",
  "bot_id": "bot_123456",
  "meeting_url": "https://meet.google.com/abc-defg-hij",
  "recording_url": "https://api.meetingbaas.com/recordings/bot_123456.mp4",
  "transcript_url": "https://api.meetingbaas.com/transcripts/bot_123456.json",
  "duration": 3600,
  "participants": 5,
  "created_at": "2024-01-01T12:00:00Z"
}

Utilisation de l'API

L'API Bots fournit des endpoints pour :

Envoyer un bot dans un meeting (POST /bots)
Retirer un bot d'un meeting (DELETE /bots/{bot_id})
Lister les bots et les métadonnées des meetings
Retranscrire un meeting (POST /bots/retranscribe)
Obtenir les données du meeting, les captures d'écran et plus encore

L'authentification s'effectue via votre clé API Meeting BaaS. Consultez les exemples de code pour savoir comment envoyer, retirer et interagir avec les bots par programmation.

Exemples d'utilisation de l'API

Voici des exemples pour envoyer un bot dans un meeting dans différents langages de programmation :

join_meeting.sh

curl -X POST "https://api.meetingbaas.com/bots" \
     -H "Content-Type: application/json" \
     -H "x-meeting-baas-api-key: YOUR-API-KEY" \
     -d '{
           "meeting_url": "YOUR-MEETING-URL",
           "bot_name": "AI Notetaker",
           "recording_mode": "speaker_view",
           "bot_image": "https://example.com/bot.jpg",
           "entry_message": "I am a good meeting bot :)",
           "reserved": false,
           "speech_to_text": {
             "provider": "Default"
           },
           "automatic_leave": {
             "waiting_room_timeout": 600
           }
         }'

join_meeting.py

import requests
url = "https://api.meetingbaas.com/bots"
headers = {
    "Content-Type": "application/json",
    "x-meeting-baas-api-key": "YOUR-API-KEY",
}
config = {
    "meeting_url": "YOUR-MEETING-URL",
    "bot_name": "AI Notetaker",
    "recording_mode": "speaker_view",
    "bot_image": "https://example.com/bot.jpg",
    "entry_message": "I am a good meeting bot :)",
    "reserved": False,
    "speech_to_text": {
        "provider": "Default"
    },
    "automatic_leave": {
        "waiting_room_timeout": 600  # 10 minutes in seconds
    }
}
response = requests.post(url, json=config, headers=headers)
print(response.json())

join_meeting.js

fetch("https://api.meetingbaas.com/bots", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-meeting-baas-api-key": "YOUR-API-KEY",
  },
  body: JSON.stringify({
    meeting_url: "YOUR-MEETING-URL",
    bot_name: "AI Notetaker",
    reserved: false,
    recording_mode: "speaker_view",
    bot_image: "https://example.com/bot.jpg",
    entry_message: "I am a good meeting bot :)",
    speech_to_text: {
      provider: "Default",
    },
    automatic_leave: {
      waiting_room_timeout: 600,
    },
  }),
})
  .then((response) => response.json())
  .then((data) => console.log(data.bot_id))
  .catch((error) => console.error("Error:", error));

Exemple de bot parlant

Voici comment créer un bot parlant qui peut participer activement aux meetings :

speaking_bot.py

import requests

def create_speaking_bot():
    url = "https://api.meetingbaas.com/bots"
    headers = {
        "Content-Type": "application/json",
        "x-meeting-baas-api-key": "YOUR-API-KEY"
    }
    
    payload = {
        "meeting_url": "YOUR-MEETING-URL",
        "bot_name": "AI Assistant",
        "recording_mode": "speaker_view",
        "entry_message": "Hello! I'm your AI assistant for this meeting.",
        "speaking_bot": {
            "enabled": True,
            "persona": "helpful assistant",
            "knowledge_base": "meeting_guidelines",
            "voice_settings": {
                "voice": "en-US-Neural2-F",
                "speed": 1.0
            }
        },
        "speech_to_text": {
            "provider": "Default"
        }
    }
    
    response = requests.post(url, headers=headers, json=payload)
    return response.json()

# Create speaking bot
result = create_speaking_bot()
print(result)

Commencer

Prêt à déployer des bots dans vos meetings ? Consultez notre documentation complète :