Gönderim durumları

Her gönderim aynı durumlardan geçer. Sayaçlar gönderim belgesindedir; her parça bitince mesajlar tek tek sayılmaz.

Yaşam döngüsü

materializing liste üretiliyor demektir. Parçalar bitince durum queued olur ve ancak o anda operatöre iletilir. İlk parça claim edilince processing, sent + failed + canceled alıcı sayısına ulaşınca completed olur. status sorgu parametresiyle liste bu durumlara göre süzülür.

İptal canceled yazar. Bu uç milyonlarca satırı kendisi kapatmaz; worker bekleyenleri kapatır. Zaten iletilmiş paket geri alınmaz. Tamamlanmış veya iptal edilmiş iş yeniden iptal edilmez (400).

Takılan liste, kaybolan sinyal ve kalıcı hatalı mesaj panelde gönderim detayından yeniden kuyruğa alınır; bu işlemler API anahtarına açık değildir.

Gönderim sonucu

Worker sonucu beşe ayırır:

Sonuç	Ne olur
`accepted`	Satır `sent`.
`retryable`	Aynı parti kısa süre sonra yeniden gider. Yalnızca zarfsız beklenmeyen yanıt ve tamamlanamayan istek buradadır.
`permanent`	Satır `failed`. Hesap geneli bir durum bu sınıfa girmez.
`blocked`	Gönderim durur, satır `failed` olmaz. Kontör, yanlış kimlik, tanınmayan hata kodu buradadır. Gerekçe gönderim belgesinin `error` alanındadır.
`ambiguous`	Zaman aşımı veya okunamayan yanıt. Parti yeniden gönderilmez; kararı operatör panelden verir.

GET …/errors düşen gerekçeleri gruplar. Telefon ve metin bu özette yoktur.

Teslim raporu

sent “operatör kabul etti” demektir, teslim edildiğini söylemez. Paket gönderimden 10 dakika, 15 dakika, 30 dakika, 1 saat, 6 saat ve 24 saat sonra yoklanır. Sonuç alıcıda deliveryState olarak durur. Teslim raporu her operatörde gelmeyebilir; gelmeyen alıcı unknown kalır. Rapor birkaç denemede okunamazsa alıcılar pending kalabilir; bu durum müşteri yanıtında ayrı bir alan olarak dönmez.

`deliveryState`

Değer	Anlam
`pending`	Henüz rapor yok ya da operatörde bekliyor.
`delivered`	Telefona ulaştı.
`undelivered`	Teslim edilemedi.
`expired`	Geçerlilik süresi doldu.
`rejected`	Operatör reddetti.
`canceled`	Teslimden önce geri çekildi.
`unknown`	Rapor yok ya da tanınmayan durum.

deliveryState=problem süzgeci gönderilemeyen (failed) ile undelivered, expired ve rejected satırlarını birlikte getirir.

Alıcı alanları

Alan	Anlam
`deliveredAt`	Operatörün bildirdiği teslim anı. Yalnızca `delivered` iken dolu olabilir.
`deliveryError`	Operatörün satır raporundaki ham gerekçe. Biçimi sabit değildir.
`error`	Gönderim anındaki hata. Teslim raporu buraya yazılmaz.

Gönderim alanları

Gönderim detayındaki report sayaçları yoklama sonuçlarını toplar: delivered, undelivered, pending, expired, unknown. report.unknown reddedilenleri de içerir; canceled sayacı dışarı verilmez. firstPolledAt ilk yoklama anı, finalPolledAt son yoklama anıdır.

Ayrıntılı uçlar Gönderim sayfasındadır.