Как управлять переменными и тегами подписчиков чат-бота
С помощью переменных и тегов вы можете организовать и хранить всю необходимую информацию о подписчике, его заказы и предпочтения, чтобы персонализировать работу с каждым подписчиком или группой подписчиков по определённым критериям фильтра.
В статье рассмотрим, как создать и управлять переменными и тегами аудитории.
Как управлять переменными
Вы можете создать переменную в аудитории без значения или добавить переменную сразу со значением, обновить значение существующей переменной для всех или одного контакта.
Создание переменной
Функционал добавления переменных одинаковый для всех мессенджеров. Переменные создаются для всех контактов в списке «Аудитория».
| Вручную в «Аудитория» | Перейдите во вкладку «Аудитория». Справа нажмите «Создать переменную». Введите имя и тип переменной и нажмите «Создать». Читайте подробнее «Как создать переменную в аудитории чат-бота». |
| Вы можете создать переменную в режиме редактирования цепочки, чтобы в последующем настроить добавление значения переменной каждому контакту, который прошел через этот блок цепочки. | |
| Вручную в цепочке с помощью блока «Сообщение: Ввод пользовательских данных» |
Перейдите в режим редактирования цепочки. Добавьте блок «Сообщение». Активируйте «Ждать ответ подписчика». Возле опции «Сохранить ответ в переменную» нажмите «Создать переменную». Обратите внимание, что в этом блоке вы можете создать переменную только с типом «Строка». |
| Вручную в цепочке с помощью блока «Действие: Установить переменную» | Перейдите в режим редактирования цепочки. Добавьте блок «Действие». Выберите действие «Установить переменную» и нажмите «Создать переменную». Введите имя и тип переменной. |
| Вручную в цепочке с помощью блока «Запрос 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 метод Удалить тег контакта.
Перейдите в Аудитория, напротив нужного контакта наведите на тег, который вы хотите удалить, и нажмите на крестик.
Перейдите в Чаты бота и нажмите на нужный контакт. В поле тегов наведите на нужный и нажмите на крестик.
Вы можете также удалить тег для всех подписчиков, кому он присвоен. Перейдите в Настройки бота во вкладку Теги и нажмите на иконку Удалить напротив нужного тега.
Обновлено: 25.06.2024
или