API Referansı

Kimlik Doğrulama

Tüm API istekleri session tabanlı kimlik doğrulama gerektirir. Önce giriş endpoint'ini kullanarak oturum açın.

// Oturum Açma
POST /api/auth/login
Content-Type: application/json

{
  "username": "user@example.com",
  "password": "your_password"
}
            

Mesaj API

POST /api/send-message

WhatsApp mesajı gönderir. Metin, medya veya şablon mesaj gönderilebilir.

POST /api/send-message
Content-Type: application/json

{
  "phone": "905551234567",
  "message": "Merhaba! Siparişiniz hazırlandı.",
  "account_id": 1
}
            

GET /api/conversations

Konuşma geçmişini listeler. Sayfalama ve filtreleme destekler.

GET /api/conversations/:phone

Belirli bir numara ile olan mesaj geçmişini getirir.

Kampanya API

GET /api/campaigns

Tüm kampanyaları listeler.

POST /api/campaigns

Yeni kampanya oluşturur.

POST /api/campaigns/:id/start

Kampanyayı başlatır.

POST /api/campaigns/:id/pause

Kampanyayı duraklatır.

Sipariş API

GET /api/orders

Tüm siparişleri listeler. Durum, tarih ve müşteriye göre filtreleme destekler.

PUT /api/orders/:id/status

Sipariş durumunu günceller ve müşteriye otomatik bildirim gönderir.

Webhook API

GET /api/webhooks

Yapılandırılmış webhook'ları listeler.

POST /api/webhooks

Yeni webhook oluşturur.

// Webhook Oluşturma
POST /api/webhooks
Content-Type: application/json

{
  "url": "https://your-app.com/webhook",
  "events": ["message.received", "message.sent"],
  "secret": "your_hmac_secret"
}
            

Webhook Payload Örneği

// Gelen mesaj webhook payload
{
  "event": "message.received",
  "timestamp": "2026-03-25T14:30:00Z",
  "data": {
    "from": "905551234567",
    "message": "Merhaba, sipariş vermek istiyorum",
    "type": "text",
    "account_id": 1
  },
  "signature": "hmac_sha256_signature"
}
            

Hız Sınırları

Plan	İstek / Dakika	Günlük Limit
Başlangıç	60	5,000
Profesyonel	300	50,000
Kurumsal	Sınırsız	Sınırsız