Ръководството на Мокапен

Jamie

Интеграцията Jamie автоматично внася транскрипции от срещи и AI бележки от meetjamie.ai в Mokapen. Когато срещата е обработена в Jamie, Mokapen може да създаде документ, бележка или да запази само лек указател (URL), а — когато е възможно — да свърже резултата с подходящата среща, вече в календара ви.

Jamie е AI асistent за бележки с фокус върху поверителността, който работи без бот в срещата. Интеграцията е за екипи по продажби и customer success, които вече записват с Jamie и искат резултатът (обобщение, action items, пълен диалог) до CRM срещата.

Общ преглед на интеграциите: Интеграции.

Изисквания

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

Свързване

Jamie се свързва с API ключ (без OAuth). Поставяте ключа веднъж в Mokapen, след което конфигурирате webhook, който уведомява Mokapen, когато срещата е готова.

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

Webhook

След свързване на API ключа страницата Интеграции → Jamie показва webhook URL за копиране. В Jamie отидете на Settings → Integrations → Webhooks, създайте webhook, поставете Mokapen URL и абонирайте се за meeting.completed.

Изберете автентикация в Jamie:

• API key (препоръчително) — Jamie изпраща тайната в x-jamie-api-key (или custom header). Поставете същата тайна в Mokapen Webhook secret.
• Signature — Jamie подписва с HMAC-SHA256 в x-jamie-signature. Поставете signing secret в Mokapen.

Натиснете Запази на страницата Mokapen след промяна на webhook secret или опциите за запис.

Настройки за запис

На същата страница Интеграции → Jamie изберете как всяка обработена среща се записва в Mokapen:

• Document — създава документ със съдържанието на срещата (най-добре за дълги транскрипции).
• Note — създава бележка, свързана със съпоставената среща, когато е възможно.
• URL — запазва лек указател без импорт на пълния текст.

Можете също да включите/изключите обобщение (и action items) и транскрипция.

Съпоставяне на срещи

Когато пристигне транскрипция, Mokapen опитва да я прикачи към съществуваща среща чрез calendar event externalId от Jamie (Google Calendar или Outlook Calendar sync id, вече записани в Mokapen).

Ако няма съвпадение, документът или бележката все пак се създават — просто не са свързани с календарно събитие.

Споделяне с колеги

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

Какво се случва след среща

1. Jamie завършва обработката и изпраща meeting.completed (payload включва обобщение, транскрипция и задачи).
2. Mokapen получава payload, по избор проверява API ключ или HMAC подпис и поставя фонова задача в опашка.
3. Задачата използва съдържанието от webhook (и може да използва Jamie API meetings.get при нужда), прилага вашите опции за запис и създава документ/бележка.
4. При намерено съвпадение със среща новият елемент се свързва с тази среща.
5. Дублирани доставки за същата среща се игнорират чрез дедупликация на синхронизацията.

Чести проблеми

• Нищо не се появява след обаждане — проверете дали webhook URL е правилно поставен в Jamie, събитието е meeting.completed, интеграцията е все още свързана и Premium планът включва това приложение. Уверете се, че queue worker работи.
• Документът е създаден, но не е на срещата — calendar externalId не съвпадна. Поддържайте активна синхронизация на календара за най-надеждно съвпадение.
• Webhook отхвърлен / грешки с подпис — тайната в Mokapen трябва да съвпада точно с това, което Jamie показва при създаване на webhook; регенерирайте и двете страни при съмнение.
• Записва се само кратък запис — проверете Save as и отметките за обобщение/транскрипция; режим URL умишлено пропуска пълното тяло.
• Невалиден API ключ — регенерирайте ключа в Jamie (Settings → Developers → API Keys) и свържете отново. API достъп изисква подходящ Jamie план.

Прекъсване на връзката

Използвайте Disconnect на страницата Интеграции → Jamie (налично за потребителя, свързал интеграцията). Премахнете или деактивирайте webhook в Jamie, ако вече не искате доставки.

Вече създадените документи и бележки остават в Mokapen; прекъсването спира само нови транскрипции.

Често задавани въпроси

В: Mokapen влиза ли в срещата като бот?

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

В: Личен или workspace API ключ?

О: И двата работят. Mokapen определя обхвата при свързване. Използвайте workspace ключ, ако ви трябват срещи от целия Jamie workspace.

В: Къде е официалната документация на Jamie?

О: API и Webhooks.