O guia do Mokapen

Grain

A integração Grain traz automaticamente as transcrições de reuniões e as notas de IA para o Mokapen. Quando uma chamada é processada no Grain, 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 Grain 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 Grain (Premium — ícone de medalha na página se não estiver disponível no seu plano).
• Uma conta Grain ativa com permissão para criar chaves API e/ou webhooks.
• 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 Grain liga-se com uma chave API (token de acesso pessoal). Quando se liga, o Mokapen registra o webhook automaticamente no Grain para o evento recording_added — não precisa de colar um URL de webhook no Grain.

1. Menu do usuário → Integrações → Grain.
2. Clique em Sync / Connect (requer um plano Premium adequado).
3. Crie um token API Grain a partir da documentação para programadores Grain.
4. Cole o token no Mokapen e confirme Connect.
5. O Mokapen cria o webhook no Grain; ao desligar, remove também esse hook.

Webhook

Após uma ligação bem-sucedida, o Mokapen registra um webhook no Grain para recording_added. A página Integrações → Grain mostra o URL do webhook para referência; não é necessária mais configuração no Grain. Quando desliga, o Mokapen exclui o hook remoto para que restos não continuem a disparar.

Configurações de gravação

Ainda em Integrações → Grain, 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 Grain, sem importar o texto completo.

Também pode ativar ou não a inclusão do resumo e da transcrição (resumo AI do Grain, 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 Grain 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 Grain 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 Grain 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 Grain termina o processamento da gravação e dispara o webhook (ou o Grain entrega recording_added).
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 Grain (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 Grain; 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 Grain e volte a ligar em Integrações → Grain.

Desligar

Use Disconnect na página Integrações → Grain (disponível para o usuário que ligou a integração). O Mokapen também remove o webhook Grain que criou.

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 Grain, 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 Grain; 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 Grain 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 Grain. O Mokapen apenas recebe o resultado via webhook e guarda-o conforme as suas configurações.

P: É sempre necessária uma chave API?

R: Sim para o Grain: cole-a uma vez para ligar. O webhook entrega depois cada transcrição concluída.

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 → Grain. O URL do webhook, os segredos e as opções de gravação estão nessa página após a ligação.