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

Read.ai

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

Предназначена е за екипи по продажби и customer success, които вече записват обаждания в Read.ai и искат резултатът (обобщение, action items, пълен диалог) до CRM срещата, без ръчен експорт на файлове.

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

Изисквания

• Mokapen план, който включва интеграцията Read.ai (Premium — икона медал на страницата, ако не е налична за вашия план).
• Активен Read.ai акаунт с право да добавяте webhooks в Integrations.
• По избор, но препоръчително: Google Calendar или Outlook Calendar, синхронизиран с Mokapen, за съпоставяне на срещи по calendar event id или meeting URL.

Свързване

Read.ai не използва прост вход с API ключ в Mokapen. Първо активирате интеграцията, след което поставяте Mokapen webhook URL в Read.ai, за да се доставят отчетите от срещи, когато са готови.

1. Потребителско меню → Интеграции → Read.ai.
2. Натиснете Синхронизирай / Свържи, за да активирате интеграцията в Mokapen (изисква Premium).
3. Копирайте webhook URL, показан на страницата с настройки.
4. В Read.ai → Integrations създайте webhook за събитие meeting_end и поставете този URL.
5. По избор: копирайте signing key от Read.ai в полето Webhook secret в Mokapen и запазете.

Webhook

Webhook URL на страницата Интеграции → Read.ai е endpoint, който Read.ai трябва да извиква. Поставете го в настройките Integrations на Read.ai за събитие meeting_end. Ако Read.ai показва signing key, поставете го в Webhook secret в Mokapen, за да се проверяват заявките чрез X-Read-Signature.

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

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

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

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

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

Когато пристигне транскрипция, Mokapen опитва да я прикачи към съществуваща среща:

1. Първо търси calendar sync id, вече записан за тази среща (интеграции Google Calendar или Outlook Calendar).
2. Ако това не успее, сравнява meeting URL от Read.ai с полето URL на срещите.
3. Ако няма съвпадение, документът или бележката все пак се създават — просто не са свързани с календарно събитие.

Съвет: поддържайте същата meeting връзка на картата на срещата, която Read.ai записва (Zoom, Meet, Teams…), и активна синхронизация на календара за най-надеждно съвпадение.

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

Като при други Mokapen интеграции, можете да споделите Read.ai връзката с избрани колеги или екипи от контролите за споделяне на синхронизацията. Споделените потребители могат да ползват транскрипции в организацията без всеки да свързва собствен ключ.

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

1. Read.ai завършва обработката на записа и изпраща webhook.
2. Mokapen получава payload, по избор проверява подпис/secret и поставя фонова задача в опашка.
3. Задачата извлича детайли за обобщение/транскрипция чрез API при нужда, прилага вашите опции за запис и създава документ/бележка/URL запис.
4. При намерено съвпадение със среща новият елемент се свързва с нея, за да се вижда в контекст.
5. Дублирани доставки за същия запис се игнорират чрез дедупликация, така че повторенията да не създават двойни документи.

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

• Нищо не се появява след обаждане — проверете дали webhook е правилно поставен в Read.ai, интеграцията е свързана и Premium планът включва това приложение.
• Документът е създаден, но не е на срещата — meeting URL или calendar event id не съвпаднаха. Отворете срещата, потвърдете URL и активирайте синхронизация на календара.
• Webhook отхвърлен / грешки с подпис — secret в Mokapen трябва да съвпада точно с конфигурацията в Read.ai; регенерирайте и двете страни при съмнение.
• Записва се само връзката — проверете Save as и отметките за обобщение/транскрипция; режим URL умишлено пропуска пълното тяло.
• Невалиден API ключ — регенерирайте ключа в Read.ai и свържете отново от Интеграции → Read.ai.

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

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

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

Примери за използване

• Последващи действия след продажбено обаждане — след discovery call, записан в Read.ai, обобщението става документ на срещата: AE може да сподели action items без пренаписване на бележки.
• Архив на QBR за CS — тримесечните business review остават търсими в Mokapen документи, свързани със срещата с клиента.
• Предаване между роли — SDR записват демота в Read.ai; closers отварят съпоставената среща и четат транскрипцията без смяна на инструменти.
• Лек указател в CRM — използвайте режим URL, когато ви трябва само deep link към Read.ai от картата на срещата.

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

В: Mokapen ли записва самата среща?

О: Не. Записът и транскрипцията са в Read.ai. Mokapen получава резултата чрез webhook и го записва според настройките ви.

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

О: Няма API ключ в Mokapen за Read.ai: активирайте интеграцията и конфигурирайте webhook в Read.ai.

В: Какво ако няма съпоставена среща?

О: Документът или бележката все пак се създават. Можете да ги свържете ръчно по-късно или да коригирате meeting URL / calendar sync за бъдещи обаждания.

В: Колегите могат ли да ползват моята връзка?

О: Да, ако споделите интеграцията с тях от настройките за споделяне на синхронизацията на страницата Интеграции.

В: Ще дублира ли повторното свързване стари срещи?

О: Mokapen дедуплицира по sync identity за вече импортирани записи. Новите срещи продължават да създават нови документи/бележки.

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

О: Потребителско меню → Интеграции → Read.ai. Webhook URL, secrets и опции за запис са на тази страница след свързване.