Skip to main content
GET
/
user
/
whatsapp
/
session-status
curl -X GET "https://call.aiployees.com/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"
  }
}
Този endpoint проверява дали съществува активен 24-часов прозорец за съобщения между вашия WhatsApp изпращач и конкретен получател. Използвайте го, за да определите дали можете да изпращате свободни съобщения или трябва да използвате шаблонно съобщение.

​
Query параметри

​
sender_id
integer
required
ID на WhatsApp изпращача (получено от endpoint-а Получаване на изпращачи)
​
recipient_phone
string
required
Телефонният номер на получателя в международен формат (например +1234567890)

​
Полета в отговора

​
success
boolean
Дали заявката е била успешна
​
has_conversation
boolean
Дали съществува разговор с този получател
​
conversation_id
integer
ID на разговора (присъства само когато has_conversation е true)
​
customer_name
string
Името на клиента, ако е налично (присъства само когато has_conversation е true)
​
last_customer_message_at
string
ISO 8601 timestamp на последното съобщение на клиента (присъства само когато has_conversation е true)
​
session_status
object

​
Грешки в отговора

​
404 Not Found
curl -X GET "https://call.aiployees.com/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"
  }
}

​
Типичен работен процес

Използвайте този endpoint като част от процеса за изпращане на съобщения:
  1. Проверете статуса на сесията преди да изпратите съобщение
  2. Ако can_send_freeform е true → използвайте Изпращане на свободно съобщение
  3. Ако requires_template е true → използвайте Изпращане на шаблонно съобщение

​
Забележки

  • 24-часовият прозорец се базира на timestamp-а на последното входящо съобщение от клиента.
  • Всяко ново съобщение от клиента нулира 24-часовия таймер.
  • Този endpoint не консумира никакъв баланс — това е само проверка на статуса за четене.