Ограничения
Какие звонки попадают в CRM
Звонок со скрытым номером или номером, из которого нельзя получить нормализованный номер (меньше 10 или больше 15 цифр), не фиксируется.
Обрабатываются входящие звонки всех линий, по которым MANGO OFFICE отправляет уведомления: фильтра по линии или номеру ВАТС нет.
Интеграция рассчитана на одну ВАТС MANGO OFFICE (один код ВАТС и одну соль).
В карточке сохраняется одна аудиозапись звонка.
Примечание
Переведённые звонки. При переводе звонка MANGO OFFICE создаёт отдельную аудиозапись для каждого участка разговора с общим идентификатором звонка. Если к приходу следующего уведомления первая аудиозапись уже сохранена, остальные отбрасываются (в логе — the record/added of recording … is dropped). Если аудиозаписи обрабатываются одновременно, в карточке остаётся та, чья обработка закончилась позже. Поэтому при переводе, например от секретаря к менеджеру, в CRM может попасть только часть разговора. Остальные аудиозаписи доступны в личном кабинете MANGO OFFICE.
Что не сохраняется в активности
Сотрудник, ответивший на звонок, не определяется: внутренние номера и пользователи MANGO OFFICE не сопоставляются с пользователями Citeck. Поле «Ответственный» не заполняется, автором активности указывается система. Менеджер при необходимости заполняет поле вручную.
Номер и линия ВАТС, на которые позвонил клиент, не сохраняются. Звонки на разные линии (например, в отдел продаж и в поддержку) в CRM не различаются.
Длительность разговора берётся из ответа сервиса распознавания, а при неудачном распознавании вычисляется по самому mp3-файлу. У звонка без аудиозаписи длительность не заполняется.
Идентификатор аудиозаписи MANGO OFFICE (
recording_id) в активности не хранится.
Создание лидов
Лид создаётся на каждый состоявшийся входящий звонок с номера, которого нет в активных сделках и лидах. Это касается и поставщиков, партнёров, соискателей, рекламных и спам-номеров, и клиентов, у которых все сделки закрыты.
Списков исключаемых номеров нет. Лишний лид закрывается вручную, например переводом в статус «Дисквалифицирован». Такой лид в поиске не участвует, поэтому следующий звонок с того же номера снова создаст лид.
Если звонки некоторых линий не должны попадать в CRM, отключите для них отправку уведомлений в личном кабинете MANGO OFFICE (если кабинет это позволяет) или обсудите доработку фильтра с Citeck.
Доставка уведомлений и восстановление после простоя
Устойчивые сообщения, уже принятые RabbitMQ, переживают перезапуск приложения. Это не распространяется на удаление очередей или потерю данных брокера.
MANGO OFFICE не повторяет доставку уведомлений. Уведомление теряется безвозвратно, если Citeck или шлюз недоступны, запрос отклонён (например, из-за неверной соли) или маршрут остановлен; в последнем случае MANGO OFFICE получает ответ 200. Отклонённые запросы в логе Citeck не отображаются.
Обрыв публичного HTTPS-туннеля прерывает доставку вебхуков. Повторы обработки аудиозаписей не восстанавливают уведомления, которые вообще не дошли до Citeck. После восстановления связи сверяйте звонки MANGO OFFICE с активностями CRM; не рассчитывайте на автоматическую повторную отправку пропущенных уведомлений.
Если брокер RabbitMQ недоступен в момент прихода уведомления, после двух повторов уведомление теряется, хотя MANGO OFFICE получает успешный ответ. Единственный след — сообщение
is LOSTв логе с содержимым уведомления.Если уведомление о записи обработано раньше итога вызова (MANGO OFFICE не гарантирует порядок), оно отбрасывается, и аудиозапись этого звонка не сохраняется. То же происходит, если итог вызова попал в очередь недоставленных. В обоих случаях аудиозапись можно загрузить, подав уведомление о записи вручную (см. Повторная загрузка аудиозаписи отдельного звонка).
Порядковый номер уведомлений MANGO OFFICE (
seq) не учитывается: запоздавший итог вызова может перезаписать дату звонка.Уведомление о распознавании тематик записи (
/events/record/tagged) по составу полей не отличается от уведомления о записи. Если оно включено, аудиозапись может загружаться и распознаваться повторно, поэтому отправку этого уведомления на адрес Citeck включать не следует.Запрос без подписи (например, проверочный) Citeck отклоняет с кодом 401; на доставку подписанных уведомлений это не влияет.
Поиск сделки или лида
В каждом источнике рассматриваются 100 последних изменённых сделок или лидов, совпавших по номеру. Активная сделка или лид старше них не будут найдены, и будет создан новый лид; в лог выводится предупреждение.
Нормализация рассчитана на российские номера: любой номер из 10 цифр получает префикс 7, международные префиксы выхода
00и810не отбрасываются.Пометка о неоднозначности добавляется только при создании активности; если удалить её из текста, звонок перестанет находиться по маркеру.
Обработка аудиозаписи
Размер аудиозаписи ограничен 50 МБ, язык распознавания — только русский (см. Загрузка аудиозаписи разговора и Распознавание речи).
Качество распознавания ограничено качеством исходной аудиозаписи MANGO OFFICE (телефонный звук с низким битрейтом).
Если одна обработка длится дольше настроенного
consumer_timeoutRabbitMQ, брокер может закрыть канал и вернуть неподтверждённое сообщение. Для длинных аудиозаписей согласуйте тайм-аут с максимальным временем обработки. Паузы в retry-очередях этот тайм-аут потребителя не расходуют.Повреждённое аудио, на которое сервис распознавания отвечает HTTP 500, сейчас повторяется как временная ошибка и после исчерпания попыток попадает в очередь недоставленных со статусом
transcription-failed: аудиозапись и длительность сохраняются, текста нет. Не запускайте бесконечный ручной повтор такого сообщения: сначала устраните проблему с файлом.Уведомление
record/addedне гарантирует немедленную доступность файла по API. HTTP 404 скачивания Mango проходит отложенные повторы; это увеличивает время ожидания и для действительно отсутствующей или удалённой записи. HTTP 404 сервиса распознавания, напротив, считается постоянной ошибкой.
Время звонка
Время звонка берётся из поля create_time итога вызова (при его отсутствии — из talk_time или end_time) как Unix-время без сдвига часового пояса. В документации MANGO OFFICE эти времена помечены как UTC+3. Если MANGO OFFICE передаёт их со сдвигом, даты всех звонков будут отличаться на 3 часа. Поэтому при вводе в эксплуатацию обязательно сверьте время контрольного звонка с личным кабинетом (см. Шаг 7. Проверочный звонок).
Эксплуатация
Интеграция рассчитана на один экземпляр микросервиса
ecos-integrations: порядок уведомлений обеспечивается единственным обработчиком очереди уведомлений. Если маршрут запущен в нескольких экземплярах, порядок обработки уведомлений одного звонка не гарантируется, и уведомления о записи будут чаще отбрасываться. Если требуется несколько экземпляров, согласуйте конфигурацию с поддержкой Citeck.Соединение с брокером RabbitMQ по TLS не поддерживается.
Очереди недоставленных разбираются вручную (см. Восстановление из очереди недоставленных).
Не входят в интеграцию обработка исходящих звонков и управление звонками из Citeck (обратный звонок, запуск записи). Возможные направления развития перечислены в статье Звонки из MANGO OFFICE в CRM.