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

Read.ai

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

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

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

Требования

• План Mokapen, включающий интеграцию Read.ai (Premium — значок медали на странице, если недоступно в вашем плане).
• Активная учётная запись Read.ai с правом добавлять вебхуки в Integrations.
• Необязательно, но рекомендуется: Google Calendar или Outlook Calendar, синхронизированный с Mokapen, чтобы встречи можно было сопоставлять по id события календаря или URL встречи.

Подключение

Read.ai не использует простой вход по API-ключу в Mokapen. Сначала вы активируете интеграцию, затем вставляете URL вебхука Mokapen в Read.ai, чтобы отчёты о встречах доставлялись, когда они готовы.

1. Меню пользователя → Интеграции → Read.ai.
2. Нажмите Sync / Connect, чтобы активировать интеграцию в Mokapen (требуется Premium).
3. Скопируйте URL вебхука, показанный на странице настроек.
4. В Read.ai → Integrations создайте вебхук для события meeting_end и вставьте этот URL.
5. Необязательно: скопируйте ключ подписи из Read.ai в поле Webhook secret в Mokapen и сохраните.

Вебхук

URL вебхука на странице Интеграции → Read.ai — это конечная точка, которую должен вызывать Read.ai. Вставьте его в настройках Integrations Read.ai для события meeting_end. Если Read.ai показывает ключ подписи, вставьте его в Webhook secret в Mokapen, чтобы запросы можно было проверять через X-Read-Signature.

Настройки сохранения

По-прежнему на странице Интеграции → Read.ai выберите, как каждая обработанная встреча сохраняется в Mokapen:

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

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

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

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

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

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

Совместный доступ с командой

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

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

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

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

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

Отключение

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

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

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

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

Частые вопросы

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

О: Нет. Запись и расшифровка происходят в Read.ai. Mokapen только получает результат через вебхук и сохраняет его согласно вашим настройкам.

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

О: В Mokapen для Read.ai API-ключ не нужен: активируйте интеграцию и настройте вебхук в Read.ai.

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

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

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

О: Да, если вы поделитесь интеграцией с ними в настройках общего доступа sync на странице Интеграции.

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

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

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

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