Быстрый старт с WazzaBee API
Это краткое руководство поможет вам отправить первое сообщение через API за 5 минут.
💡 Что вам понадобится:
- Аккаунт WazzaBee с подключённой линией связи (WhatsApp, Telegram)
- API-ключ из раздела «Коннекторы → API»
Шаг 1. Получите API-ключ
- Войдите в личный кабинет WazzaBee
- Перейдите в раздел Коннекторы
- Нажмите «Подключить» на карточке API
- Скопируйте сгенерированный 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-документация:
- Авторизация — как устроена аутентификация по API-ключу
- Отправка сообщений — текст, медиа, все параметры
- История сообщений — пагинация, фильтрация
- Линии связи (каналы) — получение списка каналов
- Webhooks — настройка и получение уведомлений
- Встраивание чата (iframe) — встройте чат WazzaBee в вашу CRM
- Ошибки и лимиты — коды ошибок и рекомендации
