Агрегатор мессенджеров Chat2Desk

Возможности, которые дает интеграция:

Интеграция Smart Communications с Chat2Desk обеспечивает:

  • построение коммуникаций с клиентами и получение истории участия в рассылках;

  • построение отчетности по каналу коммуникаций Chat2Desk.

В Профиле клиента отображается следующая информация:

  • Внутренний идентификатор мессенджера. Доступные значения:

    • WhatsApp Id,

    • Telegram Id,

    • Viber Id,

    • и др. мессенджеры.

  • Статус подписки на канал коммуникации. Доступные значения:

    • Whatsapp подписка,

    • Telegram подписка,

    • Viber подписка,

    • и др.

  • Приоритетный мессенджер — канал, который указан в качестве приоритетного, и передается в Smart Communications.

  • Клиентские события — события закрытия диалога с оператором. Эти события следует передавать в Smart Communications API, т. к. модуль не получает их из Chat2Desk.

Список мессенджеров может быть свой у каждого Партнера.

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

  • виду мессенджера,

  • наличию подписки на канал коммуникации.

Информация об истории взаимодействия с чат-центром Chat2Desk может быть использована при настройке сегментов и коммуникации с клиентами:

В типовую отчетность по кампании добавлена информация об эффективности канала коммуникаций Chat2Desk (статусы Отправлено, Доставлено) без детализации по виду мессенджера.

Методы API для передачи в Smart Communications данных по клиентам

1. При передаче данных через REST API необходимо использовать следующие атрибуты:

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

Контакты

Подписки

Приоритетный мессенджер (тип данных string):

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

    • telegram

    • whatsapp

    • viber

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

Пример запроса при регистрации нового клиента либо при изменении клиента:

POST https://api.loymaxsc.net/customer
{
    "data": {
        "attributes": {
            "local_id": "724",
            "full_name": "Тестовый клиент",
            "email": "mail2@example.com",
            "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": "some@one.com",
                    "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 сообщения. Чеки атрибутируются по событию отправки. Атрибуция работает здесь по тому же принципу, что и при отправке в чат с ботом.

Last updated