МойСклад: интеграция в старом ЛК UIS
Функциональность интеграции с CRM МойСклад
- открытие карточки клиента при:
- входящем звонке;
- исходящем звонке;
- переадресации (трансфере) от другого сотрудника
- исходящий звонок из онлайн-сервиса МойСклад
- история звонков
- прослушивание записей звонков из интерфейса онлайн-сервиса МойСклад;
- дополнительная информация в истории звонка:
- звонок с CRM — исходящий из CRM
- обратный звонок — звонок, заказанный через форму обратного звонка
- звонок через пин-код
- аналитика
- звонок с ВАТС
- звонок с SIP линии
- нет сотрудников для обзвона — пропущенный входящий, в котором не было переадресации на сотрудников (сценарий обработки не предполагает переадресации на сотрудников или система не нашла активного сценария для обработки звонка)
- целевое событие
- офлайн заявка
- чат
Подключение и настройка интеграции
Интеграция доступна только при использовании SIP-телефонии.
В Личном кабинете UIS войдите в раздел Тарифы и опции, разверните Все опции:
И подключите API «Базовые отраслевые решения»:
Для того, чтобы UIS и МойСклад могли обмениваться данными, необходимо внести IP-адрес 195.211.122.131 в белый список UIS и создать авторизационный ключ API.
Перейдите в раздел Аккаунт — Правила и настройки безопасности — вкладка API добавьте 195.211.122.131 в белый список:
195.211.122.131
Чтобы получить авторизационный ключ API, в аккаунте UIS войдите в Управление пользователями и разрешите одному из пользователей (например, Администратору) доступ к API по ключу. Обязательно скопируйте и сохраните ключ — он показывается только один раз, при создании, и понадобится для дальнейшей настройки
Настройка сотрудников
Сотрудники не копируются автоматически из одного сервиса в другой. Это значит, что сотрудники должны быть созданы вручную и в личном кабинете UIS, и в сервисе МойСклад. Звонки, принятые или совершенные не синхронизированными сотрудниками, не будут переданы в МойСклад.
В личном кабинете UIS перейдите в раздел Сервисы и статистика
Перейдите в раздел Сотрудники и выберите из списка нужного сотрудника:
Укажите внутренний номер сотрудника. Он понадобится в настройках сервиса МойСклад:
Авторизуйтесь с помощью ключа API, полученного в личном кабинете UIS.
После успешной авторизации вы увидите настройки:
Скопируйте значение из поля URL адрес для Phone API МойСклад.
Важно:
не закрывайте это окно, оно понадобится для дальнейшей настройки.
В другой вкладке браузера откройте онлайн-сервис МойСклад.
Для того чтобы успешно взаимодействовать с Phone API онлайн-сервиса МойСклад, необходимо подключить данный модуль.
- Перейдите в раздел Приложения
- Нажмите Выбрать приложение
В открывшемся разделе найдите ниже Звонки — UIS и нажмите Установить
В появившемся окне настроек:
- В поле Адрес провайдера телефонии вставьте скопированный текст.
- Скопируйте ключ из поля Ключ доступа.
- Введите номера добавочных для сотрудников, соответствующих с добавочными в Личном кабинете UIS.
Перейдите обратно на вкладку с настройками интеграции и введите скопированный ключ в поле Ключ доступа к Phone API — МойСклад и нажмите сохранить:
Если по каким либо причинам ключ не верный, то вы увидите текст на кнопке «Не сохранено» и включение интеграции будет не доступно:
При успешной интеграции вы сможете включить ее.
Настройка уведомлений для передачи данных
Чтобы данные из UIS передавались в онлайн-сервис МойСклад, необходимо настроить четыре типа HTTP-уведомлений о событиях.
Перейдите в раздел Сервисы и статистика — Уведомления и кликните Добавить
Необходимо настроить четыре вида уведомлений:
1) Название уведомления: Ожидание ответа (МойСклад)
Тип события: Ожидание ответа
Способ уведомления: HTTP
Метод: POST
URL: http://custom.uiscom.ru/moysklad/api/webhook/
В тело уведомления вставьте текст:
{
"app_id":{{app_id}},
"action":"wait",
"is_transferred":{{is_transferred}},
"employee_phone_number":{{employee_phone_number}},
"externalId":{{call_session_id}},
"number":{{contact_phone_number}},
"extension":{{extension_phone_number}},
"isIncoming":{{direction}},
"startTime":{{start_time}},
"call_source":{{call_source}},
"communication_type":{{communication_type}},
"virtual_phone_number":{{virtual_phone_number}},
"leg_id":{{leg_id}}
}2) Название уведомления: Завершение звонка (МойСклад)
Тип события: Завершение звонка
Способ уведомления: HTTP
Метод: POST
URL: http://custom.uiscom.ru/moysklad/api/webhook/
В тело уведомления вставьте текст:
{
"app_id": {{app_id}},
"direction":{{direction}},
"action":"disconnect",
"is_lost":{{is_lost}},
"lost_reason":{{lost_reason}},
"externalId": {{call_session_id}},
"endTime":{{finish_time}},
"extension":{{extension_phone_number}},
"duration": {{talk_time_duration}},
"recordUrl": {{record_file_links}},
"call_source":{{call_source}},
"communication_type":{{communication_type}},
"noanswered_employee_full_names":{{noanswered_employee_full_names}},
"virtual_phone_number":{{virtual_phone_number}},
"contact_phone_number":{{contact_phone_number}}
}3) Название уведомления: Завершение плеча (МойСклад)
Тип события: Завершение плеча
Способ уведомления: HTTP
Метод: POST
URL: http://custom.uiscom.ru/moysklad/api/webhook/
В тело уведомления вставьте текст:
{
"app_id": {{app_id}},
"action":"hung_up",
"externalId": {{call_session_id}},
"extension":{{extension_phone_number}},
"virtual_phone_number":{{virtual_phone_number}}
}4) Название уведомления: Начало разговора (МойСклад)
Тип события: Начало разговора
Способ уведомления: HTTP
Метод: POST
URL: http://custom.uiscom.ru/moysklad/api/webhook/
В тело уведомления вставьте текст:
{
"app_id": {{app_id}},
"action":"connect",
"direction":{{direction}},
"externalId": {{call_session_id}},
"extension":{{extension_phone_number}},
"virtual_phone_number":{{virtual_phone_number}}
}Настройка интеграции завершена.
