Aprenda 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 equipas 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 ficheiros 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 utilizador → 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 definiçõ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 guarde.

Webhook

O URL do webhook na página Integrações → Read.ai é o endpoint que o Read.ai deve chamar. Cole-o nas definiçõ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.

Definiçõ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 partilhar transcrições longas com a equipa).
• 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á guardado 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.

Partilha com a equipa

Como noutras integrações Mokapen, pode partilhar a ligação Read.ai com colegas ou equipas selecionados a partir dos controlos de partilha de sync na página de definições. Os utilizadores partilhados 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 registo 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 é guardada — 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 utilizador 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 partilhar 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 definiçõ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 partilhar a integração com eles a partir das definições de partilha 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 definições mais tarde?

R: Menu do utilizador → 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.