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 подключен!
Однако, помимо этого, для успешной работы с телефонией нам понадобится информация о сотрудниках и группах. В главном меню выберите раздел “Сотрудники” и создайте работника, присвоив в графе “внутренний номер” значение номера. В примере - 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 и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет.
Для того, чтобы совершить звонок сотруднику из бота, необходимо использовать функцию mango_employee_call(short_employee_number, client_phone),
которая принимает на вход следу ющие параметры:
short_employee_number - короткий номер сотрудника в системе Mango, строка, пример - ‘219’
client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'.
Пример реализации функции в боте:
Для того, чтобы совершить звонок группе сотрудников, необходимо использовать функцию 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