Como Usar

Guia

Pre-requisitos

Antes de começar a usar o Prodgy Assistant, certifique-se de que:

Você possui uma conta ativa no Prodgy
Você está vinculado a pelo menos um produto na plataforma
O workspace possui um agente de reuniões instalado (ex: Meeting Scriber) com uma versão ativa
O agente possui um trigger de webhook configurado com a URL de destino das transcrições
Você tem acesso ao email do bot fornecido pela sua organização ou pela equipe Prodgy

Acionando o Prodgy Assistant em uma Reunião

Existem duas formas de fazer o Prodgy Assistant entrar em uma reunião do Microsoft Teams: agendando previamente via convite por email, ou chamando-o ao vivo via comando no chat da reunião.

Acionamento via Convite por Email (Antecipado)

Para que o Prodgy Assistant participe de uma reunião planejada, basta encaminhar o convite para o email do bot.

Receba um convite de reunião do Teams

Você precisa ter recebido (ou criado) um convite de reunião do Microsoft Teams.
Encaminhe o convite para o email do bot

Encaminhe o email do convite para o endereço configurado pela sua organização. O Assistant detectara automaticamente os dados da reunião.
Aguarde a confirmação

O bot processará o convite, validará seu cadastro e agendará a entrada na reunião. Você pode acompanhar o status pelo dashboard.
O bot entra na reunião automaticamente

No horário agendado, o bot entra na reunião, captura o audio e gera a transcrição.
Receba a transcrição

Ao final da reunião, a transcrição completa e entregue automaticamente via webhook para o fluxo configurado no seu produto.

Acionamento via Chat da Reunião (Ao Vivo)

Esqueceu de incluir o Prodgy no convite, ou não é o organizador da reunião? Você pode chamá-lo ao vivo, sem alterar o convite original e sem depender do organizador.

Esteja em uma reunião em andamento

O comando funciona quando a reunião já está acontecendo e você é um dos participantes.
Abra o chat da reunião

Use o ícone Chat na barra superior da reunião do Teams.
Mencione o Prodgy com o comando join

Digite @Prodgy join no chat e envie a mensagem.
Aguarde a confirmação

O Prodgy responde no chat com aviso de privacidade/LGPD, links para os termos e o nome do workspace que receberá a transcrição. Em poucos segundos, o bot aparece como participante na reunião.
Receba a transcrição

Ao final da reunião, a transcrição é entregue ao webhook do seu agente Prodgy ativo — exatamente como aconteceria se você tivesse encaminhado o convite por email.

Múltiplos Workspaces

Se você está vinculado a mais de um workspace no Prodgy, o Assistant precisa saber para qual produto a transcrição deve ser enviada. Existem dois caminhos, conforme o acionamento:

Acionamento por convite por email

Inclua o nome do workspace entre colchetes no título da reunião:

Planejamento Q1 [Marketing]

Neste exemplo, a transcrição será enviada para o webhook configurado no workspace Marketing.

Acionamento via `@Prodgy join` no chat

Você não precisa digitar o nome do workspace no comando. O Assistant usa automaticamente o workspace que você fixou previamente com /prodgy link <slug> no chat de qualquer conversa com o bot — o mesmo comando que vincula sua conta Prodgy ao Teams.

/prodgy list           — lista os workspaces disponíveis
/prodgy link Marketing — fixa o workspace Marketing como destino
@Prodgy join           — bot entra na reunião e usa Marketing automaticamente

A mensagem de confirmação que o bot posta no chat ao entrar mostra explicitamente o nome do workspace que receberá a transcrição.

Reuniões Recorrentes

O Prodgy Assistant suporta reuniões recorrentes automaticamente:

Ao encaminhar um convite de reunião recorrente, o bot agenda todas as próximas ocorrências dentro de um horizonte de 7 dias
Novas ocorrências são expandidas automaticamente a cada 12 horas — você não precisa reenviar o convite
Cada ocorrência gera sua própria transcrição independente

Cancelamentos

Se uma reunião for cancelada:

O bot detecta o cancelamento automaticamente e não entrará na reunião
Se a reunião já estava agendada, ela será removida da fila
Não é necessária nenhuma ação manual
Se você reenviar o convite mais tarde para o mesmo horário de uma ocorrência que havia sido cancelada, o bot volta a agendá-la normalmente — o cancelamento anterior não bloqueia o reenvio

Múltiplos Participantes na Mesma Reunião

A transcrição é entregue exclusivamente ao acionador — quem encaminhou o convite por email ou executou o comando @Prodgy join no chat da reunião. Outros participantes da reunião não recebem a transcrição automaticamente, mesmo que tenham conta ativa no Prodgy.

Quem acionou o bot recebe a transcrição no webhook configurado em seu próprio workspace
Outros participantes que desejarem a transcrição em seu próprio workspace devem acionar o bot por conta própria — encaminhando o convite ou rodando @Prodgy join em seu nome
O bot entra apenas uma vez na reunião — se múltiplos participantes acionarem o mesmo evento, eles passam a compartilhar o mesmo bot, mas cada um continua recebendo a transcrição no webhook do seu próprio acionamento
O áudio de todos os participantes é capturado e transcrito normalmente; a restrição é apenas sobre quem recebe a transcrição final

Comandos Opcionais

Você pode incluir comandos especiais no corpo do email ao encaminhar o convite:

Comando	O que faz
`{{maxwait:N}}`	Define o tempo máximo (em minutos) que o bot aguarda em uma reunião vazia antes de sair. Exemplo: `{{maxwait:10}}` para 10 minutos
`{{transcribe:log}}`	Ativa o log completo de transcrição para esta reunião
`{{webhook:https://...}}`	Envia a transcrição diretamente para a URL informada, sem necessidade de cadastro no Prodgy
`{{lang:xx}}`	Força o idioma da transcrição usando um código BCP-47 (ex: `{{lang:en}}` para inglês, `{{lang:es}}` para espanhol). Quando omitido, o modelo detecta automaticamente o idioma a partir do áudio

Perguntas Frequentes

O bot entra na reunião no horário exato? O bot entra 15 segundos antes do horário agendado para garantir que esteja presente desde o início.

O que acontece se ninguem entrar na reunião? O bot aguarda por um tempo configurado (padrão definido pelo administrador, ou pelo comando {{maxwait:N}}). Se nenhum participante humano aparecer, o bot sai automaticamente.

Posso encaminhar convites de reuniões que já comecaram? Sim. Se a reunião ainda estiver em andamento, o bot entrará imediatamente após o processamento do convite.

A transcrição funciona em outros idiomas além de português? Sim. Por padrão, o modelo detecta automaticamente o idioma do áudio. Se preferir forçar um idioma específico, adicione {{lang:xx}} no corpo do email (ex: {{lang:en}} para inglês).

Preciso encaminhar o convite toda vez para reuniões recorrentes? Não. Basta encaminhar uma única vez é o bot agendará automaticamente as próximas ocorrências.

O que acontece se eu encaminhar o mesmo convite duas vezes? O sistema detecta a duplicação automaticamente. O convite não será agendado novamente.