Интеграции
Лия Sense получает разговоры из внешних систем двумя способами:
| Способ | Как работает | Что нужно от вас |
|---|---|---|
| Мы забираем данные (pull) | Система сама подключается к API или к серверу вашей платформы и по расписанию забирает завершённые разговоры | Доступ: API-ключ, учётная запись или SFTP-доступ только на чтение |
| Вы отправляете данные (push, вебхук) | Ваша система отправляет каждый звонок или диалог на выданную вам ссылку по мере их завершения | Разработка на вашей стороне: HTTP-запросы по описанному формату |
В обоих случаях данные попадают в Лия Sense через задачу сбора: периодическая задача раз в сутки забирает новые разговоры и передаёт их на транскрибацию и анализ.
Доступные платформы
| Платформа | Тип разговоров | Как получаем данные | Что понадобится |
|---|---|---|---|
| HelpDeskEddy | Диалоги | API HelpDeskEddy | Домен аккаунта, email и API-ключ |
| Usedesk | Диалоги | API Usedesk | API-токен |
| Webim | Диалоги | API Webim | Домен аккаунта, логин и пароль API |
| Mango Office VPBX | Звонки | API ВАТС Mango Office | Код ВАТС и ключ подписи |
| Bitrix24 | Звонки | REST API Bitrix24 | Входящий вебхук Bitrix24 с правом telephony (права crm и user необязательны, но без них в метаданные не попадут данные CRM и сотрудников) |
| Asterisk (SFTP) | Звонки | Журнал CDR и записи по SFTP | SFTP-доступ только на чтение, настройка cdr.conf и диалплана |
| FreePBX | Звонки | GraphQL API FreePBX и записи по SFTP | Приложение API (Client ID/Secret) и SFTP-доступ только на чтение |
| Вебхук: звонки | Звонки | Вы отправляете события на нашу ссылку | Разработка отправки на вашей стороне |
| Вебхук: диалоги | Диалоги | Вы отправляете события на нашу ссылку | Разработка отправки на вашей стороне |
к сведению
Если вашей платформы нет в списке — используйте вебхук: это универсальный способ передать звонки и диалоги из любой системы, которая умеет отправлять HTTP-запросы.
Общие правила
- Только завершённые разговоры. Звонки приходят из телефонии уже завершёнными. Для тикетов и чатов ограничение по статусу зависит от платформы: если нужны только закрытые обращения, используйте фильтр статуса в задаче сбора там, где он доступен. В вебхук отправляйте только завершённые разговоры сами — поле
statusсохраняется как есть и на приём не влияет. - Дедупликация. Разговор с уже известным идентификатором повторно не загружается, поэтому периоды задач могут пересекаться без последствий.
- Метаданные. Поля исходной системы сохраняются как метаданные разговора: по ним можно фильтровать разговоры в задачах и привязках пайплайнов и анализировать их в Magic Query.
- Аудио не хранится в интеграции. Для телефонии запись забирается из вашей системы в момент обработки, поэтому она должна оставаться доступной хотя бы несколько дней после звонка.
Подробности подключения каждой платформы — в настройке источника.