n8n
Установите community-узел, создайте учётные данные, соберите первый workflow и учтите ограничение единственного webhook, прежде чем добавлять триггер.
WASync предоставляет community-узел для n8n, опубликованный в npm как
n8n-nodes-wasync. Он оборачивает
тот же REST API, который описан в этой документации, поэтому всё, что делает узел, вы можете сделать и
через curl — а всё, чего он пока не умеет, тем более.
Прежде чем начать: аккаунт и подключённый номер
Узел работает с вашим аккаунтом WASync. Если его ещё нет, сначала создайте его — это займёт минуту и ничего не стоит:
Создайте бесплатный аккаунт разработчика
Перейдите на developers.wasync.app/register — имя, email, пароль. Каждый новый аккаунт получает собственное рабочее пространство: место, где хранятся ваши номера WhatsApp и API keys.
Добавьте номер WhatsApp в это рабочее пространство
Возможны два случая:
- Вы уже используете WASync внутри Bitrix24 — войдите с тем же email, который
вы используете в Bitrix24. Ваш портал появится как рабочее пространство, а его подключённые номера
будут готовы к работе. Для отправки через API на этом номере нужен API-аддон
($12 за номер в месяц; без него шаг отправки в узле отвечает
addon_required). - Вы только начинаете работать с WASync — подключите номер к своему рабочему пространству одним вызовом API, который возвращает QR-код (или код сопряжения, который вы вводите в WhatsApp). Точные шаги описаны в разделе Подключение номера WhatsApp. Каждый номер начинается с 7-дневного бесплатного пробного периода; тарифы: WAPP $19 или WABA $29 за номер в месяц, в USD.
Создайте API key
Есть два способа:
- Уже используете WASync внутри Bitrix24? Откройте Settings → API & Agents →
API keys, назовите интеграцию и нажмите Create key. Нужно подключение
с активным API-аддоном; ключ сразу получает scopes, необходимые для этого
workflow (
whatsapp.read whatsapp.send), так что выбор scopes ниже можно пропустить. - В остальных случаях войдите и откройте developers.wasync.app/keys. Выберите рабочее пространство, дайте ключу имя, отметьте scopes, указанные ниже, и создайте его.
В любом случае скопируйте ключ сразу — он показывается один раз. Именно это значение запрашивают учётные данные n8n.
Один аккаунт — много номеров
Операция Connection → List в узле показывает все номера, доступные ключу. Если список пуст, в рабочем пространстве ещё нет подключённого номера — вернитесь к шагу 2.
1. Установите community-узел
Проверен n8n (7 сентября 2026 г.)
n8n-nodes-wasync — верифицированный community-узел: он отмечен значком
верификации везде, где n8n его показывает.
Есть два способа установки — в зависимости от того, где вы запускаете n8n:
-
n8n Cloud или self-hosted — поиск в панели узлов. Откройте панель узлов, найдите «WASync» и добавьте узел. Верифицированные узлы устанавливаются прямо оттуда, без дополнительной настройки.
-
Только self-hosted — настройки Community Nodes. Откройте Settings → Community nodes → Install, введите название пакета и подтвердите:
n8n-nodes-wasyncЭтот способ работает на любом self-hosted экземпляре, верифицированном или нет.
После установки узлы WASync и WASync Trigger появятся в панели узлов.
Готовые отправные точки: бесплатные шаблоны workflow охватывают самые частые сценарии — импортируйте один из них и поправьте поля, вместо того чтобы начинать с чистого холста.
2. Создайте учётные данные
Добавьте учётные данные типа WASync API. У них одно поле: ваш API key,
который отправляется как Authorization: Bearer ….
Вставьте ключ, созданный выше (см. Прежде чем начать) — он показывается один раз. Выдавайте ему только те scopes, которые нужны workflow:
- список подключений и чтение сообщений →
whatsapp.read - отправка и отметка о прочтении →
whatsapp.send - триггер →
whatsapp.events
См. Scopes.
3. Ваш первый workflow
Самый простой полезный workflow состоит из двух узлов: ручного триггера и отправки.
Найдите id подключения. Добавьте узел WASync, выберите ресурс
Connection → операцию List и запустите. Скопируйте id номера, с которого
хотите отправлять.
Отправьте сообщение. Добавьте второй узел WASync, ресурс Message → операция Send. Заполните:
| Поле | Значение |
|---|---|
connectionId | id, который вы только что скопировали |
to | цифры в международном формате, без + — например, 40712345678 |
text | текст сообщения |
Выполните. Узел вернёт id сообщения, по которому вы сможете сопоставлять данные позже — см. два id.
Операции, которые поддерживает узел
| Ресурс | Операция | Параметры |
|---|---|---|
| Connection | List | — |
| Message | Send | connectionId, to, text |
| Message | Get Many | connectionId, limit |
| Message | Mark as Read | — |
Только отправка текста. Отправка шаблона WhatsApp и проверка того, зарегистрирован ли номер в WhatsApp, сегодня через API недоступны, поэтому узел их не предлагает — не стройте workflow, который предполагает, что они существуют.
4. Триггер
WASync Trigger запускает workflow, когда в вашем аккаунте что-то происходит. Он поддерживает четыре события:
message.receivedmessage.statusconnection.connectedconnection.disconnected
Payload'ы в точности такие же, как в руководстве по
webhooks — те же поля, те же id, тот же
timestamp в миллисекундах.
Один слот webhook на аккаунт — триггер его перемещает
В API один URL webhook на аккаунт (PUT /webhook,
POST /webhook/rotate, удаления нет). Активация WASync Trigger направляет этот
единственный слот на n8n.
Поэтому: если ваш собственный бэкенд уже получал webhooks, он перестанет их получать в тот момент, когда триггер займёт слот. И два WASync Trigger не могут одновременно занимать слот — побеждает второй. Если события нужны в нескольких местах, принимайте их один раз и раздавайте дальше сами: пусть слот держит n8n, а workflow пересылает события, либо пусть слот держит ваш бэкенд и вызывает узел n8n Webhook.
URL триггера для тестирования и для production — это разные URL, поэтому переключение между ними тоже перемещает слот.
Поскольку доставки отбрасываются после трёх неудачных попыток, сохраняйте путь сверки даже в n8n: запланированный workflow, который вызывает Message → Get Many каждые 30–60 секунд, поймает всё, что триггер пропустил, пока экземпляр перезапускался.
Когда узла недостаточно
Узел покрывает типовой сценарий. Для отправки медиа, кодов сопряжения, подключения
номеров, обработки Idempotency-Key и всего остального из
справочника API используйте узел n8n HTTP Request с теми же
учётными данными: базовый URL https://developers.wasync.app/api/v1, заголовок
Authorization: Bearer <key>.