Руководство Mokapen

tl;dv

Интеграция tl;dv автоматически переносит расшифровки встреч и ИИ-заметки в Mokapen. Когда звонок обработан в tl;dv, Mokapen может создать документ, заметку или сохранить только URL встречи и — по возможности — связать результат с соответствующей встречей уже в календаре.

Это решение для команд продаж и customer success, которые уже записывают звонки в tl;dv и хотят видеть итог (сводка, задачи, полный диалог) рядом со встречей в CRM без ручного экспорта файлов.

Общий обзор интеграций: Интеграции.

Требования

• План Mokapen, включающий интеграцию tl;dv (Premium — значок медали на странице, если недоступно в вашем плане).
• Активный аккаунт tl;dv с правом создавать API-ключи и/или вебхуки.
• Опционально, но рекомендуется: Google Calendar или Outlook Calendar, синхронизированный с Mokapen, чтобы сопоставлять встречи по ID события календаря или URL встречи.

Подключение

В отличие от календарных приложений OAuth, tl;dv подключается по API-ключу. Вставьте ключ один раз в Mokapen, затем настройте вебхук, который уведомляет Mokapen, когда расшифровка готова.

1. Меню пользователя → Интеграции → tl;dv.
2. Нажмите Sync / Подключить (нужен подходящий план Premium).
3. Создайте или скопируйте API-ключ в tl;dv (документация для разработчиков).
4. Вставьте ключ в Mokapen и подтвердите Подключить.
5. После успешного подключения страница показывает связанный аккаунт и открывает настройки вебхука и сохранения.

Вебхук

После подключения API-ключа страница Интеграции → tl;dv показывает URL вебхука для копирования. Вставьте его в настройках tl;dv Webhooks и подпишитесь на событие, когда расшифровка готова (обычно TranscriptReady).

Опционально задайте секрет вебхука в Mokapen и используйте то же значение, что и опциональный секрет в пользовательском заголовке (например X-Webhook-Secret) в tl;dv. Рекомендуется в продакшене, чтобы принимались только подлинные запросы tl;dv.

Нажмите Сохранить на странице Mokapen после изменения секрета вебхука или параметров сохранения.

Параметры сохранения

На странице Интеграции → tl;dv выберите, как хранить каждую обработанную встречу в Mokapen:

• Документ — создаёт документ с содержимым встречи (удобно для длинных расшифровок в команде).
• Заметка — создаёт заметку, связанную с найденной встречей или доступную в ленте заметок.
• URL — сохраняет в основном ссылку на запись в tl;dv без импорта полного текста.

Также можно включить или отключить включение заметок и расшифровки (заметки tl;dv и полная расшифровка). Отключение обоих при режиме URL оставляет только лёгкую ссылку на внешнюю запись.

Сопоставление встреч

Когда приходит расшифровка, Mokapen пытается привязать её к существующей встрече:

1. Сначала ищет ID синхронизации календаря, уже сохранённый для этой встречи (интеграции Google Calendar или Outlook Calendar).
2. Если не удалось — сравнивает URL встречи из tl;dv с полем URL у встреч.
3. Если совпадения нет, документ или заметка всё равно создаётся — просто без связи с событием календаря.

Совет: на карточке встречи держите ту же ссылку на созвон, которую записывает tl;dv (Zoom, Meet, Teams…), и держите синхронизацию календаря активной для надёжного сопоставления.

Совместный доступ для коллег

Как и у других интеграций Mokapen, подключение tl;dv можно открыть выбранным коллегам или командам через элементы совместного доступа синхронизации на странице настроек. Пользователи с доступом получают расшифровки в организации без подключения собственного ключа.

Что происходит после встречи

1. tl;dv завершает обработку записи и отправляет вебхук (или доставляет TranscriptReady).
2. Mokapen принимает payload, при необходимости проверяет подпись/секрет и ставит фоновое задание в очередь.
3. Задание при необходимости запрашивает сводку/расшифровку через API, применяет параметры сохранения и создаёт документ/заметку/запись URL.
4. Если найдено совпадение со встречей, новый элемент связывается с ней и отображается в контексте.
5. Повторные доставки одной и той же записи игнорируются за счёт дедупликации синхронизации, поэтому повторы не создают дубликаты документов.

Частые проблемы

• После звонка ничего не появляется — проверьте, что вебхук корректно вставлен в tl;dv (исключение Grain, где он создаётся автоматически), что интеграция всё ещё подключена и что план Premium включает это приложение.
• Документ создан, но не на встрече — URL встречи или ID события календаря не совпали. Откройте встречу, проверьте URL и убедитесь, что синхронизация календаря активна.
• Вебхук отклонён / ошибки подписи — секрет в Mokapen должен точно совпадать с настроенным в tl;dv; при сомнениях пересоздайте оба.
• Сохраняется только ссылка — проверьте Сохранить как и флажки сводки/расшифровки; режим URL намеренно пропускает полный текст.
• Недействительный API-ключ — создайте ключ заново в tl;dv и переподключитесь в Интеграции → tl;dv.

Отключение

Используйте Отключить на странице Интеграции → tl;dv (доступно пользователю, подключившему интеграцию). Также удалите или отключите вебхук в tl;dv, если больше не нужны доставки.

Уже созданные документы и заметки остаются в Mokapen; отключение лишь останавливает поступление новых расшифровок.

Сценарии использования

• Follow-up после sales-звонка — после discovery-звонка, записанного в tl;dv, сводка появляется как документ на встрече: AE может поделиться задачами без переписывания заметок.
• Архив CS QBR — квартальные бизнес-обзоры остаются доступны для поиска в документах Mokapen, связанные со встречей клиента.
• Передача между ролями — SDR записывают демо в tl;dv; closers открывают сопоставленную встречу и читают расшифровку без смены инструментов.
• Лёгкий указатель в CRM — используйте режим сохранения URL, когда нужна только глубокая ссылка обратно в tl;dv с карточки встречи.

Часто задаваемые вопросы

Q: Записывает ли Mokapen встречу сам?

A: Нет. Запись и расшифровка выполняются в tl;dv. Mokapen только получает результат через вебхук и сохраняет его по вашим настройкам.

Q: Всегда ли нужен API-ключ?

A: Да для tl;dv: вставьте ключ один раз для подключения. Затем вебхук доставляет каждую готовую расшифровку.

Q: Что если нет подходящей встречи?

A: Документ или заметка всё равно создаётся. Позже можно связать вручную или исправить URL встречи / синхронизацию календаря для будущих звонков.

Q: Могут ли коллеги использовать моё подключение?

A: Да, если вы открыли им интеграцию в настройках совместного доступа синхронизации на странице Интеграции.

Q: Переподключение продублирует старые встречи?

A: Mokapen дедуплицирует по идентификатору синхронизации уже импортированные записи. Новые встречи по-прежнему создают новые документы/заметки.

Q: Где потом найти настройки?

A: Меню пользователя → Интеграции → tl;dv. URL вебхука, секреты и параметры сохранения — на этой странице после подключения.