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

Fireflies

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

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

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

Требования

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

Подключение

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

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

Вебхук

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Отключение

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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