Диалоги (чаты) с клиентами

Функционал "Диалоги" в SPSM позволяет интегрировать в программу чаты с клиентами в различных мессенджерах через API от сторонних компаний (агрегаторов мессенджеров), предоставляющих такой сервис (например ChatApp или Pact).

Это ускоряет и упрощает переписку с клиентами - окно диалогов вызывается из программы напрямую, пользователям не надо открывать окно браузера и вводить имя и пароль или запускать стороннюю программу. 

В программе предусмотрено два места, откуда диалоги с клиентами могут быть открыты.

Кнопка "Диалоги" в правом нижнем углу окна списка заказов. Эта кнопка открывает окно со всеми чатами данного пользователя:

Меню "Диалоги с клиентом" по правой кнопке мыши над списком заказов в окне списка заказов. Из этого меню открывается окно чата с конкретным клиентом :

Данный функционал доступен только в полной версии SPSM.

Начало работы с чатами

По-умолчанию данный функционал отключён.

Для начала работы требуется разрешить показ кнопки и меню в Общих Настройках -> Диалоги. 

Далее в настройках следует выбрать конфигурационный файл, включающий настройки вашего агрегатора.  В программу включены два файла настроек, для двух агрегаторов - ChatAPI.online.config.json для агрегатора ChatApp и Pact.im.config.json для агрегатора Pact. 

Если указано только имя файла - программа будет искать этот файл в папке \Tools в своей домашней папке. В случае выбора конфигурационного файла, отличного от двух поставляемых с программой или если вы вносили изменения в эти файлы необходимо хранить этот файл вне домашней папки программы и указывать полный путь. Файлы, поставляемые с программой, будут обновлены при установке обновлений и ваши изменения будут потеряны.

После этого требуется выбрать какие группы пользователей будут иметь доступ к этой функции. 

Вне зависимости от выбора групп пользователей этот функционал не будет доступен в окне списка заказов на производстве.

Далее требуется ввести информацию в свойствах пользователей и клиентов.

В свойствах пользователей и клиентов есть пять полей, "Данные №1 для диалогов" -  "Данные №5 для диалогов". Информация из этих полей и номера телефонов пользователей будут переданы в API агрегаторов. 

Требуемая информация будет зависеть от выбранного агрегатора. Ниже приведены примеры для двух агрегаторов. 

Обратитесь в службу поддержки если вам требуется помощь с настройкой для вашего агрегатора.

Данные требуемые для работы с ChatApp

Для пользователей требуется ввести следующее:

• Поле "Данные №1 для диалогов" - пароль пользователя в ChatApp 
• Поле "Данные №2 для диалогов" - Application ID пользователя в ChatApp, в виде app_NNNNN_N. Это значение нужно получить в личном кабинете пользователя в ChatApp - выбрать раздел "Автоматизация", затем "Разработчикам". Если раздел пуст - необходимо добавить запись. 

Ввод данных в поля "Данные №3 для диалогов"  - "Данные №5 для диалогов" не требуется.  

Для клиентов ввод дополнительной информации не требуется, но требуется убедится что у клиента введён номер мобильного телефона.

Данные требуемые для работы с Pact

Для пользователей требуется ввести следующее:

• Поле "Данные №1 для диалогов" - Ключ доступа (он же Private Api Token) вашей компании. Он доступен главному пользователю в настройках аккаунта.  
• Поле "Данные №2 для диалогов"  - external_uuid вашей компании. Для его получения требуется сделать запрос в службу поддержки Pact или получить его самостоятельно используя ключ доступа и запрос через curl такого вида: 
• curl "https://api.pact.im/p1/companies" -H "X-Private-Api-Token: <ваш ключ>"
• Поле "Данные №3 для диалогов" - номер (ID) вашего сотрудника в системе Pact. Для его получения требуется сделать запрос в службу поддержки Pact.

Ввод данных в поля "Данные №4 для диалогов" и "Данные №5 для диалогов" не требуется. 

Для клиентов ввод требуется ввести следующее.

• Поле "Данные №1 для диалогов" - тип мессенджера клиента. Для Telegram требуется ввести telegram_personal, для Max - max.

Ввод данных в поля "Данные №2 для диалогов"  - "Данные №5 для диалогов" не требуется. 

Требуется убедится что у клиента введён номер мобильного телефона. 

Настройки для работы с другими агрегаторами

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

При самостоятельной настройке используйте оба поставляемых конфигурационных файла как образцы.

Один из них настроен на работу с API с использованием токена доступа (ChatApp), другой - с использованием хэша данных как ключа доступа (Pact).

Проблемы с диалогами и способы решения 

Если после установки всех настроек и заполнения полей данных у вас показывается белое (пустое) окно вместо чата с клиентом то проблема скорее всего в отсутствии на компьютере браузера Edge или библиотек WebView2 Runtime от Mircosoft. WebView2 Runtime можно скачать на сайте Microsoft.

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

Дополнительно, информация выводится в лог файл C:\ProgramData\Sevit\SPSM8\Logs\SPSM_Dialogs_Log.txt