Aprenda Mokapen.

Fireflies

A integração Fireflies traz transcrições de reuniões e notas de IA para o Mokapen automaticamente. Quando uma chamada é processada em Fireflies, Mokapen pode criar um document, uma note, ou manter apenas a reunião URL, e - quando possível - vincular o resultado ao appointment correspondente já ativado seu calendário.

Isso é projetado para equipes de vendas e sucesso do cliente que já gravam chamadas no Fireflies e desejam o resultado (resumo, itens de ação, diálogo completo) disponível próximo ao compromisso de CRM, sem exportar arquivos manualmente.

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

Requisitos

• Um plano Mokapen que inclui a integração Fireflies (Premium — ícone de medalha na página se não estiver disponível em seu plano).
• Uma conta Fireflies ativa com permissão para criar chaves de API e/ou webhooks.
• Opcional, mas recomendado: Google Calendar ou Outlook Calendar sincronizado com Mokapen, para que os compromissos possam ser correspondidos por ID de evento de calendário ou URL de reunião.

Conectando

Ao contrário dos aplicativos de calendário OAuth, o Fireflies se conecta com uma chave API. Você cola a chave uma vez no Mokapen e, em seguida, configura o webhook que notifica o Mokapen quando uma transcrição está pronta.

1. Menu do usuário → Integrações → Fireflies.
2. Clique em Sync / Connect (requer um plano Premium adequado).
3. Crie ou copie sua chave API do Fireflies (documentação do desenvolvedor).
4. Cole a chave no Mokapen e confirme Connect.
5. Quando o link é bem-sucedido, a página mostra a conta conectada e desbloqueia o webhook e salva as configurações.

Webhook

Depois de conectar a chave API, a página Integrações → Fireflies mostra um webhook URL para copiar. Cole-o nas configurações do Fireflies Developer e assine o evento que é acionado quando uma transcrição está pronta (normalmente reunião transcrita/resumida).

Opcionalmente, defina um Webhook secret em Mokapen e use o mesmo valor que o segredo de assinatura de webhook opcional configurado nas configurações do Fireflies Developer. Isso é recomendado na produção, portanto, apenas solicitações genuínas de Fireflies serão aceitas.

Pressione Salvar na página Mokapen após alterar o segredo do webhook ou salvar opções.

Salvar configurações

Ainda em Integrações → Vagalumes, escolha como cada reunião processada será armazenada no Mokapen:

• Documento — cria um documento com o conteúdo da reunião (melhor para compartilhar transcrições longas com a equipe).
• Note — cria uma nota vinculada ao compromisso correspondente ou disponível em seu fluxo de notas.
• URL — armazena principalmente o link de volta para a gravação em Fireflies, sem importar o corpo do texto completo.

Você também pode alternar se deseja incluir o summary e o transcript (resumo da IA, itens de ação e transcrição completa). Desativar ambos no modo URL mantém apenas um ponteiro leve para a gravação externa.

Compromissos correspondentes

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

1. Primeiro, ele procura um ID de sincronização de calendário já armazenado para aquela reunião (integrações do Google Calendar ou do Outlook Calendar).
2. Se isso falhar, ele compara o URL da reunião do Fireflies com o campo URL nos compromissos.
3. Se nenhum compromisso corresponder, o documento ou nota ainda será criado — simplesmente não está vinculado a um evento de calendário.

Dica: mantenha o mesmo link da reunião no cartão de compromisso que o Fireflies registra (Zoom, Meet, Teams…) e mantenha a sincronização do calendário ativa para uma correspondência mais confiável.

Compartilhando com colegas de equipe

Como outras integrações do Mokapen, você pode compartilhar a conexão Fireflies com colegas de equipe ou equipes selecionados a partir dos controles de compartilhamento de sincronização na página de configurações. Os usuários compartilhados podem se beneficiar das transcrições que chegam à organização sem que cada pessoa conecte sua própria chave.

O que acontece depois de uma reunião

1. Fireflies termina de processar a gravação e dispara o webhook (ou Grain entrega reunião transcrita/resumida).
2. Mokapen recebe a carga útil, opcionalmente verifica a assinatura/segredo e enfileira um trabalho em segundo plano.
3. O trabalho busca detalhes de resumo/transcrição via API quando necessário, aplica suas opções de salvamento e cria o registro de documento/nota/URL.
4. Se um compromisso correspondente for encontrado, o novo item será vinculado a esse compromisso para que apareça no contexto.
5. Entregas duplicadas para a mesma gravação são ignoradas por meio da desduplicação de sincronização, portanto, novas tentativas não criam documentos duplos.

Problemas comuns

• Nada aparece após uma chamada — verifique se o webhook está colado corretamente no Fireflies (exceto Grain, onde é automático), se a integração ainda está conectada e se o plano Premium inclui este aplicativo.
• Documento criado, mas não no compromisso — o URL da reunião ou o ID do evento do calendário não correspondem. Abra o compromisso, confirme o URL e certifique-se de que a sincronização do calendário esteja ativa.
• Webhook rejeitado/erros de assinatura — o segredo no Mokapen deve corresponder exatamente ao que está configurado no Fireflies; regenere ambos os lados se não tiver certeza.
• Apenas o link é salvo — marque Salvar como e as caixas de seleção de resumo/transcrição; O modo URL ignora intencionalmente o corpo inteiro.
• Chave API inválida — gere novamente a chave em Fireflies e reconecte de Integrações → Fireflies.

Desconectando

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

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

Casos de uso

• Acompanhamento de chamada de vendas — após uma chamada de descoberta gravada em Fireflies, o resumo chega como um documento sobre o compromisso: o AE pode compartilhar itens de ação sem reescrever notas.
• Arquivo CS QBR — as análises trimestrais de negócios permanecem pesquisáveis em documentos Mokapen, vinculadas ao agendamento do cliente.
• Handoff entre funções — SDRs gravam demos em Fireflies; os fechadores abrem o compromisso correspondente e leem a transcrição sem trocar de ferramenta.
• Ponteiro CRM leve — use o modo de salvamento URL quando precisar apenas de um link direto para Fireflies a partir do cartão de agendamento.

Perguntas frequentes

Q: Mokapen grava a reunião em si?

A: Não. A gravação e a transcrição acontecem em Fireflies. Mokapen apenas recebe o resultado via webhook e o armazena de acordo com suas configurações.

Q: Uma chave de API é sempre necessária?

A: Sim para Fireflies: cole uma vez para conectar. O webhook então entrega cada transcrição concluída.

Q: E se não houver compromisso correspondente?

A: O documento ou nota ainda foi criado. Você pode vinculá-lo manualmente mais tarde ou corrigir o URL da reunião/sincronização do calendário para chamadas futuras.

P: Os colegas de equipe podem usar minha conexão?

A: Sim, se você compartilhar a integração com eles nas configurações de compartilhamento de sincronização na página Integrações.

P: A reconexão de reuniões antigas será duplicada?

A: Mokapen desduplica por sincronização de identidade para gravações já importadas. Novas reuniões continuam a criar novos documentos/notas.

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

A: Menu do usuário → Integrações → Fireflies. URL do webhook, segredos e opções de salvamento estão nessa página após a conexão.