Geliştirici API Dökümanları

YTA AI'nin gücünü kendi uygulamalarınıza entegre edin. REST API'miz ile otomasyonlarınızı bir üst seviyeye taşıyın.

Başlarken

YTA AI REST API, panelde yaptığınız birçok işlemi programatik olarak gerçekleştirmenize olanak tanır. API'ye yapılan tüm istekler için bir API anahtarına ihtiyacınız olacaktır. Anahtarınızı panelinizdeki "Ayarlar" bölümünden alabilirsiniz.

Tüm istekler https://api.ytai.com/v1/ ana URL'sine yapılmalıdır ve Authorization: Bearer YOUR_API_KEY header'ını içermelidir.

Mesaj Gönderme

Belirtilen bir WhatsApp numarasına mesaj göndermenizi sağlar.

POST /messages/send

Parametreler (Body)

  • number (string, Gerekli): Ülke koduyla birlikte WhatsApp numarası. Örn: "905551234567".
  • message (string, Gerekli): Gönderilecek metin mesajı.

Örnek İstek (cURL)

curl -X POST 'https://api.ytai.com/v1/messages/send' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
  "number": "905551234567",
  "message": "Merhaba, bu bir test mesajıdır."
}'

Örnek Başarılı Yanıt (200 OK)

{
  "success": true,
  "message": "Mesaj başarıyla gönderim kuyruğuna eklendi.",
  "messageId": "gbe4e5f6g7h8"
}

Sohbetleri Listeleme

Hesabınızdaki son aktif sohbetleri listeler.

GET /conversations

Örnek Başarılı Yanıt (200 OK)

{
  "success": true,
  "data": [
    {
      "customer_number": "905551234567",
      "last_message": "Sipariş durumumu öğrenebilir miyim?",
      "timestamp": "2023-10-27T14:30:00Z"
    },
    {
      "customer_number": "905559876543",
      "last_message": "Teşekkürler!",
      "timestamp": "2023-10-27T14:25:10Z"
    }
  ]
}