Salebot.pro
Search…
⌃K

MANGO OFFICE

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

Для подключения Mango к Salebot необходимо получить Api ключ интеграции и API salt для генерации подписи. Для этого следует зайти в личный кабинет - интеграции и внизу страницы выбрать Api- коннектор:
Личный кабинет Mango Office
После подключения услуги появятся необходимые данные: Уникальный код вашей АТС - mango_Api_key(например, 2jhj35hjkbv225nlklmbnv2) Ключ для создания подписи - mango_Api_salt(например, fds9sdgg4sdgsg2456sgsg8)
Подключение API Connector
Эти данные требуется ввести в окне подключения MANGO OFFICE в Salebot - Телефония:
Salebot - Телефония
Окно подключения MANGO
Сервис Mango Office подключен!

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

Однако, помимо этого, для успешной работы с телефонией нам понадобится информация о сотрудниках и группах. В главном меню выберите раздел “Сотрудники” и создайте работника, присвоив в графе “внутренний номер” значение номера. В примере - 219.
Настройка телефонии Mango Office
Настройка телефонии Mango Office - раздел Сотрудники
Настройка телефонии Mango Office - Карточка сотрудника
Повторяем процедуру для всех сотрудников компании.
Если Вам понадобится работа с групповыми звонками, тогда следует перейти в подраздел “группы”, где настроить группу, заполнив все поля и присвоив ей уникальный номер(в примере “12345”)
Настройка телефонии Mango Office - раздел Группы
Настройка телефонии Mango Office - Создание группы
Настройка телефонии Mango Office - настройка группы

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

Для работы с телефонией используются номера в формате 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'
Пример реализации функции в боте:
ВНИМАНИЕ! Тщательно проверьте настройки групповых звонков в MANGO! При неправильных настройках дозвона можно заспамить клиента вызовами!

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

Для настройки возможности осуществлять звонки непосредственно из карточки клиента введите сотрудников в систему 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)
Last modified 7mo ago