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

Jamie

Интеграция Jamie автоматически переносит в Mokapen транскрипты встреч и AI-заметки из meetjamie.ai. Когда встреча обработана в Jamie, Mokapen может создать документ, заметку или сохранить только лёгкий указатель и — когда возможно — связать результат с подходящей встречей, уже имеющейся в календаре.

Jamie — это AI note taker с приоритетом конфиденциальности, который работает без бота на встрече. Интеграция предназначена для команд продаж и customer success, которые уже записывают с Jamie и хотят видеть результат (сводка, задачи, полный диалог) рядом со встречей в CRM.

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

Требования

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

Подключение

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

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

Вебхук

После подключения API-ключа страница Integrations → Jamie показывает URL вебхука для копирования. В Jamie перейдите в Settings → Integrations → Webhooks, создайте вебхук, вставьте URL Mokapen и подпишитесь на meeting.completed.

Выберите аутентификацию в Jamie:

• API key (рекомендуется) — Jamie отправляет секрет в x-jamie-api-key (или в пользовательском заголовке). Вставьте тот же секрет в Mokapen в поле Webhook secret.
• Signature — Jamie подписывает HMAC-SHA256 в x-jamie-signature. Вставьте секрет подписи в Mokapen.

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

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

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

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

Вы также можете включать или отключать сводку (и задачи) и транскрипт.

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

Когда приходит транскрипт, Mokapen пытается привязать его к существующей встрече, используя externalId события календаря из Jamie (идентификаторы синхронизации Google Calendar или Outlook Calendar, уже сохранённые в Mokapen).

Если подходящей встречи нет, документ или заметка всё равно создаётся — просто без связи с событием календаря.

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

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

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

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

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

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

Отключение

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

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

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

Q: Присоединяется ли Mokapen к встрече как бот?

A: Нет. Jamie записывает без бота; Mokapen только получает обработанные заметки через webhook/API.

Q: Личный или workspace API-ключ?

A: Подходят оба. Mokapen определяет область действия при подключении. Используйте workspace-ключ, если нужны встречи всего workspace Jamie.

Q: Где официальная документация Jamie?

A: API и Webhooks.