Как управлять подписчиками чат-бота и их данными
В статье рассмотрим все источники, из которых пользователи могут перейти на чат-бота и стать его подписчиком в Facebook, Telegram, WhatsApp, Instagram, а также все способы добавления и изменения переменных и тегов.
С помощью переменных и тегов вы можете организовать и хранить всю необходимую информацию о подписчике, его заказах и предпочтениях, чтобы персонализировать работу с каждым подписчиком или группой подписчиков по определенным критериям фильтра.
Кто является подписчиком чат-бота
Facebook Messenger
Подписчики бота в Facebook Messenger — это все пользователи, которые взаимодействовали со страницей вашего сообщества в Facebook: нажали «Сообщение» и задали вопрос, подписались через виджет или форму подписки другого сервиса, перешли по ссылке на чат-бота, перешли по рекламе, открыли окно диалога со страницей и начали общение, нажав «Начать».
При переходе из другого сервиса или просто при создании нового бота все подписчики автоматически подтягиваются при подключении страницы. Читайте подробнее: «Как перенести подписчиков чат-бота Facebook из других сервисов в SendPulse». Вы также можете выбрать не импортировать старых подписчиков.
Также обратите внимание, что вы можете писать подписчикам Facebook бота только в течение 24 часов с момента последнего взаимодействия подписчика с ботом. Вне 24 часов вы можете отправить только трансакционный тип рассылки. Читайте подробнее «Типы рассылок Facebook».
Telegram
Подписчики бота для Telegram — это все пользователи, которые подписались через виджет или взаимодействовали с чат-ботом в Telegram: перешли на него по ссылке, подписались и начали диалог, нажав «Start», а также канал или группа со всеми их подписчиками, где вы являетесь администратором и куда добавили своего бота (канал будет отображаться как отдельный контакт в «Аудитории» чат-бота).
При переходе из другого сервиса вы можете импортировать подписчиков, если сервис, от которого вы переходите, позволяет экспортировать Telegram ID подписчиков. Читайте подробнее: «Как перенести подписчиков бота Telegram из других сервисов в SendPulse».
Подписчики бота для WhatsApp — это все пользователи, которые подписались через виджет или взаимодействовали с чат-ботом в WhatsApp, к примеру, кликнули по кнопке или написали в ответ на отправку шаблонного сообщения, перешли на чат-бот по ссылке, перешли по рекламе, подписались и начали диалог.
Вы можете загрузить список телефонных номеров c переменными или настроить интеграцию для отправки шаблонных сообщений. После того как пользователь ответит, в аудитории его статус меняется на «Подписан».
Также обратите внимание, что у WhatsApp действует 24-часовое окно поддержки, в течение которого вы можете отправить любое сообщение. Оно открывается только после взаимодействия с пользователем, например, — нажатия на кнопку или отправки сообщения. До открытия этого окна вы можете отправлять только шаблонные сообщения. Читайте подробнее: «Новые цены и правила тарификации сообщений WhatsApp».
Подписчики бота для Instagram — это все пользователи, которые начали взаимодействовать с чат-ботом через директ вашего бизнес-аккаунта в Instagram.
В Instagram есть следующие триггеры запуска бота.
| Отправка сообщения в директ | Любой пользователь, который напишет вам в директ аккаунта, на который вы подключили чат-бота, становится подписчиком чат-бота. |
| Подписка через виджет | При нажатии на кнопку «Подписаться» в виджете пользователь переходит в директ вашего профиля и должен отправить сообщение, чтобы подписаться. При настройке виджета вы также можете установить предустановленное сообщение для отправки. |
| Переход на чат-бота по ссылке | При переходе по ссылке пользователь должен отправить сообщение, чтобы подписаться. |
| Переход по рекламе | Если вы добавили раздел вопросов после перехода по рекламному сообщению, то вопрос пользователя считается началом диалога и приравнивается к подписке. |
| Упоминание в истории | При упоминании в истории в директ вашего профиля отправляется сообщение от пользователя и он становится подписчиком. |
| Отправка комментария в прямом эфире | Вместе с комментарием в директ вашего профиля приходит сообщение от пользователя и он становится подписчиком. |
| Отправка комментария под публикацией | При этом триггере вы можете отправить только одно сообщение в ответ до следующей реакции пользователя. |
Перенос подписчиков из другого сервиса на данный момент не предусмотрен.
Также обратите внимание, что вы можете писать подписчикам Instagram бота только в течение 24 часов с момента их последнего взаимодействия с ботом.
Viber
Подписчики Viber чат-бот — это пользователи, которые перешли по ссылке или QR-коду на бота и писали вашему боту. Также вы можете загрузить CSV-файл с контактами, которые ранее были подписаны на бот.
Аудитория бота может формироваться с помощью самостоятельных подписок пользователей или импорта контактных данных файлом. Для импорта необходим csv-файл с уникальными viber_id подписчиков.
Подписчики добавляются в аудиторию бота по их ID в Viber, а не по телефону.
Для того чтобы пользователь подписался на бота, он должен перейти по прямой ссылке на него.
Как просмотреть список подписчиков
В аудитории
Чтобы посмотреть данные подписчиков, перейдите во вкладку «Аудитория». В этом разделе отображается список всех пользователей, которые подписались на чат-бота, с указанием тегов, переменных, статуса, даты подписки и времени последней активности.
В колонке «Статус» (Status) можно просмотреть статусы подписчиков.
| Новый (New) (синий цвет) | Контакт загружен в аудиторию, но никаких действий с ним не выполнялось. Статус меняется после первого взаимодействия с контактом. |
| Подписан (Subscribed) (зеленый цвет) | Пользователь сам подписался на чат-бот или была активность контакта после того, как вы его импортировали. Вы можете отправлять сообщения. |
| Отписан (Unubscribed) | Пользователь отписался от чат-бота через команду /stop в боте. |
| Отключил уведомления (Disabled notifications) | Пользователь отписался от бота через мессенджер. |
| Отключен (Disabled) | Вы заблокировали возможность отправлять сообщения подписчику в чат-боте во вкладке «Аудитория». Вы можете включить пользователя обратно. |
| Недействительный (Invalid) | Контакт загружен в аудиторию, но пользователь не установил приложение. |
Чтобы скрыть или показать переменные в аудитории, нажмите на значок справа. Отметьте галочкой переменные, которые отображать, и снимите галочку с тех, которые нужно скрыть.
Через фильтр контактов
Вы можете сузить аудиторию и отфильтровать пользователей по определенным данным. Для этого нажмите «Фильтр» и выберите нужный критерий:
- активность в течение последних 24 часов;
- статус контакта (подписан, отписан, отключен вами или отключил уведомления);
- имя контакта;
- дата регистрации (и выберите дату);
- последняя активность (и выберите дату);
- значение переменной контакта в зависимости от ее типа (строка, число, ссылка, телефон, емейл);
- присвоенный или неназначенный тег;
- была или не была запущена конкретная цепочка;
- получил или не получил конкретную рассылку;
- статус открытости чата;
- количество входящих сообщений;
- количество непрочитанных сообщений.
Для Instagram чат-бота доступны еще дополнительные критерии:
- подписка на ваш профиль в Instagram;
- подписка вами на профиль подписчика в Instagram;
- количество подписчиков профиля.
Вы также можете комбинировать условия фильтра: «любому» (соответствует оператору «или») или «каждому» (соответствует оператору «и»).
Через интеграции
Вы также можете настроить интеграцию и получать данные о подписчиках в своей системе:
- при настройке отправки вебхуков;
- при настройке блока «Запрос API»;
- с помощью API методов «Получить информацию о контакте по ID», «Получить список контактов по тегу» и «Получить список контактов по переменной».
Как управлять переменными
В SendPulse для чат-ботов вы можете использовать следующие виды переменных.
| Глобальные | Используются для общих значений для всех пользователей. Вы можете создать свои переменные в настройках бота и использовать сообщения с предварительно заданными значениями. По умолчанию доступны $bot_name, $bot_id и $current_date (текущая дата). |
| Системные | Значения берутся из системы. Можно вставить текст последнего сообщения подписчика с помощью last_message, добавить ID подписчика с помощью contact_id и ID подписчика в Telegram — telegram_id. |
| Пользовательские | Используются для хранения индивидуальных значений для каждого контакта. Вы можете хранить информацию о пользователе в переменных всех типов: строка, число, ссылка, дата, емейл и телефон. |
В этом разделе подробнее рассмотрим пользовательские переменные.
Вы можете создать переменную в аудитории без значения или добавить переменную сразу со значением, обновить значение в существующей переменной для всех или одного контакта.
Создание переменной
Функционал добавления переменных одинаковый для всех мессенджеров. Переменные создаются для всех контактов в списке «Аудитория».
| Вручную в «Аудитория» | Перейдите во вкладку «Аудитория». Справа нажмите «Создать переменную». Введите имя и тип переменной и нажмите «Создать». Читайте подробнее «Как создать переменную в аудитории чат-бота». |
| Вы можете создать переменную в режиме редактирования цепочки, чтобы в последующем настроить добавление значения переменной каждому контакту, который прошел через этот блок цепочки. | |
| Вручную в цепочке с помощью блока «Сообщение: Ввод пользовательских данных» |
Перейдите в режим редактирования цепочки. Добавьте блок «Сообщение». Активируйте «Ждать ответ подписчика». Возле опции «Сохранить ответ в переменную» нажмите «Создать переменную». Обратите внимание, что в этом блоке вы можете создать переменную только с типом «Строка». |
| Вручную в цепочке с помощью блока «Действие: Установить переменную» | Перейдите в режим редактирования цепочки. Добавьте блок «Действие». Выберите действие «Установить переменную» и нажмите «Создать переменную». Введите имя и тип переменной. |
| Вручную в цепочке с помощью блока «Запрос API» | Перейдите в режим редактирования цепочки. Добавьте блок «Запрос API». Введите данные запроса и нажмите «Проверить запрос». Возле опции «Поле ответа» нажмите «Создать переменную». Введите имя и тип переменной. |
Редактирование названия переменной
Перейдите в «Аудитория». Выберите столбец переменной, которую вы хотите изменить. Нажмите на иконку «Редактировать». Выделите текст, удалите его, введите новое значение до 64 символов и нажмите клавишу «Enter».
Обратите внимание, что изменения применяются на всех подписчиков бота. Если вы использовали переменные в цепочках бота или запланированных рассылках, вам нужно будет изменить переменную самостоятельно.
Добавление или обновление значения переменной
При добавлении значения переменной обращайте внимание на тип переменной. Каждый тип переменной имеет свое ограничение по вводимым символам. Значения переменных можно установить вручную, через API, и настроить автоматическое добавление. Значение переменной может содержать до 1024 символов.
| Вручную в «Аудитория» одному контакту | Перейдите во вкладку «Аудитория». Напротив нужного контакта нажмите на ячейку под нужной переменной, введите значение и нажмите клавишу «Enter». |
| Вручную в «Аудитория» списку контактов | Перейдите во вкладку «Аудитория». Выделите нужные контакты и нажмите «Установить переменную». Выберите, для какой переменной установить значение, и введите значение. |
| Вручную в чате с подписчиком | Перейдите в «Чаты бота» и нажмите на нужный контакт. Справа в панели напротив нужной переменной введите значение. |
| При подписке через виджет | Вы можете также добавить скрипт сбора дополнительных переменных при подписке через виджет.
Скопируйте код и вставьте его в исходный код вашего сайта рядом со скриптом виджета подписки. Обратите внимание, что значения записываются только в заранее созданные переменные. Отправка данных на несуществующие поля будет игнорироваться. |
| API метод «Установить значение переменной» | Используется для создания внешних интеграций.
Отправьте POST по ссылке https://api.sendpulse.com/messenger/contacts/setVariable. В заголовок запроса добавьте токен авторизации, в тело запроса — ID контакта и имя или ID переменной, для которой нужно добавить значение, и само значение. Для каждой соцсети подставьте нужный эндпоинт запроса: messenger, telegram, whatsapp, livechat, instagram. |
| В режиме редактирования цепочки вы можете настроить автоматическое добавление значения переменной каждому контакту, который прошел через этот блок цепочки. | |
| Блок «Сообщение: Ввод пользовательских данных» | Перейдите в режим редактирования цепочки. Добавьте блок «Сообщение». Активируйте «Ждать ответ подписчика». Возле опции «Сохранить ответ в переменную» выберите переменную, в которую записывать полученные значения пользователя. |
| Блок «Действие: Установить переменную» | Перейдите в режим редактирования цепочки. Добавьте блок «Действие». Выберите действие «Установить переменную» и укажите, в какую переменную сохранять значения.
Обратите внимание, что действие «Установить переменную», в отличие от других блоков, будет устанавливать одно и то же значение переменной. Для числовых переменных вы можете также устанавливать динамические значения. Чтобы прибавить или отнять значение переменной, укажите +1 или -1. Если текущее значение не задано или пустое, отсчет будет от нуля или от текущей даты. |
| Блок «Запрос API» | Перейдите в режим редактирования цепочки. Добавьте блок «Запрос API». Введите данные запроса и нажмите «Проверить запрос». Под секцией «Настройка соответствий» возле опции «Поле ответа» выберите, в какую переменную сохранять полученное значение от пользователя. |
Удаление значения переменной
Вы можете удалить переменную в аудитории или из чата с подписчиком.
Перейдите во вкладку «Аудитория» и напротив нужного контакта нажмите на значение переменной, которое вы хотите удалить. Выделите содержимое ячейки, нажмите «Delete» и затем «Enter».
Перейдите в «Чаты бота» и нажмите на нужный контакт. Справа в панели напротив нужной переменной выделите ее значение, нажмите «Delete» и затем «Enter».
Удаление переменной
При удалении переменной из аудитории значение этой переменной также удалится для всех пользователей безвозвратно.
Перейдите во вкладку «Аудитория» и наведите на столбец переменной, которую вы хотите удалить. Нажмите на иконку «Удалить».
Если вы не видите нужную переменную, возможно вы ее скрыли. Нажмите на три точки справа от названия переменных и выберите, какие переменные показывать.
Как управлять тегами
Тег может иметь только строковое значение до 32 символов. Вы можете использовать теги для дополнительной фильтрации и сегментации подписчиков. Читайте подробнее: «Как присваивать теги подписчикам чат-бота».
Присвоение тега
| Вручную в «Аудитория» одному подписчику | Перейдите во вкладку «Аудитория». Под колонкой «Теги» напротив нужного контакта нажмите на ячейку и введите значение тега. |
| Вручную в «Аудитория» списку подписчиков | Перейдите во вкладку «Аудитория». Выделите нужные контакты, нажмите «Добавить тег» и введите значение тега. |
| Вручную в чате с подписчиком | Перейдите в «Чаты бота» и нажмите на нужный контакт. Справа в панели в самом низу в поле «Укажите тег» введите значение тега. |
| Автоматически через блок «Действие: Добавить тег» | Вы можете настроить присвоение тегу каждому контакту, который прошел через блок цепочки.
Перейдите в режим редактирования цепочки. Добавьте блок «Действие». Выберите действие «Добавить тег» и введите значение тег. |
| API метод «Добавить тег контакту» | Используется для создания внешних интеграций.
Отправьте POST по ссылке https://api.sendpulse.com/messenger/contacts/setTag. В заголовок запроса добавьте токен авторизации, а в тело запроса ID контакта и сам тег. Для каждой соцсети подставьте нужный эндпоинт запроса: messenger, telegram, instagram |
Редактирование тега
Чтобы изменить название тега, перейдите в Настройки бота во вкладку «Теги. Нажмите на карандаш и измените название.
Обратите внимание, что изменения применяются на всех подписчиков бота. Если вы использовали теги в цепочках бота или запланированных рассылках, вам нужно будет изменить тег самостоятельно.
Удаление тега
Вы можете удалить тег в аудитории, из чата с подписчиком или через API метод Удалить тег контакта.
Перейдите в Аудитория, напротив нужного контакта наведите на тег, который вы хотите удалить, и нажмите на крестик.
Перейдите в Чаты бота и нажмите на нужный контакт. Справа в поле тегов наведите на нужный и нажмите на крестик.
Вы можете также удалить тег для всех подписчиков, кому он присвоен. Перейдите в Настройки бота во вкладку Теги и нажмите на иконку Удалить напротив нужного тега.
Как управлять контактами
Вы можете выполнять следующие действия с выбранными контактами чат-бота:
| Подключить подписчиков (Enable subscribers) |
Активирует подписчика со статусом Отключен. Вы можете активировать только подписчика, которого вы сами отключили в аудитории. |
| Отключить подписчиков (Disable subscribers) | Деактивирует подписчика. После деактивации подписчик не сможет получать рассылки и автоответы бота по цепочкам. |
| Удалить подписчиков (Delete subscribers) |
Удаляет подписчиков со всеми данными в аудитории и чатах. Вы можете выбрать опцию удалить подписчиков или удалить и заблокировать возможность подписаться обратно. Чтобы посмотреть заблокированные контакты и разблокировать их, перейдите в Настройки бота > Список заблокированных. |
| Запустить цепочку (Start flow) |
Запускает выбранную цепочку. Запуск цепочек работает в соответствии с ограничениями социальных платформ. Читайте подробнее: Как запустить чат-бота в ручном режиме. |
| Установить переменную (Set variable) |
Добавляет переменную с выбранным значением переменной. Перед тем как устанавливать переменную, ее нужно создать. |
| Добавить тег (Add tag) | Добавление тега контакта. Вы можете создать новый или выбрать из созданных. |
Чтобы применить действие к одному контакту или группе контактов, отметьте их и выберите на панели действие. Чтобы применить действие ко всем контактам в аудитории, нажмите Выбрать все (Select All).
Можно также использовать фильтр для сортировки и отбора сегмента контактов.
Чтобы загрузить больше контактов на страницу, прокрутите ниже и нажмите кнопку Загрузить больше (Load more). При каждом нажатии можно загрузить дополнительно 50 контактов.
Обновлено: 25.06.2024
или