Все ноды/Integrations/VK
VK: отправить сообщение
Отправляет сообщение через VK API (messages.send). Подключение: нода «VK: подключение» в порт «Подключение VK» или сохранённое подключение, выбранное прямо в ноде (порт выигрывает). peer_id и текст задаются в конфиге (поддерживаются шаблоны). Ошибка VK роняет ноду — подключите выход «Ошибка», чтобы обработать её в сценарии.
Тип в графе: vk_send_message
Exec
Можно включить выход ошибки и обработать сбой отдельным путём.
Как попробовать
Минимальный рабочий сценарий
- Исполнение
- Данные
- Исполнение + данные
Перед запуском выберите своё подключение или базу знаний — в графе стоит REPLACE_ME.
Как применять
Нода отправляет одно текстовое сообщение через VK: уведомление в беседу, ответ клиенту в
сообщения сообщества, оповещение по итогам запуска. Кому и что писать, задаёте вы — это шаг
графа, а не инструмент агента: порта tool_out у ноды нет, и модель вызвать её не может.
Чтобы отправку решала модель, оберните ноду в Свой инструмент.
Как это работает
«Чат» и «Сообщение» — шаблоны, в них подставляются данные запуска. Идентификатор получателя
кодирует и его вид: пользователь — просто число (12345), сообщество — то же число с минусом
(-98765), беседа — 2000000000 плюс номер беседы (беседа 5 → 2000000005).
Выход ноды — message_id отправленного сообщения. VK отвечает кодом 200 даже на отказ (истёкший
токен, нехватка прав, недоступный получатель), поэтому нода разбирает содержимое ответа сама и
останавливается на отказе. Включите «Выход ошибки», чтобы обработать это в графе; без него
запуск завершится ошибкой.
Частые ошибки
- Ошибка в Peer ID. Неверный номер не вызывает отказа — сообщение просто уходит не тому
получателю. Особенно легко перепутать беседу (нужен
2000000000 + номер) с идентификатором пользователя. - Пустой текст. Валидатор требует только Peer ID, поэтому пустое «Сообщение» доживёт до запуска — и VK отклонит его, остановив ноду.
- Вложения. Нода отправляет только текст; портов для файлов и медиа у неё нет.
- Повторный запуск как способ «дослать». Каждый вызов уходит с новым признаком уникальности, так что перезапуск сценария отправит второе сообщение, а не заменит первое.
- Форматирование. Текст уходит как есть; разметка из ответа модели дойдёт до получателя вместе со звёздочками.
Входы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Подключение VKvk_config | Данныеdata | — | обязателен |
Выходы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Итог действияoutput | Исполнение + данныеexecute_data | object | |
Ошибкаon_error | Исполнение + данныеexecute_data | — | показывается, когда expose_error_output = true |
Настройки
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
Подключение VKconnection_id | string | "" | Сохранённое подключение VK из пространства: сценарию с одним сообщением не нужна отдельная нода VK Config. Нода, подключённая к порту 'vk_config', имеет приоритет над этим полем. подключение: vkперекрывается портом: vk_config |
Чатpeer_id | string | "" | Получатель. VK peer_id: id пользователя (12345), сообщество — с минусом (-98765), беседа — 2000000000 + номер беседы (беседа 5 → 2000000005). Поддерживаются шаблоны поддерживает шаблоны |
Сообщениеmessage | string | "" | Текст сообщения (шаблоны поддерживаются) поддерживает шаблоны |
Общие поля
Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.
expose_error_output— Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этой ноды.