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

    5 мин чтения
    ·
    118 просмотров
    ·
    Обновлено 7 сентября 2026

    Быстрый старт с WazzaBee API

    Это краткое руководство поможет вам отправить первое сообщение через API за 5 минут.

    💡 Что вам понадобится:
    • Аккаунт WazzaBee с подключённой линией связи (WhatsApp, Telegram)
    • API-ключ из раздела «Коннекторы → API»

    Шаг 1. Получите API-ключ

    1. Войдите в личный кабинет WazzaBee
    2. Перейдите в раздел Коннекторы
    3. Нажмите «Подключить» на карточке API
    4. Скопируйте сгенерированный API-ключ
    ⚠️ Важно: API-ключ показывается только один раз. Сохраните его в надёжном месте.

    Шаг 2. Узнайте ID вашего канала

    Получите список подключённых линий связи (каналов):

    curl -X GET "https://api.wazzabee.com/api-gateway/v1/channels" \
      -H "Authorization: Bearer ВАШ_API_КЛЮЧ"

    Ответ:

    {
      "success": true,
      "channels": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "name": "WhatsApp Основной",
          "type": "whatsapp_qr",
          "status": "active"
        }
      ]
    }

    Скопируйте id нужного канала — он понадобится для отправки сообщений.

    Шаг 3. Отправьте первое сообщение

    curl -X POST "https://api.wazzabee.com/api-gateway/v1/messages/send" \
      -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
      -H "Content-Type: application/json" \
      -d '{
        "channelId": "550e8400-e29b-41d4-a716-446655440000",
        "chatId": "77001234567",
        "text": "Привет! Это тестовое сообщение из WazzaBee API."
      }'

    Ответ (202 Accepted):

    {
      "success": true,
      "queued": true,
      "queueId": "uuid-очереди",
      "message": "Сообщение поставлено в очередь на отправку"
    }
    ℹ️ Обратите внимание: Сообщения отправляются асинхронно через очередь. Статус 202 означает, что сообщение принято и будет доставлено в ближайшие секунды.

    Шаг 4. Настройте получение входящих (опционально)

    Чтобы получать уведомления о входящих сообщениях, настройте webhook:

    curl -X PATCH "https://api.wazzabee.com/api-gateway/v1/webhooks" \
      -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
      -H "Content-Type: application/json" \
      -d '{
        "webhooksUri": "https://ваш-сервер.com/webhook/wazzabee",
        "subscriptions": ["messages_incoming"]
      }'

    Что дальше?

    Подробная документация по каждому эндпоинту доступна в разделе API-документация: