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

Приложение WbizTool в Zapier связывает ваш номер WhatsApp с другими приложениями, которыми вы пользуетесь. Запускайте Zap при получении сообщения WhatsApp или отправляйте сообщение WhatsApp, когда что-то происходит в другом приложении.

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

• Аккаунт WbizTool с подключённым номером WhatsApp в настройках WhatsApp.
• Ваши Client ID и API key (API-ключ) из раздела Настройки → API ключи.
• Для триггера входящих сообщений: дополнение Unibox в вашем тарифе. См. Требования триггера.

Подключение аккаунта#

1. Добавьте WbizTool в Zap

   В Zapier создайте Zap и найдите WbizTool в качестве приложения для триггера или действия.

2. Войдите

   Когда Zapier попросит подключить аккаунт, введите ваши Client ID и API key из раздела Настройки → API ключи.

API-ключ определяет, какое рабочее пространство использует Zapier. Если вы состоите в нескольких рабочих пространствах, используйте ключ, созданный в том рабочем пространстве, которое хотите подключить. Если Client ID или API-ключ неверны, Zapier покажет ошибку при подключении, например Auth Error: invalid api key.

Триггер входящего сообщения WhatsApp#

Этот триггер запускает ваш Zap каждый раз, когда кто-то отправляет сообщение на один из ваших номеров WhatsApp. Используйте его, чтобы добавлять новые чаты в CRM, публиковать сообщения в командном канале или записывать переписку в таблицу.

1. Выберите триггер

   Выберите WbizTool в качестве приложения и Incoming WhatsApp Message (Входящее сообщение WhatsApp) в качестве события триггера.

2. Выберите номер WhatsApp

   В поле WhatsApp Number (Номер WhatsApp) выберите подключённый номер, входящие сообщения на который должны запускать Zap. В списке показаны номера телефонов, подключённые в вашем рабочем пространстве.

3. Протестируйте триггер

   Нажмите Test trigger (Протестировать триггер). Zapier загрузит последние сообщения, полученные на этот номер, чтобы вы могли сопоставить реальные поля в следующих шагах. Если на номере ещё нет сообщений, Zapier покажет пример сообщения.

4. Включите Zap

   Опубликуйте Zap. WbizTool подключится к Zapier автоматически. Добавлять URL вебхука где-либо в WbizTool не нужно.

Требования триггера#

• Дополнение Unibox. Триггер добавляет ваш номер во входящие Unibox (как номер для входящих). Без дополнения включение Zap завершается ошибкой Unibox add-on subscription required. Купите его на странице Оплата и тарифы: $20 в месяц или $200 в год за каждый номер WhatsApp, используемый в Unibox.
• Свободный номер для входящих. Если номера ещё нет во входящих, он займёт один из номеров для входящих, которые позволяет ваше дополнение. Номер, который уже есть во входящих, ещё один не занимает.
• Роль Owner (Владелец) или Редактор. API-ключ должен принадлежать владельцу (Owner) или редактору рабочего пространства.
• Подключённый номер WhatsApp. Чтобы новые сообщения подхватывались, номер должен оставаться подключённым.

Как триггер работает с номерами для входящих#

• Zap запускают только входящие сообщения. Сообщения, отправленные с вашего номера, его не запускают.
• Отправляются только сообщения, полученные после включения Zap. Более ранние сообщения повторно не отправляются.
• Если номер уже есть во входящих с вашим собственным URL вебхука, пока Zap включён, его место занимает вебхук Zapier. Когда вы выключаете Zap, ваши собственные URL вебхука, секрет и настройки событий возвращаются.
• Если удалить Zap, не выключив его, WbizTool перестанет отправлять в него данные, как только Zapier сообщит, что Zap удалён.
• На странице Номера для входящих у вебхука такого номера есть значок Zapier. Если нажать там у номера Остановить или Удалить, Zap в Zapier останется включённым, но перестанет получать сообщения, и страница заранее предупредит об этом. Чтобы остановить Zap, выключите его в Zapier. Чтобы сообщения снова начали поступать после удаления слушателя, выключите и снова включите Zap в Zapier.

О том, как работают номера для входящих и вебхуки, см. в разделе Вебхуки входящих сообщений.

Данные триггера#

Каждый запуск Zap получает одно сообщение, например такое:

{
  "event": "message_received",
  "timestamp": "2026-09-16T10:31:12.482913+00:00",
  "webhook_id": 42,
  "whatsapp_client_id": "678",
  "whatsapp_phone": "919812345678",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Hi, is my order #4821 out for delivery?",
    "from": "919876543210",
    "from_name": "Aman",
    "to": "919812345678",
    "timestamp": "2026-09-16T10:29:58+00:00",
    "whatsapp_timestamp": 1789554598,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "919876543210",
    "lid": null,
    "phone_hidden": false,
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

Некоторые сообщения содержат дополнительные поля: message.media (имя, тип и размер файла и url — ссылка для скачивания, которая работает 7 дней) для медиафайлов, message.quoted_message_id для ответов и group для групповых сообщений. Чтобы сохранить файл, скопируйте его в течение этих 7 дней (например, шагом загрузки в Google Drive или Dropbox).

Пример: запись входящих сообщений в Google Sheets#

1. Триггер: WbizTool, Incoming WhatsApp Message.
2. Действие: Google Sheets, Create Spreadsheet Row (Создать строку таблицы). Сопоставьте Contact Phone (Телефон контакта) со столбцом Phone, Contact Name (Имя контакта) — со столбцом Name, а Message Content (Текст сообщения) — со столбцом Message.

Отправка сообщений WhatsApp из Zap#

Добавьте WbizTool как действие и выберите одно из этих событий действия:

В каждом действии выберите номер-отправитель в поле WhatsApp Number. Введите номер телефона получателя с кодом страны, например 919876543210, или укажите код страны в необязательном поле Country Code (Код страны), например 91. У Send WhatsApp Message on Group нет полей телефона и кода страны; вместо них указывается Group Name (Название группы).

Если WbizTool не может принять сообщение, шаг завершается ошибкой, и Zapier показывает причину, например WbizTool: Invalid phone number или WbizTool: Not enough credits. Успешный шаг означает, что сообщение поставлено в очередь. Затем WbizTool отправляет его с вашего подключённого номера.

Также можно вызвать API напрямую через Webhooks by Zapier:

Что означает каждое поле, см. в разделе Отправка сообщений WhatsApp из любого инструмента автоматизации, а все параметры — в разделе Отправка сообщения.

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