O guia do Mokapen

Read.ai

A integração Read.ai traz automaticamente as transcrições de reuniões e as notas de IA para o Mokapen. Quando uma chamada é processada no Read.ai, o Mokapen pode criar um documento, uma nota ou manter apenas o URL da reunião e — quando possível — associar o resultado ao compromisso correspondente já existente no seu calendário.

Foi concebida para equipes de vendas e customer success que já gravam chamadas no Read.ai e querem o resultado (resumo, ações, diálogo completo) disponível junto ao compromisso do CRM, sem exportar arquivos manualmente.

Visão geral das integrações: Integrações.

Requisitos

• Um plano Mokapen que inclua a integração Read.ai (Premium — ícone de medalha na página se não estiver disponível no seu plano).
• Uma conta Read.ai ativa com permissão para adicionar webhooks em Integrations.
• Opcional, mas recomendado: Google Calendar ou Outlook Calendar sincronizado com o Mokapen, para que os compromissos possam ser associados pelo id do evento ou pelo URL da reunião.

Ligação

O Read.ai não usa um login simples com chave API no Mokapen. Primeiro ativa a integração e depois cola o URL do webhook do Mokapen no Read.ai para que os relatórios de reunião sejam entregues quando estiverem prontos.

1. Menu do usuário → Integrações → Read.ai.
2. Clique em Sync / Connect para ativar a integração no Mokapen (requer Premium).
3. Copie o URL do webhook mostrado na página de configurações.
4. No Read.ai → Integrations, crie um webhook para o evento meeting_end e cole esse URL.
5. Opcional: copie a chave de assinatura do Read.ai para o campo Webhook secret no Mokapen e salve.

Webhook

O URL do webhook na página Integrações → Read.ai é o endpoint que o Read.ai deve chamar. Cole-o nas configurações Integrations do Read.ai para o evento meeting_end. Se o Read.ai mostrar uma chave de assinatura, cole-a em Webhook secret no Mokapen para que os pedidos possam ser verificados via X-Read-Signature.

Configurações de gravação

Ainda em Integrações → Read.ai, escolha como cada reunião processada é armazenada no Mokapen:

• Documento — cria um documento com o conteúdo da reunião (ideal para compartilhar transcrições longas com a equipe).
• Nota — cria uma nota ligada ao compromisso correspondente ou disponível no seu fluxo de notas.
• URL — guarda principalmente a ligação para a gravação no Read.ai, sem importar o texto completo.

Também pode ativar ou não a inclusão do resumo e da transcrição (resumo de IA, ações e transcrição completa). Desativar ambos no modo URL mantém apenas um apontador leve para a gravação externa.

Correspondência de compromissos

Quando chega uma transcrição, o Mokapen tenta associá-la a um compromisso existente:

1. Primeiro procura um id de sync de calendário já salvo para essa reunião (integrações Google Calendar ou Outlook Calendar).
2. Se falhar, compara o URL da reunião do Read.ai com o campo URL dos compromissos.
3. Se nenhum compromisso corresponder, o documento ou a nota é criado na mesma — simplesmente sem ligação a um evento do calendário.

Dica: mantenha no cartão do compromisso a mesma ligação de reunião que o Read.ai grava (Zoom, Meet, Teams…) e mantenha a sync do calendário ativa para a correspondência mais fiável.

Compartilha com a equipe

Como noutras integrações Mokapen, pode compartilhar a ligação Read.ai com colegas ou equipes selecionados a partir dos controlos de compartilha de sync na página de configurações. Os usuários compartilhados beneficiam das transcrições na organização sem que cada um ligue a sua própria chave.

O que acontece após uma reunião

1. O Read.ai termina o processamento da gravação e dispara o webhook (ou o Grain entrega meeting_end).
2. O Mokapen recebe o payload, verifica opcionalmente a assinatura/segredo e coloca um job em segundo plano na fila.
3. O job obtém os detalhes de resumo/transcrição via API quando necessário, aplica as suas opções de gravação e cria o registro documento/nota/URL.
4. Se for encontrado um compromisso correspondente, o novo item é ligado a esse compromisso para aparecer em contexto.
5. Entregas duplicadas da mesma gravação são ignoradas via deduplicação de sync, para que as novas tentativas não criem documentos em dobro.

Problemas comuns

• Nada aparece após uma chamada — verifique se o webhook está corretamente colado no Read.ai (exceto Grain, onde é automático), se a integração ainda está ligada e se o plano Premium inclui esta app.
• Documento criado mas não no compromisso — o URL da reunião ou o id do evento do calendário não coincidiram. Abra o compromisso, confirme o URL e assegure-se de que a sync do calendário está ativa.
• Webhook rejeitado / erros de assinatura — o segredo no Mokapen deve coincidir exatamente com o configurado no Read.ai; regenere ambos os lados se não tiver a certeza.
• Só a ligação é salva — verifique Save as e as caixas de resumo/transcrição; o modo URL omite de propósito o corpo completo.
• Chave API inválida — regenere a chave no Read.ai e volte a ligar em Integrações → Read.ai.

Desligar

Use Disconnect na página Integrações → Read.ai (disponível para o usuário que ligou a integração). Remova ou desative também o webhook no Read.ai se já não quiser entregas.

Documentos e notas já criados permanecem no Mokapen; desligar apenas impede a chegada de novas transcrições.

Casos de uso

• Follow-up de chamadas de vendas — após uma chamada de discovery gravada no Read.ai, o resumo chega como documento no compromisso: o AE pode compartilhar ações sem reescrever notas.
• Arquivo QBR de CS — as revisões trimestrais de negócio ficam pesquisáveis nos documentos Mokapen, ligadas ao compromisso do cliente.
• Passagem entre papéis — os SDR gravam demos no Read.ai; os closers abrem o compromisso correspondente e leem a transcrição sem mudar de ferramenta.
• Apontador CRM leve — use o modo de gravação URL quando só precisa de uma ligação profunda de volta ao Read.ai a partir do cartão do compromisso.

Perguntas frequentes

P: O Mokapen grava a reunião por si?

R: Não. A gravação e a transcrição ocorrem no Read.ai. O Mokapen apenas recebe o resultado via webhook e guarda-o conforme as suas configurações.

P: É sempre necessária uma chave API?

R: Não há chave API no Mokapen para o Read.ai: ative a integração e configure o webhook no Read.ai.

P: E se não houver compromisso correspondente?

R: O documento ou a nota é criado na mesma. Pode associá-lo manualmente mais tarde ou corrigir o URL da reunião / a sync do calendário para chamadas futuras.

P: Os colegas podem usar a minha ligação?

R: Sim, se compartilhar a integração com eles a partir das configurações de compartilha de sync na página Integrações.

P: Ao voltar a ligar vão-se duplicar reuniões antigas?

R: O Mokapen deduplica por identidade de sync as gravações já importadas. Novas reuniões continuam a criar novos documentos/notas.

P: Onde encontro as configurações mais tarde?

R: Menu do usuário → Integrações → Read.ai. O URL do webhook, os segredos e as opções de gravação estão nessa página após a ligação.