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