API de Bots

Implemente bots de IA en reuniones al instante

La API de Bots le permite implementar bots con inteligencia artificial en reuniones de Google Meet, Microsoft Teams y Zoom para grabación, transcripción y monitoreo de eventos en tiempo real.

  • Envíe bots a reuniones al instante o prográmelos con anticipación
  • Grabe audio/video o únase en modo solo audio
  • Active la transcripción en tiempo real e identificación de interlocutores
  • Personalice el nombre, avatar y mensaje de entrada del bot
  • Reciba webhooks de estado en tiempo real y de finalización

Los bots de Meeting BaaS actúan como participantes reales en las reuniones, proporcionando una integración fluida para casos de uso de automatización, cumplimiento normativo y analítica.

Características Principales

  • Compatibilidad Multiplataforma: Google Meet, Microsoft Teams, Zoom
  • Unión Inmediata o Programada: Implemente bots de inmediato o resérvelos para reuniones futuras
  • Modos de Grabación: Vista de orador, vista de galería o solo audio
  • Transcripción: En tiempo real o posterior a la reunión, con múltiples opciones de proveedor
  • Bots Personalizables: Nombre, avatar, mensaje de entrada y más
  • Webhooks: Estado en tiempo real, finalización y notificaciones de error
  • Opciones Avanzadas: Streaming por WebSocket, deduplicación y más

Tipos de Eventos Webhook del Bot

Los bots de Meeting BaaS envían los siguientes eventos webhook a su endpoint:

  • complete: El bot finalizó la grabación; transcripción y MP4 disponibles
  • failed: El bot no pudo unirse o grabar la reunión (con detalles del error)
  • transcription_complete: Transcripción completada (después de retranscribir o trabajo asíncrono)
  • bot.status_change: Actualizaciones de estado en tiempo real (uniéndose, en llamada, grabando, pausado, finalizado, etc.)

Consulte a continuación los ejemplos de payloads de 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"
}

Uso de la API

La API de Bots proporciona endpoints para:

  • Enviar un bot a una reunión (POST /bots)
  • Eliminar un bot de una reunión (DELETE /bots/{bot_id})
  • Listar bots y metadatos de reuniones
  • Retranscribir una reunión (POST /bots/retranscribe)
  • Obtener datos de la reunión, capturas de pantalla y más

La autenticación se realiza mediante su API key de Meeting BaaS. Consulte los ejemplos de código para saber cómo enviar, eliminar e interactuar con bots de forma programática.

Ejemplos de Uso de la API

A continuación se presentan ejemplos para enviar un bot a una reunión en diferentes lenguajes de programación:

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

Ejemplo de Bot con Voz

A continuación se muestra cómo crear un bot con capacidad de habla que pueda participar activamente en las reuniones:

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)
Meeting BaaS API Preview Features

Primeros Pasos

¿Listo para implementar bots en sus reuniones? Consulte nuestra documentación completa: