Ana içeriğe atla
POST
/
user
/
whatsapp
/
send
curl -X POST "https://app.whattalk.ai/api/user/whatsapp/send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": 12,
    "template_id": 45,
    "recipient_phone": "+1234567890",
    "recipient_name": "John Doe",
    "variables": {
      "1": "John",
      "2": "January 15, 2026",
      "3": "2:00 PM"
    }
  }'

{
  "success": true,
  "conversation_id": 1234,
  "message_id": 567,
  "whatsapp_message_id": 890,
  "message_sid": "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "status": "queued"
}
Bu endpoint, önceden onaylanmış bir şablon kullanarak WhatsApp mesajı gönderir. Şablon mesajları, bir kullanıcıyla ilk kez konuşma başlatırken veya 24 saatlik mesajlaşma penceresi dışında mesaj gönderirken gereklidir.
Bu endpoint, kullanıcı başına saniyede 5 istek ile hız sınırlıdır.

​
İstek Gövdesi

​
sender_id
integer
gerekli
Mesajın gönderileceği WhatsApp göndereninin kimliği (Gönderenleri Getir endpoint’inden elde edilir)
​
template_id
integer
gerekli
Kullanılacak mesaj şablonunun kimliği (Şablonları Getir endpoint’inden elde edilir)
​
recipient_phone
string
gerekli
Alıcının uluslararası formattaki telefon numarası (ör. +1234567890)
​
recipient_name
string
Alıcının adı, maksimum 255 karakter (konuşma takibi ve CRM amaçları için kullanılır)
​
variables
object
Şablon değişkenleri için anahtar-değer çiftleri. Anahtarlar şablondaki değişken adlarıyla eşleşmelidir. Şablonda {{1}}, {{2}} vb. değişkenler varsa, bunları {"1": "değer1", "2": "değer2"} olarak veya şablonun variables dizisindeki adlandırılmış anahtarları kullanarak sağlayın.

​
Yanıt Alanları

​
success
boolean
Mesajın başarıyla gönderilip gönderilmediği
​
conversation_id
integer
Bu mesajla ilişkili konuşma kimliği (yeni veya mevcut)
​
message_id
integer
Konuşma mesajı kaydının kimliği
​
whatsapp_message_id
integer
WhatsApp mesaj kaydının kimliği
​
message_sid
string
Teslimat takibi için Twilio mesaj SID’i
​
status
string
İlk mesaj teslim durumu (ör. queued, sent)

​
Hata Yanıtları

​
402 Insufficient Balance
​
404 Not Found
​
422 Unprocessable Entity
curl -X POST "https://app.whattalk.ai/api/user/whatsapp/send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": 12,
    "template_id": 45,
    "recipient_phone": "+1234567890",
    "recipient_name": "John Doe",
    "variables": {
      "1": "John",
      "2": "January 15, 2026",
      "3": "2:00 PM"
    }
  }'

{
  "success": true,
  "conversation_id": 1234,
  "message_id": 567,
  "whatsapp_message_id": 890,
  "message_sid": "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "status": "queued"
}

​
Notlar

  • Şablon mesajları onaylanmış şablonları kullanmalıdır. pending veya rejected durumundaki şablonlar başarısız olur.
  • Gönderen online olmalıdır. Çevrimdışı gönderenler mesaj gönderemez.
  • Mesaj maliyetleri otomatik olarak hesap bakiyenizden düşülür (kiracı kullanıcılar için kredi, doğrudan kullanıcılar için dakika).
  • Bir şablon mesajı gönderdikten sonra 24 saatlik mesajlaşma penceresi açılır. Bu pencere süresince şablon gerektirmeden serbest form mesajlar gönderebilirsiniz.
  • Alıcıyla zaten bir konuşma mevcutsa, mesaj mevcut konuşmaya eklenir.
  • Hız limiti: Kullanıcı başına saniyede 5 istek.