Отправка сообщений WhatsApp из любого инструмента автоматизации

В большинстве платформ автоматизации есть действие, которое отправляет HTTP-запрос. Часто оно называется HTTP Request, API request или Outgoing webhook. Направьте это действие на эндпоинт отправки сообщения Wbiztool, и каждый запуск вашего сценария будет отправлять сообщение WhatsApp с подключённого номера.

На этой странице сначала описана общая настройка, а затем показано, где найти нужное действие в Pabbly Connect, Albato, Activepieces и Make.

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

Вам понадобятся три значения из аккаунта Wbiztool:

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

Подробнее см. в разделе Аутентификация.

Настройка HTTP-действия#

1. Добавьте действие HTTP-запроса

   После триггера (новая запись формы, новая строка таблицы, новый заказ) добавьте действие HTTP- или API-запроса вашей платформы.

2. Укажите метод и URL

   Метод POST, URL https://wbiztool.com/api/v1/send_msg/. Аутентификацию оставьте выключенной: учётные данные передаются в теле запроса.

3. Выберите тип тела запроса

   Выберите JSON, если ваш инструмент это позволяет. Form data (поля формы) тоже работает, поэтому используйте то, что удобнее в вашем инструменте. Дополнительные заголовки не нужны.

4. Добавьте поля тела запроса

   Добавьте поля из таблицы ниже. Учётные данные введите как фиксированные значения, а phone и msg подставьте из данных триггера.

5. Протестируйте шаг

   Запустите шаг один раз с тестовыми данными. Ответ с "status": 1 означает, что сообщение поставлено в очередь.

Поля тела запроса#

Чтобы отправить сообщение в группу WhatsApp, а не на номер, передайте group_name вместо phone. См. Отправка в группу. Все остальные параметры перечислены в разделе Отправка сообщения.

Пример тела JSON#

Замените значения, написанные заглавными буквами, и подставьте вместо заполнителей поля из триггера. Синтаксис вставки данных триггера отличается в разных инструментах; в большинстве из них можно выбрать поле в окне выбора данных.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "msg": "Hi NAME_FROM_TRIGGER, thanks for your order. We will update you here on WhatsApp."
}

Чтобы отправить сообщение в группу, замените phone и country_code на group_name:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "group_name": "Sales Team Mumbai",
  "msg": "New lead: NAME_FROM_TRIGGER, PHONE_FROM_TRIGGER"
}

Чтобы отправить изображение, укажите для msg_type значение 1 и добавьте img_url; msg станет подписью. Для файла укажите для msg_type значение 2 и добавьте file_url и file_name:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 2,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "file_url": "https://example.com/invoices/INV-1042.pdf",
  "file_name": "INV-1042.pdf",
  "msg": "Here is your invoice."
}

Ответ#

Успешный запрос возвращает:

{
  "status": 1,
  "message": "Created",
  "msg_id": 9817263
}

"status": 1 означает, что сообщение поставлено в очередь, но ещё не отправлено. Если что-то не так, API возвращает HTTP 400 с "status": 0 и message, например Auth Error: invalid api key или Invalid phone number. Некоторые инструменты останавливают сценарий при ответе 400; откройте вывод шага, чтобы прочитать message. Полный список приведён в разделе Отправка сообщения → Ошибки.

Чтобы узнать, когда сообщение действительно отправлено, передайте URL в webhook (например, триггер вебхука в том же инструменте). На него придёт POST в формате form-encoded с msg_id и status со значением SENT или FAILED. См. Webhook.

Pabbly Connect#

1. Добавьте действие API

   В сценарии добавьте шаг действия, выберите приложение API (Pabbly) и событие действия Execute API Request.

   

2. Настройте запрос

   Установите Action Event Method в POST, API Endpoint URL — https://wbiztool.com/api/v1/send_msg/, Payload Type — Form Data или JSON, а Authentication — No Auth.

   

3. Задайте параметры

   Отметьте Set Parameters и добавьте по одной строке на каждое поле тела запроса: client_id, api_key, whatsapp_client, phone, country_code, msg и msg_type. Подставьте phone и msg из триггера.

   

   На скриншоте нет country_code, потому что тестовый номер уже содержит код страны.

4. Нажмите Save and send test request

   Проверьте, что ответ содержит "status": 1.

Albato#

1. Добавьте HTTP-действие

   В автоматизации добавьте действие, выберите HTTP Request/Outgoing webhook, а затем его действие Send request. Например, используйте триггер Google Sheets New row created, чтобы отправлять сообщение для каждой новой строки.

   

2. Создайте подключение

   Дайте подключению название, например «Wbiztool». В качестве его URL можно указать https://wbiztool.com/api/v1/send_msg/ и выбрать тип содержимого JSON.

3. Сопоставьте поля

   Установите URL в https://wbiztool.com/api/v1/send_msg/ (если оставить пустым, используется URL подключения) и Request method в POST. В разделе Request parameters добавьте client_id, api_key, whatsapp_client, msg_type, country_code, phone и msg, а phone и msg выберите из полей триггера.

   

   

   На скриншоте используется message, который работает вместо msg. В нём нет country_code, потому что тестовый номер уже содержит код страны.

4. Протестируйте и запустите

   Выполните тест, убедитесь, что ответ содержит "status": 1, затем запустите автоматизацию.

   

Activepieces#

1. Добавьте элемент HTTP

   Нажмите + после триггера и выберите HTTP → Send HTTP request.

2. Настройте запрос

   Установите Method в POST, а URL — https://wbiztool.com/api/v1/send_msg/. В качестве Body Type выберите JSON или Form Data.

   

3. Добавьте поля тела запроса

   Добавьте по одному элементу на каждое поле. С помощью Data Selector вставьте значения из триггера в phone и msg. Если phone уже содержит код страны (например, 919876543210), country_code можно не указывать.

4. Протестируйте шаг

   Нажмите Test Step и проверьте, что ответ содержит "status": 1, затем опубликуйте сценарий.

Make#

Используйте модуль HTTP в Make с действием Make a request. Установите метод POST, URL https://wbiztool.com/api/v1/send_msg/, тип тела запроса JSON (raw, тип содержимого application/json) или form data и заполните поля тела запроса, описанные выше.

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