Bekleyen Mesajları Alma

Mobil Uygulama Entegrasyon Kılavuzu

Bekleyen Mesajları Alma

GET /?endpoint=pending_messages

Giden kuyruktan gönderilmeye hazır bir mesaj grubu döndürür. API, döndürülen mesajları atomik olarak sahiplenir (durum -> processing); böylece eşzamanlı cihaz istekleri aynı mesajları almaz.

Sorgu Parametreleri

Alan	Tür		Açıklama
limit	integer	isteğe bağlı	Döndürülecek en fazla mesaj sayısı (1-100, varsayılan 50).
channel	string	isteğe bağlı	Kanala göre filtreleyin: `sms` veya `whatsapp`. Tümü için boş bırakın.

Önce bu cihaza atanmış mesajlar, ardından atanmamış mesajlar döndürülür. Liste döndürüldükten sonra sunucu sahiplenme işaretini temizler; böylece normal durum geçişleri uygulanır.

Örnek İstek

cURL

curl "https://api.rcszilla.com/?endpoint=pending_messages&limit=10&channel=sms" \
  -H "Authorization: Bearer YOUR-DEVICE-TOKEN"

Yanıt

JSON200 OK

{
  "success": true,
  "count": 2,
  "messages": [
    {
      "id": 101,
      "user_id": 1,
      "contact_id": 55,
      "campaign_id": null,
      "device_id": 7,
      "sim_slot": 0,
      "channel": "sms",
      "phone": "+40712345678",
      "message": "Hello from SMS Manager!",
      "priority": 1,
      "scheduled_at": null,
      "created_at": "2026-04-29 10:00:00"
    },
    {
      "id": 102,
      "user_id": 1,
      "contact_id": 56,
      "campaign_id": 3,
      "device_id": null,
      "sim_slot": 1,
      "channel": "sms",
      "phone": "+40799999999",
      "message": "Campaign message body here.",
      "priority": 1,
      "scheduled_at": null,
      "created_at": "2026-04-29 10:00:05"
    }
  ]
}

Message Fields

Alan	Tür	Açıklama
id	integer	Unique queue item ID. Pass to all `mark_*` endpoints.
channel	string	`sms` or `whatsapp`
phone	string	Recipient phone number.
message	string	Message body text.
sim_slot	integer	`0` = SIM 1, `1` = SIM 2, `null` = any.
device_id	integer\|null	Device this message is assigned to (null = any device).
campaign_id	integer\|null	Campaign this message belongs to, or null for direct messages.
priority	integer	Lower number = higher priority. Sorted ascending.
scheduled_at	datetime\|null	Only returned when `scheduled_at �?NOW()`.

Prefer using poll instead �?it returns pending messages together with commands and config in a single request, reducing round trips.