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