Aprenda Mokapen.

tl;dv

A integração tl;dv traz transcrições de reuniões e notas de IA para o Mokapen automaticamente. dv, 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á está na sua agenda.

Isso é projetado para equipes de vendas e sucesso do cliente que já gravam chamadas em tl;dv 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 tl;dv (Premium — ícone de medalha na página se não estiver disponível em seu plano).
• Uma conta tl;dv 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, tl;dv 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 → tl;dv.
2. Clique em Sync / Connect (requer um plano Premium adequado).
3. Crie ou copie sua chave API de tl;dv (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 → tl;dv mostra um webhook URL para copiar. Cole-o nas configurações do tl;dv Webhooks e assine o evento que é acionado quando uma transcrição está pronta (normalmente TranscriptReady).

Opcionalmente, defina um Webhook secret em Mokapen e use o mesmo valor que o segredo de cabeçalho personalizado opcional (por exemplo, X-Webhook-Secret) configurado em tl;dv. Isso é recomendado na produção, portanto, apenas solicitações tl;dv genuínas sã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 → tl;dv, 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 tl;dv, sem importar o corpo do texto completo.

Você também pode alternar se deseja incluir as notes e a transcript (notas tl;dv 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 de tl;dv com o campo URL em 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 tl;dv 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 tl;dv 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. tl;dv termina o processamento da gravação e dispara o webhook (ou Grain entrega TranscriptReady).
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 em tl;dv (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 em tl;dv; 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 tl;dv e reconecte de Integrações → tl;dv.

Desconectando

Use Disconnect na página Integrações → tl;dv (disponível para o usuário que conectou a integração). Remova ou desative o webhook em tl;dv 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 tl;dv, 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 tl;dv; 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 de volta para tl;dv 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 tl;dv. 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 tl;dv: 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 → tl;dv. URL do webhook, segredos e opções de salvamento estão nessa página após a conexão.