Агрегатор мессенджеров 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 необходимо использовать следующие атрибуты:

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

Контакты

Name	Type
chat2desk:telegram	string
chat2desk:whatsapp	string
chat2desk:viber	string

Подписки

Name	Type
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": "[e-mail]",
            "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": "[e-mail]",
                    "type" : "email"
                },
                {
                    "value" : "viber_id",
                    "type" : "chat2desk",
                    "subtype" : "viber"
                }
            ]
        }
    }
}

Инструкция по работе с интеграцией Chat2Desk

Порядок действий пользователя при работе с функциональностью интеграции Smart Communications с Chat2Desk:

1. Импортировать в модуль Smart Communications идентификаторы аккаунтов клиентов в Chat2Desk по каждому мессенджеру.
2. Импортировать в модуль Smart Communications статусы подписки клиентов на мессенджеры.

• Статус подписки можно менять в Профиле клиента.
• Статус подписки действует не только на мессенджер в Chat2Desk, а глобально на данный мессенджер.

1. Импортировать в модуль Smart Communications приоритетный мессенджер для каждого клиента (необязательное действие).
2. Создать кампанию с необходимым триггером и фильтрами. В качестве действия отправки сообщения задается действие Чат (доступно при подключении функциональности). В результате:

• Действие отправляет сообщения в указанный в настройках мессенджер.

• Действие отправляет сообщения тем клиентам, у которых есть идентификатор соответствующего мессенджера и подписка на него.

• Приоритетный мессенджер не учитывается в действии, но задать его можно в условиях сегментации соответствующим одноименным фильтром.

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

Также для построения триггерного сценария коммуникаций (кампании) можно использовать триггер Произошло событие, в который была добавлена возможность фильтрации, аналогичная фильтрам в Построителе сегментов — выбор событий по значению произвольных полей из контекста.

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

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

Код поля должен быть таким же, каким будет имя поля в контексте события. Вложенные поля следует указывать через точку, например: data.order.status.

В фильтре в триггере появится список пользовательских полей с группировкой по справочнику. Операторы поддерживаются все, кроме "из указанных" и "не из указанных".

При отправке сообщений модуль Smart Communications фиксирует на стороне бэкенда идентификаторы запроса и созданного в Chat2Desk сообщения. Чеки атрибутируются по событию отправки. Атрибуция работает здесь по тому же принципу, что и при отправке в чат с ботом.