Запросы к API
Блоки «Запрос к API ВКонтакте» и «Запрос к API MAX» вызывают произвольный метод сети прямо из программы. Отдельный блок «Комментарий к записи ВКонтакте» решает частую задачу — оставить комментарий, не собирая вызов вручную. Ответ сохраняется в память прохода и доступен следующим блокам.
Запрос к API ВКонтакте
Укажите метод VK API (например users.get) и при необходимости добавьте параметры (имя/значение). Токен подставляется автоматически из интеграции ВКонтакте. Ответ ложится в {b.<номер>.value…}.
Запрос к API MAX
Укажите путь метода Bot API MAX (например me, chats), query-параметры и, при необходимости, тело запроса (JSON). Если тело заполнено — запрос уходит методом POST, иначе GET. Токен подставляется из интеграции MAX.
Комментарий к записи ВКонтакте
Добавляет комментарий к записи на стене — метод wall.createComment. Поля блока:
- Текст комментария — сам текст; поддерживает переменные шаблонизатора (
{from_id},{text},{b.<номер>.value…}). Обязателен, если не заданы вложения. - ID владельца записи — у сообщества указывается со знаком «-» (например
-164338148). Если оставить пустым, комментарий уйдёт на стену текущей интеграции ВКонтакте. - ID записи — номер записи, к которой добавляется комментарий. Обязателен. Для триггера «Новая запись на стене»
удобно указать
{obj_id}— подставится запись из события. - Ответ на комментарий — необязательно; заполните, чтобы ответить в ветке конкретного комментария.
- Вложения — список вложений ВКонтакте через запятую (
photo-164338148_4572). Можно использовать вместо текста. - Публиковать от имени сообщества — комментарий уйдёт от лица группы, а не пользователя.
Блок работает только при наличии интеграции ВКонтакте, у которой есть право wall. Если права нет,
ВКонтакте вернёт ошибку «нет доступа к методу» — она попадёт в {b.<номер>.error}.
ID добавленного комментария доступен следующим блокам как {b.<номер>.value.comment_id}. Например, его можно
сохранить в ресурс или отправить пользователю ссылку на свой комментарий.
Параметры и переменные
В значениях параметров и в теле запроса работают переменные шаблонизатора: {from_id}, {b.0.text}, {b.<номер>.value…} и прочие. Так можно подставить в запрос данные пользователя или ответ предыдущего блока.
Чтение ответа
Ответ метода доступен следующим блокам: {b.<номер>.value…} — данные, {b.<номер>.ok} — успех, {b.<номер>.error} — ошибка. Например, после users.get имя пользователя — {b.<номер>.value.0.first_name}. <номер> — номер блока запроса.
Какая интеграция используется
Блок сам выбирает интеграцию: закреплённую за ним, иначе активную по типу триггера, иначе любую активную интеграцию нужной сети в кабинете. Если подходящей интеграции или токена нет — блок вернёт ошибку в {b.<номер>.error} и программа пойдёт дальше.