Ограничения

Какие звонки попадают в 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_timeout RabbitMQ, брокер может закрыть канал и вернуть неподтверждённое сообщение. Для длинных аудиозаписей согласуйте тайм-аут с максимальным временем обработки. Паузы в 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.