WazzaBee API-мен жылдам бастау
Бұл қысқа нұсқаулық API арқылы алғашқы хабарламаны 5 минутта жіберуге көмектеседі.
💡 Сізге не қажет:
- Байланыс желісі (WhatsApp, Telegram) қосылған WazzaBee аккаунты
- «Коннекторлар → 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 жүйеңізге кірістіріңіз
- Қателер мен лимиттер: қате кодтары және ұсыныстар
