Перейти к содержимому
Wbiztool

Интеграции

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

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

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

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

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

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

  2. Войдите

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

API-ключ определяет, какое рабочее пространство использует Zapier. Если вы состоите в нескольких рабочих пространствах, используйте ключ, созданный в том рабочем пространстве, которое хотите подключить.

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

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

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

  • Дополнение Unibox. Без него включение Zap завершается ошибкой Unibox add-on subscription required. Купите его на странице Биллинг и планы: $20 в месяц или $200 в год за каждый номер WhatsApp, используемый в Unibox.
  • Подключённый номер WhatsApp. Триггер привязывается к одному из ваших подключённых номеров.

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

Реальные сообщения выглядят так:

{
  "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",
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

Пример, который Zapier загружает при настройке триггера, содержит те же поля message и contact (кроме message.forwarding_score), но в нём нет webhook_id, whatsapp_client_id, whatsapp_phone и organisation. Эти поля становятся доступны для сопоставления только после того, как придёт реальное сообщение. Кроме того, в примере используются значения-заполнители: номера телефонов с +, whatsapp_timestamp в миллисекундах и status, равный delivered.

ПолеОписание
eventmessage_received для входящих сообщений, message_sent для сообщений, отправленных с вашего номера.
message.typechat для текста. Для медиасообщений используются такие типы, как image, video, audio, ptt (голосовое сообщение), document и sticker.
message.contentТекст. Для медиафайлов — короткая метка, например «📸 Image».
message.directionincoming или outgoing.
message.from / message.tofrom — всегда контакт, а to — ваш номер, даже для исходящих сообщений. Чтобы различать их, используйте message.direction.
contact.is_grouptrue, если сообщение пришло из группы. Групповые сообщения также содержат group.name.

В реальных сообщениях номера телефонов указываются без +, message.whatsapp_timestamp указывается в секундах, а message.status обычно равен pending. Некоторые сообщения содержат дополнительные поля: message.media (имя, тип и размер файла) для медиафайлов, message.quoted_message_id для ответов и group для групповых сообщений. Больше примеров см. в разделе Слушатели вебхуков.

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

  1. Триггер: Wbiztool, New WhatsApp Message.
  2. Filter by Zapier: продолжать, только если message.direction в точности совпадает с incoming.
  3. Действие: Google Sheets, Create Spreadsheet Row. Сопоставьте contact.phone со столбцом Phone, contact.name — со столбцом Name, а message.content — со столбцом Message.

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

Чтобы отправить сообщение, добавьте Wbiztool как действие и выберите одно из действий, перечисленных на странице Wbiztool в Zapier. Сопоставьте номер телефона получателя и текст сообщения с данными из предыдущих шагов.

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

НастройкаЗначение
Action eventPOST
URLhttps://wbiztool.com/api/v1/send_msg/
Payload typejson или form
Dataclient_id, api_key, whatsapp_client, country_code, phone, msg

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

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

ПроблемаЧто проверить
Invalid API keyКлюч удалён или введён с ошибкой. Создайте новый в разделе Настройки → API ключи и подключите аккаунт заново.
Unibox add-on subscription requiredКупите дополнение Unibox на странице Биллинг и планы, затем снова включите Zap.
No available WhatsApp clientsВ триггере не указан номер, и у всех подключённых номеров уже есть слушатель Unibox, либо ни один номер не подключён. Сюда относится и слушатель, который Wbiztool создал при первом включении этого Zap: выключение Zap его не удаляет, поэтому повторное включение (например, после редактирования Zap) может завершиться ошибкой. Удалите ненужного слушателя, например этого, на странице слушателей Unibox или подключите ещё один номер в настройках WhatsApp.
Invalid WhatsApp clientНомер, указанный в триггере, сейчас не подключён. Подключите его заново в настройках WhatsApp.
Zap включён, но не срабатываетЧтобы новые сообщения подхватывались, ваш номер WhatsApp должен оставаться подключённым. Проверьте слушателя на странице слушателей Unibox.
При выключении Zap Zapier показывает ошибку, например Listener not found или ошибку сервераЭто известная проблема. Проверьте слушателя на странице слушателей Unibox, чтобы узнать, был ли удалён его URL вебхука.