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

Grain

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

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

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

Требования

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

Подключение

Grain подключается с помощью API-ключа (персональный токен доступа). При подключении Mokapen автоматически регистрирует вебхук в Grain для события recording_added — вам не нужно вставлять URL вебхука в Grain.

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

Вебхук

После успешного подключения Mokapen регистрирует вебхук в Grain для recording_added. Страница Интеграции → Grain показывает URL вебхука для справки; дальнейшая настройка в Grain не нужна. При отключении Mokapen удаляет удалённый хук, чтобы остатки не продолжали срабатывать.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Отключение

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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