Клиентикс CRM: интеграция с мессенджерами

В интерфейсе Клиентикс CRM можно переписываться с клиентами в каналах WhatsApp и Telegram, подключенных в Личном кабинете UIS.

• Уведомление и открытие карточки клиента при входящем сообщении.
• Отправка исходящих сообщений в WhatsApp и Telegram по заранее заданным событиям (триггерные рассылки).
• Рассылки в WhatsApp для выбранных групп клиентов с возможностью кастомизации. Для обхода потенциальной блокировки WhatsApp между отправкой сообщений предусмотрена пауза в 8 секунд.
• Возможность просматривать все действия с клиентом в одном окне, а также видеть историю сообщений, писать сообщения, создавать задачи и заметки в «Ленте событий».

Особенности работы:

• В рамках одного канала WhatsApp или Telegram можно подключить интеграцию только с одним аккаунтом. По умолчанию это тот аккаунт, который был раньше всех добавлен в Личном кабинете UIS. Если вы хотите интегрировать с Клиентикс CRM другой аккаунт, в Личном кабинете UIS нужно удалить все подключенные аккаунты, затем в первую очередь подключить тот аккаунт, с которым нужна интеграция, а затем все остальные.
• При входящем сообщении от клиента, контактов которого нет в аккаунте Клиентикс, будет создаваться новый клиент с номером телефона.
• Для переписки с клиентами можно использовать Рабочее место оператора UIS, но тогда в истории обращений Клиентикс будут отображаться только входящие сообщения. Если вести переписку в «Ленте событий» в интерфейсе Клиентикс, то в истории обращений будут отображаться и входящие, и исходящие сообщения.

В старом Личном кабинете UIS войдите в раздел Тарифы и опции, разверните Все опции:

Подключите опции «Базовые отраслевые решения»:

Если вы еще не подключали WhatsApp и Telegram, подключите опцию «Омни-чаты»:

В рамках одного канала WhatsApp и Telegram можно подключить интеграцию только с одним аккаунтом. Клиентикс CRM по умолчанию синхронизируется с тем аккаунтом, у которого наименьший числовой ID — это тот аккаунт, который был раньше всех добавлен в Личном кабинете UIS.

Если вы хотите интегрировать с Клиентикс CRM другой аккаунт, в Личном кабинете UIS нужно удалить все подключенные аккаунты, затем в первую очередь подключить тот аккаунт, с которым нужна интеграция, а затем все остальные. Важно не просто выключить и включить аккаунты через свитч в настройках, а именно удалить и подключить заново — только так происходит генерация нового ID.

Чтобы UIS и Клиентикс могли обмениваться данными, необходимо внести IP-адрес 0.0.0.0/0 в белый список UIS и создать авторизационный ключ API.

В старом ЛК UIS откройте раздел Аккаунт ⟶ Правила и настройки безопасности ⟶ API и добавьте 0.0.0.0/0 в белый список:

Чтобы получить авторизационный ключ API, войдите в Управление пользователями и разрешите одному из пользователей — например, Администратору — доступ к API по ключу. Обязательно скопируйте и сохраните ключ — он показывается только один раз — при создании, и понадобится для дальнейшей настройки:

Если у вас несколько аккаунтов (баз) Клиентикс CRM, настройка интеграции выполняется для каждого аккаунта отдельно. В аккаунте Клиентикс CRM войдите в раздел Меню ⟶ Настройки:

Включите API:

Откройте административную панель настроек Клиентикс.

В настройку COMPONENT_UIS_OMNI_AUTH_DATA внесите данные для авторизации в формате:

{"login":"username","password":"_password"}

где "username" и "password" — данные для входа в административную учетную запись Личного кабинета UIS.

Далее по необходимости можно изменить настройку, в которой указываются типы сообщений и каналы, через которые они будут отправляться: COMPONENT_CLIENTS_UIS_OMNI_MESSAGE_TYPES_CONFIG.

По умолчанию указаны следующие типы:

{"MESSAGE_TYPE_APPOINTMENT_NOTIFICATION":"whatsapp",
"MESSAGE_TYPE_ONLINE_APPOINTMENT_SUCCESS":"whatsapp",
"MESSAGE_TYPE_ONLINE_APPOINTMENT_GROUP_SUCCESS":"whatsapp",
"MESSAGE_TYPE_QUALITY_ASSURANCE_FORM":"instagram,whatsapp",
"MESSAGE_TYPE_CUSTOM_TRIGGER_SMS":"instagram,whatsapp",
"MESSAGE_TYPE_APPOINTMENT_CONFIRMATION_FORM":"whatsapp",
"MESSAGE_TYPE_APPOINTMENT_CONFIRMATION_FORM_CONFIRM_ARR":"whatsapp",
"custom_event_message":"instagram,whatsapp"}

• Если вы хотите отправлять сообщения через «Ленту событий», добавьте в настройку тип "MESSAGE_TYPE_CUSTOM_MESSAGE":"whatsapp".
• Все сообщения, типы которых были указаны в настройке COMPONENT_CLIENTS_UIS_OMNI_MESSAGE_TYPES_CONFIG, будут сначала отправляться как PUSH-уведомления, а если не доставлены, то как СМС.
• Приоритет каналов для PUSH-уведомлений — OneSignal — Wazzup24 — UIS. То есть, один и тот же тип сообщений можно настраивать только для одного канала PUSH-уведомлений.

При поступлении нового сообщения будет создаваться новое входящее сообщение в чате с типом MESSAGE_TYPE_INCOMING_UIS_OMNI, видимое в истории сообщений клиента и аккаунта в Клиентикс:

А также новое уведомление с типом NOTIFICATION_TYPE_INCOMING_MESSAGE:

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

Для сотрудников, которые будут переписываться с клиентами в WhatsApp и Telegram в интерфейсе Клиентикс CRM, нужно открыть соответствующие права в ЛК UIS.

В разделе Сотрудники откройте редактирование карточки нужного сотрудника ⟶ вкладка Использование сервисов, включите свитч Чаты и заявки:

Не выходя из карточки скопируйте значение параметра recordId из адресной строки, оно понадобится для настройки сотрудника в Клиентикс CRM:

Сохраните изменения в карточке сотрудника и повторите с остальными сотрудниками, которые будут участвовать в обработке чатов.

В Клиентикс откройте панель настройки динамических полей.

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

• Имя поля (техническое:): uis_operator_id
• Название поля: Внутренний номер UIS
• Модель: Сотрудники
• Сценарии: add, edit, editEmployee, editOwner
• Тип поля: Текстовая строка

Перейдите в Клиентикс CRM ⟶ Меню ⟶ Сотрудники:

Откройте карточку первого владельца аккаунта:

Нажмите Редактировать:

В ранее добавленное поле вставьте значение recordId, которое получили на этапе настройки сотрудников в ЛК UIS.

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

В окне «Лента событий» можно работать с обращениями из WhatsApp и Telegram. «Ленту событий» можно открыть прямо в карточке клиента:

Здесь отображаются все действия, связанные с клиентом, кроме взаиморасчетов и задач.

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

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

Вверху страницы отображается счетчик непрочитанных сообщений от клиентов, он обновляется автоматически в реальном времени. Сообщения объединены в цепочки по каждому клиенту. По клику на ФИО откроется карточка клиента, где можно перейти в ленту и продолжить переписку.

Входящие сообщения появляются в виде push-уведомления на экране. Ответить на сообщение клиента можно прямо из push-уведомления, не открывая раздел сообщений.