Как проверить подписку пользователя на канал в MAX

В этой инструкции вы узнаете, как проверить, подписан ли пользователь на канал в MAX, и как использовать результат проверки в сценариях

Для проверки подписки пользователя на канал в MAX необходимо выполнить следующие шаги:

1. Добавление бота в канал

• Для того чтобы реализовать механизм проверки подписки пользователя на канал, необходимо добавить бота в этот канал.

---

2. Создание узла с HTTP-запросом

• Создайте узел с помощью зелёной кнопки с плюсиком, расположенной вверху над деревом узлов, или с помощью кнопки Создать в контекстном меню, открывающемся при нажатии правой кнопкой мыши на любой из имеющихся узлов.

Создание нового узла

• Введите наименование узла. Например, Проверка подписки на канал в MAX

Название не должно содержать символы слеш (/) и вопросительные знаки (?)

Наименование созданного узла

• Теперь перейдём к настройке узла.

Если блок Интеграции и процедуры свёрнут, нажмите на него, чтобы развернуть его.

Настройка узла: блок Интеграции и процедуры

1. Необходимо поставить галочку возле пункта Сделать HTTP-запрос

2. Вставьте в поле запроса следующий код:

{
    "method": "GET",
    "url": "https://platform-api.max.ru/chats/CHANNEL_ID/members?user_ids={{ max_contact_id }}",
    "headers": {
        "Authorization": "MAX_BOT_TOKEN"
    }
}

Настройка узла: создание HTTP-запроса

• Теперь необходимо заменить: CHANNEL_ID — на ID канала в MAX MAX_BOT_TOKEN — на токен бота в MAX

Где найти ID канала в MAX?

ID канала указан в адресной строке браузера, если открыть канал в веб-версии мессенджера MAX.

Где найти токен бота в MAX?

Токен для вызова HTTP-запросов присваивается при создании бота. Его можно найти на платформе MAX для партнёров в разделе Чат-боты → Интеграция → Получить токен.

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом.

---

3. Настройка процедуры

В результате выполнения запроса, настроенного во втором пункте, в системной переменной http_response будет содержаться ответ.

Он выглядит следующим образом, если пользователь подписан на канал:

{
    "members": [
        {
            "last_access_time": 1776753623050,
            "is_owner": false,
            "is_admin": false,
            "join_time": 1776753623051,
            "user_id": 84081948,
            "first_name": "Boris",
            "last_name": "Zhdanov",
            "is_bot": false,
            "last_activity_time": 1776885591000,
            "avatar_url": "https://i.oneme.ru/i?r=BTFjO43w8Yr1OSJ4tcurq5HiYvvbp1oENLB-swfQ2_UvNup3RaqN0IvqaF1l1qv0Tos",
            "full_avatar_url": "https://i.oneme.ru/i?r=BTFjO43w8Yr1OSJ4tcurq5HiiBHyEBXEqVN2gbFKFxlYCep3RaqN0IvqaF1l1qv0Tos",
            "name": "Boris Zhdanov"
        }
    ]
}

И вот так, если пользователь не подписан:

{
    "members": []
}

Таким образом, после запроса необходимо обработать ответ. А именно — проверить, является ли массив members пустым. Если да, значит пользователь не подписан. Если массив не пустой, значит пользователь подписан.

Для реализации данной логики необходимо в редакторе процедур добавить следующий код:

{% if http_response.members.0 %}
	{# Здесь выстраиваем логику для подписанного пользователя #}
	{# Переводим пользователя в узел "Проверка подписки на канал: подписан" с помощью тега switch #}
	{% switch "Проверка подписки на канал: подписан" %}
{% else %}
	{# Здесь выстраиваем логику для пользователя, который не подписан #}
	{# Переводим пользователя в узел "Проверка подписки на канал: не подписан" с помощью тега switch #}
	{% switch "Проверка подписки на канал: не подписан" %}
{% endif %}

Настройка узла: логика обработки ответа

Не забывайте сохранять настройки узла после внесения изменений.

В приведённом примере, если пользователь подписан на канал, он переводится в узел Проверка подписки на канал: подписан. В ином случае — в узел Проверка подписки на канал: не подписан.

Узлы Проверка подписки на канал: подписан и Проверка подписки на канал: не подписан должны быть заранее созданы, иначе не удастся сохранить процедуру.