MANGO OFFICE

Как подключить сервис

Для подключения Mango к Salebot необходимо получить Api-ключ интеграции и API salt для генерации подписи. Для этого следует зайти в личный кабинет -> интеграции и внизу страницы выбрать Api- коннектор:

После подключения услуги появятся необходимые данные: Уникальный код вашей АТС - mango_Api_key(например, 2jhj35hjkbv225nlklmbnv2) Ключ для создания подписи - mango_Api_salt(например, fds9sdgg4sdgsg2456sgsg8)

Эти данные требуется ввести в окне подключения MANGO OFFICE в Salebot - Телефония:

Сервис Mango Office подключен!

Настройка групп и сотрудников в MANGO OFFICE

Однако для успешной работы с телефонией нам понадобится информация о сотрудниках и группах. В главном меню выберите раздел “Сотрудники” и создайте работника, присвоив в графе “внутренний номер” значение номера. В примере - 219.

Повторяем процедуру для всех сотрудников компании.

Если Вам понадобится работа с групповыми звонками, тогда следует перейти в подраздел “группы”, где необходимо настроить группу, заполнив все поля и присвоив ей уникальный номер(в примере “12345”)

Как происходит сопоставление данных клиента

Для работы с телефонией используются номера в формате 71234567890 (должен начинаться с 7 (или с иного кода другой страны, например, 375), состоять из 11 и более цифр и не иметь лишних знаков и отступов). Последовательность сопоставления данных о клиенте: 1. Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом. 2.Если клиент не найден среди клиентов Телефонии и: - к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона. - к проекту не подключены иные виды мессенджеров (Whatsapp, Viber, Instagram и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет.

Функция Salebot звонок на номер сотрудника

Для того, чтобы совершить звонок сотруднику из бота, необходимо использовать функцию mango_employee_call(short_employee_number, client_phone), которая принимает на вход следующие параметры: short_employee_number - короткий номер сотрудника в системе Mango, строка, пример - ‘219’ client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'.

Пример реализации функции в боте:

Функция звонок группе сотрудников в Salebot

Для того чтобы совершить звонок группе сотрудников, необходимо использовать функцию mango_group_call(group_number, line_number, client_phone), которая принимает на вход следующие параметры: group_number - номер группы в системе Mango, строка, пример - ‘12345’ line_number - виртуальный номер, который будет использован для переадресации звонков внутри группы, строка. Пример - ‘74992262961’ client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'

Пример реализации функции в боте:

Настройка звонков из карточки клиента

Для настройки возможности осуществлять звонки непосредственно из карточки клиента введите сотрудников в систему Salebot. После регистрации сотрудника зайдите в редактирование его данных.

В позиции “Способ совершения телефонных звонков” выберите звонки по API Mango. - Если выбрать пункт Отключить звонки, то этот сотрудник не сможет совершать звонки и иконка телефона возле номеров телефона у него не будет отображаться. - Звонки через приложение - при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier и тд). - Звонки по API Mango - при клике на иконку телефона АТС звонок поступит сначала сотруднику, чей id вы указали в карточке, а затем перенаправляет звонок клиенту.

После выбора способа совершения телефонных звонков в “Звонки по API Mango” появится дополнительное поле, в которое следует вписать короткий номер Вашего сотрудника в системе Mango.

Для осуществления звонка выбранным методом достаточно в карточке клиента нажать на иконку голубой телефонной трубки рядом с его номером телефона:

Настройка вебхуков

Для того чтобы настроить получение колбеков о статусе завершения звонка, необходимо в системе Mango перейти в “Интеграции”-”Api-коннектор”, далее в разделе “Внешние системы” в поле “Адрес внешней системы” пропишите адрес вида: https://chatter.salebot.pro/mango_webhook/<апи-ключ>, например, https://chatter.salebot.pro/mango_webhook/2jhj35hjkbv225nlklmbnv2

В результате при завершении звонков в Salebot будет приходить уведомление следующего вида:

В системе используются множество статусов, обозначающих различные условия завершения звонка. При его наличии код будет присылаться в колбеке.

Список кодов результатов

Ниже приведен список кодов результатов выполнения команд или запросов, завершения вызовов, записей разговоров. В каждом конкретном случае возможно некоторое подмножество результатов. Все коды разделены на классы и подклассы. Например, если внешняя система получает код 2219, то она должна его интерпретировать как 2210 (класс 221х) "Доступ ограничен периодом использования", если 1090 — 1000 (класс 1ххх) "Действие успешно выполнено"

Код Описание

1000 -> Действие успешно выполнено 1100 -> Вызов завершен в нормальном режиме 1110 -> Вызов завершен вызывающим абонентом 1111 -> Вызов не получил ответа в течение времени ожидания 1120 -> Вызов завершен вызываемым абонентом 1121 -> Получен ответ "занято" от удаленной стороны 1122 -> Вызов отклонен вызываемым абонентом 1123 -> Получен сигнал "не беспокоить" 1124 -> Вызов завершен по причине недоступности сотрудника 1130 -> Ограничения для вызываемого номера 1131 -> Вызываемый номер недоступен 1132 -> Вызываемый номер не обслуживается 1133 -> Вызываемый номер не существует 1134 -> Превышено максимальное число переадресаций 1140 -> Вызовы на регион запрещены настройками ВАТС 1150 -> Ограничения для вызывающего номера 1151 -> Вызывающий номер в «черном» списке 1152 -> Вызывающий номер не найден в «белом» списке 1160 -> Вызов на группу не удался 1161 -> Удержание запрещено настройками ВАТС 1162 -> Очередь удержания заполнена 1163 -> Превышено время ожидания в очереди удержания 1164 -> Все операторы в данный момент недоступны 1170 -> Вызов завершен согласно схеме переадресации 1171 -> Неверно настроена схема переадресации 1180 -> Вызов завершен командой пользователя 1181 -> Вызов завершен по команде из внешней системы 1182 -> Вызов завершен перехватом на другого оператора (только для исходящих плеч) 1183 -> Назначен новый оператор (при команде ApiConnect, обычно при переводах) 1190 -> Вызываемый номер неактивен либо нерабочее расписание 1191 -> Вызываемый номер неактивен (снят флажок активности ЛК) 1192 -> Вызываемый номер неактивен по расписанию

Ниже последуют коды нераспространенных ошибок

1200 -> Ошибка сессий КЦ 1201 -> Достигнут лимит подключений 1202 -> Данные сессии не найдены 1210 -> Сервер КЦ не может принять подключение 1211 -> Режим обслуживания 1212 -> Сервер отключен от БД (БРТ) 1230 -> Завершение сессии КЦ по независимым от пользователя причинам 1231 -> Перезагрузка сервера КЦ 1232 -> Сессия завершена администратором 1233 -> Сессия завершена администратором, рекомендовано восстановление 1234 -> Сессия завершена администратором, рекомендовано оставаться в оффлайн 1235 -> Сервер отключился от БД (переход в БРТ) 1236 -> Изменены критичные данные сессии (логин, пароль, номер телефона, и т.д.) 2000 -> Ограничение биллинговой системы 2100 -> Доступ к счету невозможен 2110 -> Счет заблокирован 2120 -> Счет закрыт 2130 -> Счет не обслуживается (frozen) 2140 -> Счет недействителен 2200 -> Доступ к счету ограничен 2210 -> Доступ ограничен периодом использования 2211 -> Достигнут дневной лимит использования услуги 2212 -> Достигнут месячный лимит использования услуги 2220 -> Количество одновременных вызовов/действий ограничено 2230 -> Услуга недоступна 2240 -> Недостаточно средств на счете 2250 -> Ограничение на количество использований услуги в биллинге 2300 -> Направление заблокировано 2400 -> Ошибка биллинга 3000 -> Неверный запрос 3100 -> Переданы неверные параметры команды 3101 -> Запрос выполнен по методу, отличному от POST 3102 -> Значение ключа не соответствуют рассчитанному 3103 -> В запросе отсутствует обязательный параметр 3104 -> Параметр передан в неправильном формате 3105 -> Неверный ключ доступа 3200 -> Неверно указан номер абонента 3300 -> Объект не существует 3310 -> Вызов не найден 3320 -> Запись разговора не найдена 3330 -> Номер не найден у ВАТС или сотрудника 3340 -> Файл не найден 4000 -> Действие не может быть выполнено 4001 -> Команда не поддерживается 4002 -> Продолжительность записи меньше минимально возможной в ВАТС, запись не будет сохранена 4100 -> Выполнить команду по логике работы ВАТС невозможно 4101 -> Вызов завершен либо не существует 4102 -> Запись разговора уже осуществляется 4200 -> Связаться с абонентом в данный момент невозможно 4300 -> SMS сообщение отправить не удалось 4301 -> SMS сообщение устарело 4391 -> SMS сообщение утеряно (статус возвращает внешний оператор) 4392 -> SMS сообщение отклонено (статус возвращает внешний оператор) 4393 -> SMS сообщение отменено (статус возвращает внешний оператор) 4400 -> Невозможно добавить участника в конференцию 4401 -> Аппаратная ошибка 4402 -> Сервис не доступен 4403 -> Недостаточно ресурсов 4404 -> Превышено ограничение на количество участников конференции 4405 -> Подключение запрещено настройками комнаты конференций 4500 -> Ограничения системы безопасности 4501 -> Установлено ограничение частоты звонков 4502 -> Вызывающий номер в черном списке входящих номеров 4503 -> Превышен максимальный размер файла 4504 -> Не удалось определить размер файла 4505 -> Формат файла не соответствует разрешенному 5000 -> Ошибка сервера 5001 -> Перезапуск коммутатора, выполняется при срабатывании какого-либо ограничения канала или уровня на коммутаторе. 5002 -> Перезапуск коммутатора по команде администратора / разработчика 5003 -> Технические проблемы, внутренняя ошибка на коммутаторе 5004 -> Проблемы доступа к базе данных коммутатора: не удалось подключиться к базе данных или в результате обработки запроса на манипуляцию с данными (чтение/вставка/удаление/ и так далее) в базе данных выдано сообщение об ошибке. 5007 -> Во сторонней системе, связанной с коммутатором, выдано сообщение о внутренней ошибке. Сторонняя система не доступна коммутатору. 5101 -> Нет продукта ЦОВ/ Контакт центр 5102 -> Превышен лимит активных кампаний 5103 -> Превышен лимит кампаний 5105 -> Указанный при создании кампании "abonent_id" в поле "created by" не существует 5106 Не удалось вставить задания из-за неподходящего статуса кампании 5107 -> Количество заданий для кампании превышает допустимое значение (10 000) 5212 -> Нет активных номеров. Укажите хотя бы один номер 6000 -> Доставка факса не выполнялась 6010 -> Технические проблемы сервиса факс-рассылок 6011 -> Указанный в задании на рассылку номер недоступен в течение часа 6012 -> Указанный в задании на рассылку номер не существует 6013 -> На указанном номере не установлен факс-аппарат 6014 -> Адресат отказался принимать факс 6100 -> Ошибка при преобразовании факса 6101 -> Превышен допустимый размер исходного файла (10 мегабайт) 6102 -> Превышено допустимое число страниц (30)