Aprende mokapen

tl;dv

La integración tl;dv trae transcripciones de reuniones y notas de IA a Mokapen automáticamente. Cuando se procesa una llamada en tl;dv, Mokapen puede crear un document, una nota o conservar solo la reunión URL y, cuando sea posible, vincular el resultado a la cita correspondiente. ya en tu calendario.

Esto está diseñado para equipos de ventas y éxito del cliente que ya graban llamadas en tl;dv y desean que el resultado (resumen, elementos de acción, diálogo completo) esté disponible junto a la cita de CRM, sin exportar archivos a mano.

Resumen general de integraciones: Integraciones.

Requisitos

• Un plan Mokapen que incluye la integración tl;dv (Premium: ícono de medalla en la página si no está disponible en su plan).
• Una cuenta tl;dv activa con permiso para crear claves API y/o webhooks.
• Opcional pero recomendado: Google Calendar o Outlook Calendar sincronizados con Mokapen, para que las citas puedan coincidir por ID de evento de calendario o URL de reunión.

Conectando

A diferencia de las aplicaciones de calendario OAuth, tl;dv se conecta con una clave API. Pegas la clave una vez en Mokapen y luego configuras el webhook que notifica a Mokapen cuando una transcripción está lista.

1. Menú de usuario → Integraciones → tl;dv.
2. Haga clic en Sync / Connect (requiere un plan Premium adecuado).
3. Cree o copie su clave API desde tl;dv (documentación del desarrollador).
4. Pegue la clave en Mokapen y confirme Connect.
5. Cuando el enlace se realiza correctamente, la página muestra la cuenta conectada y desbloquea el webhook y guarda la configuración.

Webhook

Después de conectar la clave API, la página Integraciones → tl;dv muestra una URL de webhook para copiar. Pégalo en la configuración de tl;dv Webhooks y suscríbete al evento que se activa cuando una transcripción está lista (normalmente TranscriptReady).

Opcionalmente, configure un Webhook secret en Mokapen y use el mismo valor que el secreto de encabezado personalizado opcional (por ejemplo, X-Webhook-Secret) configurado en tl;dv. Esto se recomienda en producción, por lo que solo se aceptan solicitudes genuinas de tl;dv.

Presione Guardar en la página de Mokapen después de cambiar el secreto del webhook o las opciones de guardar.

Guardar configuración

Aún en Integraciones → tl;dv, elija cómo se almacena cada reunión procesada en Mokapen:

• Documento: crea un documento con el contenido de la reunión (mejor para compartir transcripciones largas con el equipo).
• Nota: crea una nota vinculada a la cita coincidente o disponible en su secuencia de notas.
• URL: almacena principalmente el enlace a la grabación en tl;dv, sin importar el cuerpo del texto completo.

También puede alternar si desea incluir las notas y la transcripción (tl;notas dv y transcripción completa). Desactivar ambos con el modo URL mantiene solo un puntero ligero a la grabación externa.

Citas coincidentes

Cuando llega una transcripción, Mokapen intenta adjuntarla a una cita existente:

1. Primero busca una identificación de sincronización de calendario ya almacenada para esa reunión (integraciones de Calendario de Google o Calendario de Outlook).
2. Si eso falla, compara la URL de la reunión de tl;dv con el campo URL en citas.
3. Si ninguna cita coincide, el documento o la nota aún se crea; simplemente no está vinculado a un evento del calendario.

Consejo: mantenga el mismo enlace de reunión en la tarjeta de cita que registra tl;dv (Zoom, Meet, Teams...) y mantenga activa la sincronización del calendario para obtener la coincidencia más confiable.

Compartir con compañeros de equipo

Al igual que otras integraciones de Mokapen, puedes compartir la conexión tl;dv con compañeros de equipo o equipos seleccionados desde los controles de sincronización compartida en la página de configuración. Los usuarios compartidos pueden beneficiarse de las transcripciones que llegan a la organización sin que cada persona conecte su propia clave.

Qué sucede después de una reunión

1. tl;dv termina de procesar la grabación y activa el webhook (o Grain entrega TranscriptReady).
2. Mokapen recibe la carga útil, opcionalmente verifica la firma/secreto y pone en cola un trabajo en segundo plano.
3. El trabajo obtiene detalles de resumen/transcripción a través de API cuando es necesario, aplica sus opciones de guardado y crea el documento/nota/registro URL.
4. Si se encuentra una cita coincidente, el nuevo elemento se vincula a esa cita para que aparezca en contexto.
5. Las entregas duplicadas para la misma grabación se ignoran mediante la deduplicación sincronizada, por lo que los reintentos no crean documentos dobles.

Problemas comunes

• No aparece nada después de una llamada: verifique que el webhook esté pegado correctamente en tl;dv (excepto Grain, donde es automático), que la integración aún esté conectada y que el plan Premium incluya esta aplicación.
• Documento creado pero no en la cita: la URL de la reunión o la identificación del evento del calendario no coincidieron. Abra la cita, confirme la URL y asegúrese de que la sincronización del calendario esté activa.
• Webhook rechazado/errores de firma — el secreto en Mokapen debe coincidir exactamente con lo que está configurado en tl;dv; regenera ambos lados si no estás seguro.
• Solo se guarda el enlace: marque Guardar como y las casillas de verificación de resumen/transcripción; El modo URL omite intencionalmente el cuerpo completo.
• Clave API no válida: regenere la clave en tl;dv y vuelva a conectarse desde Integraciones → tl;dv.

Desconectando

Utilice Desconectar en la página Integraciones → tl;dv (disponible para el usuario que conectó la integración). Elimine o desactive también el webhook en tl;dv si ya no desea realizar entregas.

Los documentos y notas ya creados permanecen en Mokapen; desconectarse solo impide que lleguen nuevas transcripciones.

Casos de uso

• Seguimiento de la llamada de ventas: después de una llamada de descubrimiento registrada en tl;dv, el resumen llega como un documento sobre la cita: el AE puede compartir elementos de acción sin tener que volver a escribir notas.
• Archivo CS QBR: las revisiones comerciales trimestrales se pueden buscar en documentos Mokapen, vinculadas a la cita con el cliente.
• Transferencia entre roles — Los SDR registran demostraciones en tl;dv; Los cerradores abren la cita coincidente y leen la transcripción sin cambiar de herramienta.
• Puntero CRM liviano: use el modo guardar URL cuando solo necesite un vínculo profundo a tl;dv desde la tarjeta de citas.

Preguntas frecuentes

P: ¿Mokapen graba la reunión en sí?

A: No. La grabación y transcripción se realizan en tl;dv. Mokapen solo recibe el resultado a través de webhook y lo almacena según su configuración.

P: ¿Siempre se requiere una clave API?

A: Sí para tl;dv: pégalo una vez para conectarte. Luego, el webhook entrega cada transcripción completa.

P: ¿Qué pasa si no hay una cita coincidente?

A: El documento o nota aún se crea. Puede vincularlo manualmente más tarde o corregir la sincronización de la URL/calendario de la reunión para futuras llamadas.

P: ¿Pueden mis compañeros de equipo usar mi conexión?

R: Sí, si compartes la integración con ellos desde la configuración de sincronización compartida en la página Integraciones.

P: ¿La reconexión duplicará reuniones antiguas?

A: Mokapen deduplica mediante identidad de sincronización para grabaciones ya importadas. Las nuevas reuniones continúan creando nuevos documentos/notas.

P: ¿Dónde encuentro la configuración más adelante?

A: Menú de usuario → Integraciones → tl;dv. La URL del webhook, los secretos y las opciones para guardar se encuentran en esa página después de conectarse.