n8n-nodes-vk-community

Ноды для автоматизации сообществ ВКонтакте в n8n
Отправка сообщений · Управление стеной · Callback API триггер

🚀 Быстрый старт

Установка

cd ~/.n8n
npm install n8n-nodes-vk-community
# Перезапустите n8n

После установки в палитре нод появятся:

🔑 Настройка подключения

Всё начинается с токена сообщества. Без него ничего не заработает.

Шаг 1 — Получите токен в ВКонтакте

Сообщество → ⚙️ Управление → Работа с API → Ключи доступа → Создать ключ

Какие права выбрать:

Шаг 2 — Создайте credential в n8n

Credentials → Add Credential → VK Community API

💡 Нажмите Test — если токен валиден, увидите зелёную галочку. Тест вызывает groups.getById.

Сообщество → Управление → Работа с API → Callback API
→ «Строка, которую должен вернуть сервер»

💬 Нод VK Community

Основной нод для действий с VK API. Работает с двумя ресурсами:

Сообщения (Message)

{
  "inline": true,
  "buttons": [[
    {
      "action": { "type": "text", "label": "✅ Да", "payload": "{\"btn\":\"yes\"}" },
      "color": "positive"
    },
    {
      "action": { "type": "text", "label": "❌ Нет", "payload": "{\"btn\":\"no\"}" },
      "color": "negative"
    }
  ]]
}

Стена (Wall)

⚡ Нод VK Community Trigger

Принимает события от ВКонтакте через Callback API и запускает workflow.

Поддерживаемые события

🔧 Настройка Callback API — пошагово

Это самая ответственная часть. Порядок действий важен!

┌─────────────────────────────────────────────────────────┐
│  1. Заполните credential (токен + confirmation string)  │
│                         ↓                               │
│  2. Создайте workflow с VK Community Trigger             │
│                         ↓                               │
│  3. Активируйте workflow (Active → On)                  │
│                         ↓                               │
│  4. Скопируйте webhook URL                              │
│                         ↓                               │
│  5. Вставьте URL в VK → Callback API → Подтвердите      │
│                         ↓                               │
│  6. Включите нужные типы событий в VK                   │
└─────────────────────────────────────────────────────────┘

Подробнее:

1. Убедитесь, что в credential заполнены Community Access Token и Confirmation String.

2-3. Создайте workflow, добавьте нод VK Community Trigger, выберите события, подключите credential. Активируйте workflow.

4. После активации n8n покажет Production URL вида:

https://your-n8n.com/webhook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/webhook

⚠️ Workflow ОБЯЗАТЕЛЬНО должен быть активен до настройки URL в VK. Иначе VK не сможет пройти подтверждение — webhook не ответит.

5. В ВКонтакте:

Сообщество → Управление → Работа с API → Callback API → вкладка «Настройки сервера»

Вставьте URL → нажмите Подтвердить. При успехе появится ✅.

6. Перейдите во вкладку Типы событий и включите те же события, что выбрали в нод (например, «Входящее сообщение» для message_new).

📤 Что приходит в workflow

При каждом событии триггер выдаёт:

{
  "eventType": "message_new",
  "groupId": 123456789,
  "eventId": "abc123def456",
  "object": {
    "message": {
      "id": 100,
      "from_id": 87654321,
      "peer_id": 87654321,
      "text": "Привет, бот!"
    }
  },
  "_rawBody": { "..." }
}

Полезные выражения для следующих нод:

• Текст сообщения: {{ $json.object.message.text }}
• ID отправителя: {{ $json.object.message.from_id }}
• Peer ID для ответа: {{ $json.object.message.peer_id }}

🛠 Примеры workflow

🤖 Эхо-бот

Отвечает на каждое сообщение, повторяя текст:

[VK Community Trigger] → [VK Community]
     message_new            Message → Send

Настройка VK Community:

• Peer ID: {{ $json.object.message.peer_id }}
• Message Text: Вы написали: {{ $json.object.message.text }}

📅 Автопостинг по расписанию

Каждый день публикует пост с контентом из внешнего API:

[Schedule Trigger] → [HTTP Request] → [VK Community]
   каждый день       получить данные    Wall → Create Post

📲 Пересылка VK-сообщений в Telegram

[VK Community Trigger] → [Telegram]
     message_new          Send Message

Текст для Telegram: Новое сообщение VK от {{ $json.object.message.from_id }}: {{ $json.object.message.text }}

🔔 Уведомление о новых постах в Slack

[VK Community Trigger] → [Slack]
     wall_post_new        Send Message

❗ Частые проблемы и решения

📋 Совместимость

📄 Лицензия

MIT