Интеграция с n8n

Отправляйте сообщения WhatsApp из своих сценариев n8n. Например, пишите новому лиду по вебхуку, подтверждайте заказ из своего магазина или отправляйте оповещение, когда проверка завершилась ошибкой.

Подключиться можно двумя способами:

• Community-узел Wbiztool (n8n-nodes-wbiztool): готовые узлы с полями для каждого параметра.
• Встроенный узел HTTP Request: работает в любом экземпляре n8n и даёт доступ ко всем эндпоинтам API. См. Использование узла HTTP Request.

Перед началом работы#

• Аккаунт Wbiztool с подключённым номером WhatsApp в настройках WhatsApp.
• Ваши Client ID и API key (API-ключ) из раздела Настройки → API ключи.
• ID клиента WhatsApp номера, с которого будут отправляться сообщения, — он указан в настройках WhatsApp.

Установка community-узла#

1. Откройте Community Nodes

   В n8n перейдите в Settings → Community Nodes и нажмите Install.

2. Введите название пакета

   Введите n8n-nodes-wbiztool, подтвердите и установите. Если узлы не появились, перезапустите n8n.

В self-hosted экземпляре его также можно установить через npm в папку пользовательских узлов n8n:

npm install n8n-nodes-wbiztool

Создание учётных данных#

Добавьте новые учётные данные (credential) типа WbizTool API:

При сохранении n8n проверяет учётные данные через проверку учётных данных.

Узлы#

Пакет добавляет следующие узлы. Каждый из них вызывает эндпоинт API Wbiztool и выводит ответ API.

WbizTool Send Message#

Узел выводит messageId (значение msg_id из API). Сохраните его, если хотите позже проверить статус или отменить сообщение.

Пример сценария#

1. Узел Webhook получает новый лид с phone и name.
2. WbizTool Send Message: задайте для Phone Number значение {{ $json.phone }}, а для Message Text — Hi {{ $json.name }}, thanks for signing up!.
3. Узел IF: проверьте, что {{ $json.messageId }} не пустое, чтобы перейти к следующему шагу, например к обновлению CRM.

При успешном выполнении WbizTool Send Message выводит такой элемент:

{
  "success": true,
  "messageId": 9817263,
  "status": 1,
  "message": "Created",
  "response": { "status": 1, "message": "Created", "msg_id": 9817263 }
}

Элемент также содержит объект input со значениями, которые отправил узел. Если API возвращает ошибку, узел останавливается и показывает message из API. Включите Continue On Fail, чтобы вместо этого получить элемент с success: false и текстом error.

Для WbizTool WhatsApp Client Status используйте метод проверки General Status. Метод Status by ID возвращает ошибку для любого номера из-за бага в этом эндпоинте API. При General Status номер, который не подключён, тоже останавливает узел с ошибкой Disconnected, поэтому включите у узла настройку Continue On Fail, если хотите строить ветвление по результату.

Использование узла HTTP Request#

Добавьте узел HTTP Request и настройте его так:

Затем вставьте тело запроса, как в примере ниже, и подставьте значения из предыдущих узлов с помощью выражений:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "{{ $json.phone }}",
  "msg": "Hi {{ $json.name }}, thanks for signing up!"
}

Успешный вызов возвращает {"status": 1, "message": "Created", "msg_id": 9817263}. Все поля и сообщения об ошибках описаны в разделе Отправка сообщения.

Чтобы вызвать другие эндпоинты, измените URL и тело запроса. Например, чтобы запланировать сообщение, используйте https://wbiztool.com/api/v1/schedule_msg/ и добавьте date в формате DD/MM/YYYY, time в формате HH:MM и timezone. См. Планирование сообщения.

Чтобы отправить одно и то же сообщение на несколько номеров или в несколько групп одним вызовом, используйте https://wbiztool.com/api/v1/send_msg/multi/ и передайте получателей в phone одной строкой через запятую. См. Отправка на несколько номеров.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 1,
  "country_code": "91",
  "phone": "{{ $json.phones }}",
  "img_url": "https://example.com/offers/diwali-sale.jpg",
  "msg": "Our Diwali sale starts tomorrow!"
}

Указывайте в каждом номере только цифры. Всё, что не является целым числом, например 98765 43210, отправляется как название группы.

Выражения n8n работают в любом текстовом поле. Например, приветствие, зависящее от времени суток, или текст, зависящий от суммы заказа:

{
  "msg": "Good {{ $now.hour < 12 ? 'morning' : 'evening' }} {{ $json.name }}, your order total is {{ $json.total }}.{{ $json.total > 1000 ? ' Delivery is free.' : '' }}"
}

$now использует часовой пояс сценария (Workflow settings → Timezone), поэтому задайте его, чтобы определить, когда заканчивается «утро».

Уведомление об отправке сообщения#

1. Создайте сценарий с вебхуком

   Добавьте узел Webhook с HTTP-методом POST и скопируйте его production URL.

2. Передайте URL при отправке

   Укажите этот URL в параметре узла Webhook URL или в поле webhook тела HTTP-запроса.

3. Обработайте результат

   Wbiztool вызывает этот URL, когда сообщение отправлено или отправить его не удалось. Тело передаётся в формате form-encoded и содержит только msg_id и status со значением SENT или FAILED.

О повторных попытках и тайм-аутах см. раздел Webhook.

Устранение неполадок#