Ana içeriğe atla
GET
/
user
/
whatsapp
/
session-status
curl -X GET "https://app.whattalk.ai/api/user/whatsapp/session-status?sender_id=12&recipient_phone=+1234567890" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "has_conversation": true,
  "conversation_id": 1234,
  "customer_name": "John Doe",
  "last_customer_message_at": "2026-02-24T10:30:00+00:00",
  "session_status": {
    "is_open": true,
    "can_send_freeform": true,
    "requires_template": false,
    "message": "Session open (23 hr 45 min remaining). Unlimited free-form messages allowed.",
    "minutes_remaining": 1425,
    "expires_at": "2026-02-25T10:30:00+00:00"
  }
}
Bu endpoint, WhatsApp göndereniz ile belirli bir alıcı arasında aktif bir 24 saatlik mesajlaşma penceresinin olup olmadığını kontrol eder. Bunu serbest form mesajlar gönderip gönderemeyeceğinizi veya şablon mesajı kullanmanız gerekip gerekmediğini belirlemek için kullanın.

​
Sorgu Parametreleri

​
sender_id
integer
gerekli
WhatsApp göndereninin kimliği (Gönderenleri Getir endpoint’inden elde edilir)
​
recipient_phone
string
gerekli
Alıcının uluslararası formattaki telefon numarası (ör. +1234567890)

​
Yanıt Alanları

​
success
boolean
İsteğin başarılı olup olmadığı
​
has_conversation
boolean
Bu alıcıyla bir konuşmanın mevcut olup olmadığı
​
conversation_id
integer
Konuşma kimliği (yalnızca has_conversation true olduğunda mevcuttur)
​
customer_name
string
Müşterinin adı (mevcutsa, yalnızca has_conversation true olduğunda mevcuttur)
​
last_customer_message_at
string
Müşterinin son mesajının ISO 8601 zaman damgası (yalnızca has_conversation true olduğunda mevcuttur)
​
session_status
object

​
Hata Yanıtları

​
404 Not Found
curl -X GET "https://app.whattalk.ai/api/user/whatsapp/session-status?sender_id=12&recipient_phone=+1234567890" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "has_conversation": true,
  "conversation_id": 1234,
  "customer_name": "John Doe",
  "last_customer_message_at": "2026-02-24T10:30:00+00:00",
  "session_status": {
    "is_open": true,
    "can_send_freeform": true,
    "requires_template": false,
    "message": "Session open (23 hr 45 min remaining). Unlimited free-form messages allowed.",
    "minutes_remaining": 1425,
    "expires_at": "2026-02-25T10:30:00+00:00"
  }
}

​
Tipik İş Akışı

Bu endpoint’i mesaj gönderme akışının bir parçası olarak kullanın:
  1. Mesaj göndermeden önce oturum durumunu kontrol edin
  2. can_send_freeform true ise -> Serbest Form Mesaj Gönder kullanın
  3. requires_template true ise -> Şablon Mesajı Gönder kullanın

​
Notlar

  • 24 saatlik pencere, müşterinin son gelen mesaj zaman damgasına dayanır.
  • Her yeni müşteri mesajı 24 saatlik zamanlayıcıyı sıfırlar.
  • Bu endpoint bakiye tüketmez — yalnızca okuma amaçlı bir durum kontrolüdür.