REST API v2.0 (Cloud API)

API Документация

Интегрируйте WhatsApp-рассылки, чат-ботов и аналитику в ваш продукт. Полное описание API, примеры кода и руководства.

Быстрый старт

Начните отправлять сообщения через API за 4 простых шага

Создание аккаунта

Зарегистрируйтесь и подтвердите email

Получите API-ключ

Сгенерируйте ключ в настройках дашборда

Подключите WhatsApp Business

Через Embedded Signup от Meta

Отправьте первое сообщение

Используйте API или дашборд

Аутентификация

API-ключ в заголовке

Все запросы к External API требуют заголовок X-API-Key. Создайте ключ в разделе Настройки → API-ключи в вашем дашборде.

Безопасное хранение

Ключи шифруются и не хранятся в открытом виде

Rate limiting

Защита от злоупотреблений с лимитами по тарифу

Отзыв в один клик

Деактивируйте скомпрометированный ключ мгновенно

bash

# Аутентификация через X-API-Key
curl -H "X-API-Key: wz_live_abc123def456" \
  https://wazzapo.kz/api/v1/external/phone-numbers

# Ответ: 200 OK
{
  "phone_numbers": [
    {
      "phone_number_id": "123456789012345",
      "display_phone_number": "+7 700 123 4567",
      "verified_name": "Wazzapo Demo",
      "quality_rating": "GREEN",
      "code_verification_status": "VERIFIED"
    }
  ]
}

Примеры кода

Отправьте первое сообщение на любом языке

bash

# 1. Получите API-ключ в Дашборд → Настройки → API
# 2. phone_number_id берётся из /api/v2/external/phone-numbers
# 3. template.name — имя одобренного Meta шаблона

curl -X POST https://wazzapo.kz/api/v2/external/messages/send \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number_id": "cf8b2428-f3f2-495c-928d-6f7db400a5b6",
    "to": "77001234567",
    "type": "template",
    "template": {
      "name": "order_confirmation_ru",
      "language": { "code": "ru" },
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "Айдар" },
            { "type": "text", "text": "12345" },
            { "type": "text", "text": "25 900" }
          ]
        }
      ]
    }
  }'

# Ответ:
# { "message_id": "abc...", "provider_message_id": "wamid...", "status": "accepted" }

API Endpoints

Базовый URL: https://wazzapo.kz/api/v1/external

POST/api/v2/external/messages/send

Отправка шаблона WhatsApp Cloud API

phone_number_idtotypetemplate

POST/api/v2/external/messages/send

Отправка медиа (image/video/audio/document)

phone_number_idtotypeimage|video|audio|document

GET/api/v2/external/phone-numbers

Список подключённых WhatsApp Business номеров с quality / tier

GET/api/v2/external/templates

Список ваших Meta-одобренных шаблонов

statuslanguage

POST/api/v2/external/templates

Отправка нового шаблона на модерацию Meta

namelanguagecategorycomponents

POSThttps://your-app.com/webhook

Webhook от Wazzapo — входящие сообщения и статусы доставки

настраивается в дашборде

Входящие webhook'и

Wazzapo шлёт POST-запросы на ваш URL для каждого входящего сообщения и обновления статуса доставки. URL настраивается в дашборде: Настройки → API → Webhook URL.

Входящее сообщение

POST /your-webhook-url
Content-Type: application/json
X-Wazzapo-Signature: hmac-sha256

{
  "type": "message",
  "phone_number_id": "cf8b...",
  "from": "77001234567",
  "message_type": "text",
  "text": "Здравствуйте",
  "timestamp": "2026-06-06T15:30:00Z",
  "wamid": "wamid.HBg..."
}

Обновление статуса

POST /your-webhook-url
Content-Type: application/json
X-Wazzapo-Signature: hmac-sha256

{
  "type": "status",
  "phone_number_id": "cf8b...",
  "message_id": "wamid.HBg...",
  "status": "delivered",  // sent | delivered | read | failed
  "to": "77001234567",
  "timestamp": "2026-06-06T15:30:05Z"
}

Проверяйте HMAC-подпись

Каждый запрос приходит с заголовком X-Wazzapo-Signature — hmac-sha256 от тела запроса с вашим webhook secret. Игнорируйте запросы с неверной подписью — это критично для безопасности.

Retry до 3 раз

При HTTP 5xx / timeout — exponential backoff (1s, 5s, 30s).

Idempotency key

Заголовок X-Idempotency-Key уникален для каждого события.

Подробные инструкции по всем возможностям платформы

Начало работы

Первые шаги с платформой
Подключение WhatsApp устройств
Импорт контактов из CSV
Создание первой рассылки

Автоматизация

Создание чат-ботов без кода
Визуальный конструктор workflows
Планировщик сообщений
Настройка вебхуков

Аналитика

Отчеты по доставке
Метрики вовлечённости
Воронка продаж
Экспорт данных

Управление

Командная работа и роли
Биллинг и тарифы
Безопасность аккаунта
API-ключи и доступы

Часто задаваемые вопросы

Ответы на популярные вопросы по API

Готовы к интеграции?

Создайте бесплатный аккаунт и начните отправлять сообщения через API уже через 5 минут

Начать бесплатно Связаться с поддержкой