| Dokumentatsiya

Foydalanish holatlari

Xabarchi API bilan keng tarqalgan integratsiya usullarini o'rganing.

Ommaviy ovozli xabarlar yuborish

Ish jarayoni

  1. Guruh yarating → POST /api/groups
  2. Mijozlarni qo'shing → POST /api/groups/:id/clients
  3. Audio yarating/yuklang → POST /api/audios
  4. Navbat yarating → POST /api/queues
  5. Jarayonni kuzating → GET /api/queues/:id/stats

Misol

1. Guruh yarating:

bash 
curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"VIP Customers","description":"High-value clients"}' \
  https://api.xabarchi.live/api/groups

# Response: {"id":"group-123",...}

2. Mijozlarni qo'shing:

bash 
curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber":"+998901234567","name":"John Doe"}' \
  https://api.xabarchi.live/api/groups/group-123/clients

3. Audio yarating/yuklang:

bash 
curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Promo","text":"Assalomu alaykum! Maxsus chegirma!","gender":"FEMALE","language":"uz"}' \
  https://api.xabarchi.live/api/audios

# Response: {"id":"audio-456",...}

4. Navbat yarating:

bash 
curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"VIP Promo Campaign","groupId":"group-123","audioId":"audio-456"}' \
  https://api.xabarchi.live/api/queues

# Response: {"queueId":"queue-789","jobId":"job-abc"}

5. Jarayonni kuzating:

bash 
curl -H "Authorization: Bearer $TOKEN" \
  https://api.xabarchi.live/api/queues/queue-789/stats

Balans va foydalanishni tekshirish

Ish jarayoni

  1. Holatni tekshiring → GET /api/auth/balance-status
  2. Tarixni ko'ring → GET /api/auth/balance-history

Balans holatini tekshiring:

bash 
curl -H "Authorization: Bearer $TOKEN" \
  https://api.xabarchi.live/api/auth/balance-status

# Response:
# {
#   "currentBalance": 50000,
#   "averageDailySpend": 2500,
#   "estimatedDaysRemaining": 20,
#   "estimatedMinutesRemaining": 500,
#   "lowBalanceAlert": false,
#   "canProcess": true
# }

Tranzaksiyalar tarixini ko'ring:

bash 
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.xabarchi.live/api/auth/balance-history?page=1&limit=20"

Excel dan kontaktlarni import qilish

Ish jarayoni

  1. phoneNumber va name ustunlari bilan Excel faylni tayyorlang: phoneNumber, name
  2. Yuklang → POST /api/groups/:id/import
  3. Jarayonni kuzating → GET /api/groups/import/:jobId

Excel formati

phoneNumber name
+998901234567 John Doe
+998901234568 Jane Smith

Excel faylni yuklang:

bash 
curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@contacts.xlsx" \
  https://api.xabarchi.live/api/groups/group-123/import

# Response: {"jobId":"import-xyz","message":"Import started"}

Import jarayonini kuzating:

bash 
curl -H "Authorization: Bearer $TOKEN" \
  https://api.xabarchi.live/api/groups/import/import-xyz

# Response:
# {
#   "jobId":"import-xyz",
#   "status":"completed",
#   "totalRows":1000,
#   "importedCount":985,
#   "skippedCount":10,
#   "errorCount":5
# }