Push Mesaj

POST /push-message

Belirli bir telefona, onaylı template üzerinden outbound mesaj (ör. WhatsApp) tetikler.

Bu özellik, Mesaj Gönderme endpoint’indeki 24 saat penceresi dolduğunda kullanıcıya yeniden ulaşmak için kullanılır. Aktif konuşma (son 24 saat) içindeyseniz mevcut sohbete mesaj için /message/send tercih edilir; süre aşılmışsa push mesaj gerekir.

Header: x-access-token zorunludur. Ayrıntılar: Kimlik doğrulama.

İstek

POST /push-message HTTP/1.1
Host: client-api.chatbot.aithinks.net
Content-Type: application/json
x-access-token: <sirket-access-token>

Body alanları

Alan	Tip	Zorunlu	Açıklama
templateId	uuid	Evet	Mesaj template kimliği
source	string	Evet	Telefon numarası (min. 11 karakter)
username	string	Hayır	Kullanıcı adı (min. 3 karakter)

username gönderilmezse alıcı adı set edilmez.

Örnek

await fetch(`${BASE_URL}/push-message`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-access-token': ACCESS_TOKEN,
  },
  body: JSON.stringify({
    templateId: '22222222-2222-2222-2222-222222222222',
    source: '905551234567',
    username: 'Jane Doe',
  }),
});

curl -X POST https://client-api.chatbot.aithinks.net/push-message \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_TOKEN" \
  -d '{
    "templateId": "22222222-2222-2222-2222-222222222222",
    "source": "905551234567",
    "username": "Jane Doe"
  }'

Başarılı yanıt

{
  "message": "Message sent successfully"
}

Hatalar

Kod	Durum
400	Validasyon hatası
401	Token eksik / geçersiz
404	Template bulunamadı

Ortak hata gövdesi: Hata formatı.