API de Bots

Implante Bots de IA em Reuniões Instantaneamente

A API de Bots permite que você implante bots com inteligência artificial em reuniões do Google Meet, Microsoft Teams e Zoom para gravação, transcrição e monitoramento de eventos ao vivo.

  • Envie bots para reuniões instantaneamente ou agende com antecedência
  • Grave áudio/vídeo ou participe somente com áudio
  • Ative transcrição ao vivo e identificação de interlocutores
  • Personalize o nome, avatar e mensagem de entrada do bot
  • Receba webhooks de status em tempo real e de conclusão

Os bots do Meeting BaaS atuam como participantes reais de reuniões, oferecendo integração perfeita para casos de uso de automação, conformidade e análise.

Principais Funcionalidades

  • Suporte a Múltiplas Plataformas: Google Meet, Microsoft Teams, Zoom
  • Entrada Imediata ou Agendada: Implante bots imediatamente ou reserve para reuniões futuras
  • Modos de Gravação: Visualização do apresentador, visualização em galeria ou somente áudio
  • Transcrição: Ao vivo ou pós-reunião, com múltiplas opções de provedor
  • Bots Personalizáveis: Nome, avatar, mensagem de entrada e muito mais
  • Webhooks: Status em tempo real, conclusão e notificações de erro
  • Opções Avançadas: Streaming via WebSocket, deduplicação e muito mais

Tipos de Eventos de Webhook do Bot

Os bots do Meeting BaaS enviam os seguintes eventos de webhook para o seu endpoint:

  • complete: Bot concluiu a gravação, transcrição e MP4 disponíveis
  • failed: Bot falhou ao entrar ou gravar a reunião (com detalhes do erro)
  • transcription_complete: Transcrição concluída (após nova transcrição ou job assíncrono)
  • bot.status_change: Atualizações de status ao vivo (entrando, em chamada, gravando, pausado, encerrado, etc.)

Veja abaixo exemplos 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 da API

A API de Bots fornece endpoints para:

  • Enviar um bot para uma reunião (POST /bots)
  • Remover um bot de uma reunião (DELETE /bots/{bot_id})
  • Listar bots e metadados de reuniões
  • Realizar nova transcrição de uma reunião (POST /bots/retranscribe)
  • Obter dados da reunião, capturas de tela e muito mais

A autenticação é feita por meio da sua chave de API do Meeting BaaS. Consulte os exemplos de código para saber como enviar, remover e interagir com bots de forma programática.

Exemplos de Uso da API

Abaixo estão exemplos de como enviar um bot para uma reunião em diferentes linguagens de programação:

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

Exemplo de Bot com Fala

Veja como criar um bot com fala que pode participar ativamente de reuniões:

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

Primeiros Passos

Pronto para implantar bots em suas reuniões? Confira nossa documentação completa: