Добавить пользователя в бота

https://smm.targethunter.ru/api/bots/addUser

Позволяет добавить пользователя в бота

Обязательные параметры

Параметр

Описание

bot_id

ID бота, в которого нужно добавить пользователя Пример: 607d97c6a01c6a25972ed95e

uid

ID пользователя в соц. сети/мессенджере Пример: 102036383

channel

Из какого канала пользователь Пример: VK

Опциональные параметры

Параметр

Описание

step_id

ID шага, в который добавить пользователя

Пример: 61af67fb5bc8635f3f53b18b

force

Значения 0 или 1, где 1 - добавлять пользователя в бота, даже если он уже находится в боте. Параметры 0 и 1 могут по-разному отрабатывать в зависимости от расширенных настроек бота по параметру "Повторный проход бота"

payload

Дополнительные параметры, которые нужно передать в бота. Будут доступны в переменной входных данных.

Строка или массив.

Значение из payload будет доступно, если в боте включена настройка "Сохранять входные параметры в переменную". Также может потребоваться использовать блок Действие "Декодировать JSON" перед тем, как использовать полученные через payload данные. Также вы можете указать в массиве payload ключ text и записать текст, который будет доступен внутри бота в переменной {content}

Пример: payload[text] = 'мой текст' - в переменной {content} будет лежать 'мой текст'

Пример работы с этим методом: https://smm.targethunter.help/dev/api#primer-zaprosa

Как работает параметр force при разных настройках бота на разрешение повторного прохода

В расширенных настройках бота можно установить 1 из 3 вариантов на возможность повторного прохода бота:

Как сработает параметр force при различных ситуациях:

Когда пользователь находится в цепочке бота:

Если бот, в который добавляют - повторный проход возможен в любой момент, то:

  • force 0 - ничего не меняет, всё равно добавляется в бот заново;

  • force 1 - соответственно, тоже самое.

Если бот, в который добавляют - повторный проход возможен после завершения всей цепочки, то:

  • force 0 - ничего не происходит, повторно не добавляется;

  • force 1 - добавляется повторно. (по умолчанию, force 0, если не передается этот параметр)

Если бот, в который добавляют - повторный проход запрещён, то:

  • force 0 - ничего не происходит, повторно не добавляется;

  • force 1 - добавляется повторно (да, даже если запрещён повторный проход в настройках бота). (по умолчанию, force 0, если не передается этот параметр)

Иными словами, force НЕ имеет смысла использовать, если повторный проход в любой момент.

Last updated