Como Gravar Chamadas do Google Meet Programaticamente (Guia 2026)

LLazare Rossillon

Grave e transcreva chamadas do Google Meet a partir do seu backend com uma chamada de API — sem configuração de administrador do Google Workspace, sem extensões do Chrome. O bot entra, grava e os webhooks entregam a transcrição.

Como Gravar Chamadas do Google Meet Programaticamente (Guia 2026)
August 13, 2026

Gravar chamadas do Google Meet a partir do código parece ser algo que deveria estar a um Google API de distância. Mas não é bem assim: a API REST oficial do Google Meet permite que um host ou participante autenticado recupere registros de conferências e artefatos via OAuth — mas ela só exibe gravações que foram iniciadas no próprio Meet (um recurso pago do Workspace), exige consentimento OAuth por usuário (ou delegação em todo o domínio configurada pelo administrador), e não cobre o caso de uso de produto mais comum: gravar de forma confiável cada reunião que seus usuários participam, entre organizações.

O padrão prático que a indústria adotou é o meeting bot: um participante automatizado que entra na chamada como convidado, grava o que vê e ouve, e reporta de volta para a sua API. Este guia mostra como fazer isso com o Meeting BaaS em cerca de dez minutos.

Um POST request de entrada, um webhook de saída. Sem consoles de administração do Google Workspace, sem delegação em todo o domínio, sem extensões de navegador.

Como funciona

  1. Seu backend envia uma URL de reunião para a API do Meeting BaaS
  2. Um bot solicita entrar na chamada do Meet, com o nome e avatar que você configurar
  3. Um participante o admite (como qualquer convidado externo)
  4. O bot grava vídeo e áudio durante toda a reunião
  5. Quando a chamada termina, os webhooks entregam a gravação, uma transcrição com atribuição de interlocutores, a lista de participantes e uma linha do tempo de interlocutores

Etapa 1: Obtenha uma chave de API

Cadastre-se em auth.meetingbaas.com — o cadastro é self-serve e suas primeiras 8 horas de gravação são gratuitas.

Etapa 2: Envie um bot para uma reunião

Com curl:

curl -X POST "https://api.meetingbaas.com/v2/bots" \
     -H "Content-Type: application/json" \
     -H "x-meeting-baas-api-key: $API_KEY" \
     -d '{
           "meeting_url": "https://meet.google.com/abc-defg-hij",
           "bot_name": "Recording Bot"
         }'

Ou com o SDK TypeScript:

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

const client = createBaasClient({
  api_key: process.env.MEETING_BAAS_API_KEY,
  api_version: "v2"
});

const { success, data, error } = await client.createBot({
  bot_name: "Recording Bot",
  meeting_url: "https://meet.google.com/abc-defg-hij"
});

if (success) {
  console.log("Bot created:", data.bot_id);
} else {
  console.error("Error creating bot:", error);
}

Etapa 3: Receba os dados por webhook

Registre um endpoint de webhook no dashboard. Quando a reunião termina e o processamento é concluído, você recebe a URL da gravação, a transcrição com atribuição de interlocutores, eventos de entrada/saída de participantes e a linha do tempo do interlocutor atual. Os formatos completos do payload estão na documentação de webhooks.

Agendamento automático de bots

Enviar manualmente uma URL de reunião funciona para gravação sob demanda. Para um produto que grava todas as reuniões de um usuário, conecte o calendário dele: a integração de calendário integrada monitora eventos futuros e agenda bots para eles automaticamente — sem cron jobs do seu lado.

O que saber antes de ir para produção

  • Consentimento em primeiro lugar: um nome de bot reconhecível não é autorização para gravar. Obtenha o consentimento dos participantes exigido pelas leis aplicáveis nas jurisdições dos seus usuários antes de enviar um bot — essa responsabilidade é sua como cliente da API (consulte os termos).
  • Admissão: o bot entra como convidado externo, portanto alguém na reunião precisa admiti-lo. Nomeie-o claramente (por exemplo, "Acme Notetaker") para que os usuários o reconheçam.
  • O tempo de espera é cobrado como gravação: se o bot ficar sem ser admitido, esse tempo consome tokens. Defina timeouts razoáveis.
  • Preços: a gravação custa 1 token por hora (US$ 0,35–0,50 dependendo do tamanho do pacote de tokens) com separação de interlocutores incluída; a transcrição adiciona 0,25 tokens por hora.
  • O mesmo código funciona para Zoom e Teams: troque a URL da reunião e todo o resto permanece idêntico. Consulte os guias de plataforma para Zoom e Microsoft Teams.

Próximos passos

Similar blogstutorial