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

Fireflies

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

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

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

Требования

Соединение

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

Вебхук

После подключения ключа API на странице «Интеграции → Fireflies» отображается URL-адрес веб-перехватчика ⟧ для копирования. Вставьте его в настройки разработчика Fireflies и подпишитесь на событие, которое срабатывает, когда стенограмма готова (обычно совещание расшифровано/обобщено).

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

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

Сохранить настройки

Все еще в разделе «Интеграции» → Fireflies выберите способ хранения каждой обработанной встречи в Mokapen:

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

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

Когда приходит стенограмма, Мокапен пытается прикрепить ее к существующей встрече:

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

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

Поделиться с товарищами по команде

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

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

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

Общие проблемы

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

Отключение

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

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

Случаи использования

• Последующие звонки по продажам — после звонка-обнаружителя, записанного в Fireflies, сводка отображается в виде документа о встрече: AE может делиться элементами действий, не переписывая примечания.
• Архив CS QBR — ежеквартальные бизнес-обзоры остаются доступными для поиска в документах Mokapen, связанных с встречей с клиентом.
• Передача управления между ролями — SDR записывают демо в Fireflies; доводчики открывают согласованную встречу и читают стенограмму, не переключая инструменты.
• Облегченный указатель CRM — используйте режим сохранения URL, когда вам нужна только глубокая ссылка на Fireflies из карточки встречи.

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

В: Мокапен записывает саму встречу?

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

В: Всегда ли требуется ключ API?

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

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

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

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

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

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

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

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

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