Агрегатор мессенджеров Chat2Desk
Возможности, которые дает интеграция:
Интеграция Smart Communications с Chat2Desk обеспечивает:
построение коммуникаций с клиентами и получение истории участия в рассылках;
построение отчетности по каналу коммуникаций Chat2Desk.
В Профиле клиента отображается следующая информация:
Внутренний идентификатор мессенджера. Доступные значения:
WhatsApp Id,
Telegram Id,
Viber Id,
и др. мессенджеры.
Статус подписки на канал коммуникации. Доступные значения:
Whatsapp подписка,
Telegram подписка,
Viber подписка,
и др.
Приоритетный мессенджер — канал, который указан в качестве приоритетного, и передается в Smart Communications.
Клиентские события — события закрытия диалога с оператором. Эти события следует передавать в Smart Communications API, т. к. модуль не получает их из Chat2Desk.
В разделе Все клиенты доступна фильтрация списка клиентов по:
виду мессенджера,
наличию подписки на канал коммуникации.
Информация об истории взаимодействия с чат-центром Chat2Desk может быть использована при настройке сегментов и коммуникации с клиентами:
фильтрация в Построителе сегментов:
по наличию внутреннего идентификатора (id) мессенджера,
по приоритетному мессенджеру.
В типовую отчетность по кампании добавлена информация об эффективности канала коммуникаций Chat2Desk (статусы Отправлено, Доставлено) без детализации по виду мессенджера.
Методы API для передачи в Smart Communications данных по клиентам
1. При передаче данных через REST API необходимо использовать следующие атрибуты:
Значения новых полей передаются таким же образом, как и другие атрибуты клиента.
Контакты
chat2desk:telegram
string
chat2desk:whatsapp
string
chat2desk:viber
string
Подписки
subscribe_messenger:telegram
boolean
subscribe_messenger:whatsapp
boolean
subscribe_messenger:viber
boolean
Приоритетный мессенджер (тип данных string):
priority_messenger. Допустима передача любых значений. В Построителе сегментов будут отображаться только те значения, которые указаны в настройках поля. Для корректной работы фильтров рекомендуется в значении передавать один из следующих вариантов:
telegram
whatsapp
viber
Пример запроса при регистрации нового клиента либо при изменении клиента:
POST https://api.loymaxsc.net/customer
{
"data": {
"attributes": {
"local_id": "724",
"full_name": "Тестовый клиент",
"email": "[email protected]",
"register_date": "2017-06-12 16:57:52",
"chat2desk:telegram": "tg_id",
"chat2desk:whatsapp": "wa_id",
"chat2desk:viber": "viber_id",
"subscribe_messenger:telegram": "Y",
"subscribe_messenger:whatsapp": "Y",
"subscribe_messenger:viber": "Y",
"subscribe_messenger:avito": "Y",
"priority_messenger": "telegram",
}
}
}Также возможна передача отдельно контактов и подписок. В запросах на передачу контактов необязательно передавать все контакты или все подписки. Допустима передача, например, только контакта и подписки на Telegram.
Пример передачи статусов подписки на каналы:
POST https://api.loymaxsc.net/customer/:id/channel
{
"data": {
"attributes": {
"email" : "N",
"messenger:telegram" : "N",
"messenger:viber" : "N"
}
}
}Пример передачи контактов:
POST https://api.loymaxsc.net/customer/:id/contact
{
"data": {
"attributes": {
"contacts" : [
{
"value": "[email protected]",
"type" : "email"
},
{
"value" : "viber_id",
"type" : "chat2desk",
"subtype" : "viber"
}
]
}
}
}Инструкция по работе с интеграцией Chat2Desk
Порядок действий пользователя при работе с функциональностью интеграции Smart Communications с Chat2Desk:
Импортировать в модуль Smart Communications идентификаторы аккаунтов клиентов в Chat2Desk по каждому мессенджеру.
Импортировать в модуль Smart Communications статусы подписки клиентов на мессенджеры.
Статус подписки можно менять в Профиле клиента.
Статус подписки действует не только на мессенджер в Chat2Desk, а глобально на данный мессенджер.
Импортировать в модуль Smart Communications приоритетный мессенджер для каждого клиента (необязательное действие).
Создать кампанию с необходимым триггером и фильтрами. В качестве действия отправки сообщения задается действие Чат (доступно при подключении функциональности). В результате:
Действие отправляет сообщения в указанный в настройках мессенджер.
Действие отправляет сообщения тем клиентам, у которых есть идентификатор соответствующего мессенджера и подписка на него.
Приоритетный мессенджер не учитывается в действии, но задать его можно в условиях сегментации соответствующим одноименным фильтром.
Если в настройках указана категория рассылки, то также учитывается подписка на соответствующую категорию.
Если необходимо отправлять сообщения в несколько мессенджеров, нужно использовать несколько действий или отдельные кампании.
Также для построения триггерного сценария коммуникаций (кампании) можно использовать триггер Произошло событие, в который была добавлена возможность фильтрации, аналогичная фильтрам в Построителе сегментов — выбор событий по значению произвольных полей из контекста.
Для построения такого сценария необходимо в разделе Настройки > Справочники завести поля, по которым предполагается фильтровать, указав их типы и операторы для фильтра.
Код поля должен быть таким же, каким будет имя поля в контексте события. Вложенные поля следует указывать через точку, например: data.order.status.
В фильтре в триггере появится список пользовательских полей с группировкой по справочнику. Операторы поддерживаются все, кроме "из указанных" и "не из указанных".
При отправке сообщений модуль Smart Communications фиксирует на стороне бэкенда идентификаторы запроса и созданного в Chat2Desk сообщения. Чеки атрибутируются по событию отправки. Атрибуция работает здесь по тому же принципу, что и при отправке в чат с ботом.
Last updated