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

Fathom

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

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

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

Требования

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

Подключение

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

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

Вебхук

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

Опционально задайте секрет вебхука в Mokapen и используйте то же значение, что и опциональный секрет вебхука в Fathom API Access. Рекомендуется в продакшене, чтобы принимались только подлинные запросы Fathom.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Отключение

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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