O guia do Mokapen

Jamie

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

O Jamie é um assistente de notas com IA orientado à privacidade que funciona sem bot na reunião. Esta integração destina-se a equipes de vendas e customer success que já gravam com o Jamie e querem o resultado (resumo, tarefas, diálogo completo) junto ao compromisso no CRM.

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

Requisitos

• Um plano Mokapen que inclua a integração Jamie (Premium — ícone de medalha na página se não estiver disponível no seu plano).
• Uma conta Jamie no plano Pro / Team / Enterprise (ou elegível) com permissão para criar chaves API e webhooks.
• Opcional mas recomendado: Google Calendar ou Outlook Calendar sincronizados com o Mokapen, para que os compromissos possam ser associados pelo id do evento de calendário.

Ligação

O Jamie liga-se com uma chave API (sem OAuth). Cola a chave uma vez no Mokapen e depois configura o webhook que avisa o Mokapen quando a reunião está pronta.

1. Menu do usuário → Integrações → Jamie.
2. Clique em Sincronizar / Ligar (requer um plano Premium adequado).
3. Crie uma chave API no Jamie: Settings → Developers → API Keys (documentação para programadores). Use uma chave pessoal (/v1/me) ou de workspace (/v1/workspace).
4. Cole a chave no Mokapen e confirme Ligar.
5. Se a ligação for bem-sucedida, a página mostra a conexão e desbloqueia o webhook e as configurações de gravação.

Webhook

Depois de ligar a chave API, a página Integrações → Jamie mostra um URL de webhook para copiar. No Jamie vá a Settings → Integrations → Webhooks, crie um webhook, cole o URL do Mokapen e subscreva meeting.completed.

Escolha a autenticação no Jamie:

• Chave API (recomendado) — o Jamie envia o secret em x-jamie-api-key (ou num cabeçalho personalizado). Cole o mesmo secret no Mokapen em Webhook secret.
• Signature — o Jamie assina com HMAC-SHA256 em x-jamie-signature. Cole o signing secret no Mokapen.

Prima Salvar na página do Mokapen depois de alterar o secret do webhook ou as opções de gravação.

Configurações de gravação

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

• Documento — cria um documento com o conteúdo da reunião (melhor para transcrições longas).
• Nota — cria uma nota ligada ao compromisso associado quando possível.
• URL — guarda um ponteiro leve sem importar o texto completo.

Também pode ativar ou desativar a inclusão do summary (e action items) e do transcript.

Associar compromissos

Quando chega uma transcrição, o Mokapen tenta anexá-la a um compromisso existente usando o externalId do evento de calendário do Jamie (ids de sincronização do Google Calendar ou Outlook Calendar já salvos no Mokapen).

Se não houver correspondência, o documento ou a nota é criado na mesma — apenas não fica ligado ao evento de calendário.

Compartilhar com a equipe

Como noutras integrações Mokapen, pode compartilhar a ligação Jamie com colegas selecionados ou com toda a organização a partir dos controlos de compartilha de sincronização na página de configurações.

O que acontece após uma reunião

1. O Jamie termina o processamento e dispara meeting.completed (o payload inclui summary, transcript e tasks).
2. O Mokapen recebe o payload, verifica opcionalmente a chave API ou a assinatura HMAC e coloca um job em fila.
3. O job usa o conteúdo do webhook (e pode recorrer à API Jamie meetings.get se necessário), aplica as suas opções de gravação e cria documento/nota.
4. Se encontrar um compromisso correspondente, o novo item fica ligado a esse compromisso.
5. Entregas duplicadas da mesma reunião são ignoradas através da deduplicação de sync.

Problemas comuns

• Nada aparece após uma chamada — verifique se o URL do webhook está corretamente colado no Jamie, se o evento é meeting.completed, se a integração continua ligada e se o plano Premium inclui esta app. Confirme também que o worker da fila está correndo.
• Documento criado mas não no compromisso — o externalId do calendário não correspondeu. Mantenha a sincronização do calendário ativa para a associação mais fiável.
• Webhook rejeitado / erros de assinatura — o secret no Mokapen tem de coincidir exatamente com o que o Jamie mostra ao criar o webhook; regenere ambos os lados se tiver dúvidas.
• Só é salvo um registro curto — verifique Salvar como e as caixas summary/transcript; o modo URL omite intencionalmente o corpo completo.
• Chave API inválida — regenere a chave no Jamie (Settings → Developers → API Keys) e volte a ligar. O acesso API requer um plano Jamie elegível.

Desligar

Use Desligar na página Integrações → Jamie (disponível para quem ligou a integração). Remova ou desative também o webhook no Jamie se já não quiser receber entregas.

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

Perguntas frequentes

P: O Mokapen entra na reunião como bot?

R: Não. O Jamie grava sem bot; o Mokapen só recebe as notas processadas via webhook/API.

P: Chave API pessoal ou de workspace?

R: Ambas funcionam. O Mokapen deteta o âmbito ao ligar. Use uma chave de workspace se precisar das reuniões de todo o workspace Jamie.

P: Onde está a documentação oficial do Jamie?

R: API e Webhooks.