Интеграции
Интеграция с Zapier
Приложение Wbiztool в Zapier связывает ваш номер WhatsApp с другими приложениями, которыми вы пользуетесь. Запускайте Zap при получении сообщения WhatsApp или отправляйте сообщение WhatsApp, когда что-то происходит в другом приложении.
Перед началом работы#
- Аккаунт Wbiztool с подключённым номером WhatsApp в настройках WhatsApp.
- Ваши Client ID и API key (API-ключ) из раздела Настройки → API ключи.
- Для триггера новых сообщений: дополнение Unibox в вашем тарифе. См. Требования триггера.
Подключение аккаунта#
Добавьте Wbiztool в Zap
В Zapier создайте Zap и найдите Wbiztool в качестве приложения для триггера или действия.
Войдите
Когда 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.
| Поле | Описание |
|---|---|
event | message_received для входящих сообщений, message_sent для сообщений, отправленных с вашего номера. |
message.type | chat для текста. Для медиасообщений используются такие типы, как image, video, audio, ptt (голосовое сообщение), document и sticker. |
message.content | Текст. Для медиафайлов — короткая метка, например «📸 Image». |
message.direction | incoming или outgoing. |
message.from / message.to | from — всегда контакт, а to — ваш номер, даже для исходящих сообщений. Чтобы различать их, используйте message.direction. |
contact.is_group | true, если сообщение пришло из группы. Групповые сообщения также содержат group.name. |
В реальных сообщениях номера телефонов указываются без +, message.whatsapp_timestamp указывается в секундах, а message.status обычно равен pending. Некоторые сообщения содержат дополнительные поля: message.media (имя, тип и размер файла) для медиафайлов, message.quoted_message_id для ответов и group для групповых сообщений. Больше примеров см. в разделе Слушатели вебхуков.
Пример: запись входящих сообщений в Google Sheets#
- Триггер: Wbiztool, New WhatsApp Message.
- Filter by Zapier: продолжать, только если
message.directionв точности совпадает сincoming. - Действие: Google Sheets, Create Spreadsheet Row. Сопоставьте
contact.phoneсо столбцом Phone,contact.name— со столбцом Name, аmessage.content— со столбцом Message.
Отправка сообщений WhatsApp из Zap#
Чтобы отправить сообщение, добавьте Wbiztool как действие и выберите одно из действий, перечисленных на странице Wbiztool в Zapier. Сопоставьте номер телефона получателя и текст сообщения с данными из предыдущих шагов.
Также можно вызвать API напрямую через Webhooks by Zapier:
| Настройка | Значение |
|---|---|
| Action event | POST |
| URL | https://wbiztool.com/api/v1/send_msg/ |
| Payload type | json или form |
| Data | client_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 вебхука. |
