WAIXAPI
ВойтиСоздать аккаунт
SDK · Node.js

WhatsApp API для Node.js

waix-node собирает запросы к API v1, передаёт ключ авторизации и возвращает ответы WAIX. Вы работаете с сообщениями и кодами подтверждения из своего приложения.

Как проходит сообщение
SDK · Node.jsСобытие вашей системыWAIX API v1Шаблон и данные клиентаWhatsAppСообщение, ответ, статус

Ответы и статусы возвращаются в вашу систему через вебхуки. Настройка выполняется один раз.

01

Подготовьте подключение

Node.js 20 или новее. ESM, CommonJS и типы TypeScript входят в пакет. Дополнительных зависимостей нет.

Для сообщений подключите свой номер и создайте API-ключ. Найдите Connection ID в кабинете, одобрите шаблон order_ready с одной переменной или замените пример на свой шаблон.

02

Установите SDK

Пакет опубликован в npm. Русская инструкция, примеры и исходный код доступны в его репозитории.

Пример кода: Установите SDK
npm install waix-node
Пакет в npm →
03

Отправьте уведомление о заказе

Ключ и Connection ID читаются из переменных окружения на сервере. UUID операции сохраните в базе до вызова SDK. Пример использует шаблон с одной переменной — номером заказа.

Пример кода: Отправьте уведомление о заказе
import { Waix } from 'waix-node';
import { randomUUID } from 'node:crypto';

const waix = new Waix(process.env.WAIX_API_KEY);
// Сохраните UUID в записи заказа до отправки.
const eventId = randomUUID();
const { data } = await waix.messages.send({
  connection_id: process.env.WAIX_CONNECTION_ID,
  to: '+77071234567',
  type: 'template',
  template: {
    name: 'order_ready',
    language: { code: 'ru' },
    components: [{ type: 'body', parameters: [
      { type: 'text', text: '42' }
    ] }]
  }
}, eventId);
04

Обработайте результат

Методы возвращают весь ответ API, включая data и курсор следующей страницы. HTTP 202 означает, что сообщение поставлено в очередь. Статус доставки проверяется по вебхуку или в журнале.

При ошибке доступны status, code, requestId, retryAfter. Тайм-аут по умолчанию — 30 секунд. Автоматических повторов нет: при сетевом сбое сохраните исходные параметры и ключ идемпотентности.

05

OTP и подписи вебхуков

Для OTP создайте sandbox-проект и ключ с нужными правами. Доступны создание тестового кода, проверка и статус. Для реальных сообщений нужны ключ Live-проекта и действующий OTP-пакет. Sandbox не подтверждает владение телефоном и не подходит для входа настоящих пользователей.

Проверяйте HMAC вебхука на исходных байтах до разбора JSON. SDK учитывает подпись и время запроса. В приложении также сохраняйте ID события, чтобы не обработать повторную доставку дважды.

Полная инструкция SDK Node.js →OTP API →Проверка вебхуков →
Исходный код, тесты и релизы ↗

Сколько стоит подключение

Для собственного номера оплачивается подписка WAIX в тенге, а сообщения — напрямую Meta с карты в вашем WhatsApp Business Account. Количество номеров и сумму можно рассчитать на странице тарифа. Для OTP доступен отдельный пакет; проверить интеграцию можно в бесплатном sandbox.

Рассчитать подписку →Оплата сообщений Meta →

Проверьте интеграцию на своём сценарии

Начните с подключения номера и одного сообщения. Если внедряете WhatsApp клиентам, приглашайте их по своей партнёрской ссылке — она появится в кабинете после регистрации.

Создать аккаунт →Партнёрская программа