Bu belgede, RBM platformunun mesaj gönderme ve diğer API etkileşimlerini senkron ve asenkron işlemler arasında ayırt ederek nasıl işlediği açıklanmaktadır.
RBM API etkileşimleri genellikle HTTP düzeyinde senkronize bir istek-yanıt kalıbını izler. Ancak özellikle mesaj yayınlama olmak üzere birçok API çağrısının sonuçları, webhook'lar aracılığıyla eşzamansız olarak işlenir. Ayrıntılar için aşağıdaki bölümlere bakın.
Mesaj gönderme: Senkronize istek, eşzamansız yayınlama
phones.agentMessages.create API isteği, API açısından eşzamanlı olarak işlenir. RBM platformuna HTTP isteği gönderdiğinizde sunucu, isteğin alınıp alınmadığını ve geçerli olup olmadığını belirtmek için hemen hemen standart bir HTTP durum koduyla (200 OK veya hata gibi) yanıt verir.
Ancak mesajın son kullanıcıya gerçek teslimatı eşzamansız olarak işlenir. Bu süreci etkileyen faktörler şunlardır:
- Alıcı durumu: Kullanıcı çevrimdışı olabilir, pili boş olabilir veya RCS etkin olmayabilir.
- Ağ koşulları: Operatör ağı sorunları, iletilerin teslimini geciktirebilir veya engelleyebilir.
RBM platformu, webhooks aracılığıyla ileti teslim durumu güncellemelerini (ör. teslim alındı ve okundu bilgileri) eşzamansız olarak sağlar.
Bu nedenle, ilk API isteği senkronize olsa da ileti yayınını izlemek için asenkron webhook etkinliklerini kullanmanız gerekir. phones.agentMessages.create yanıtından hemen teslimat durumu onayı alamazsınız.
Diğer RBM API etkileşimleri
HTTP tabanlı diğer RBM API'lerinin çoğu da senkronize istek-yanıt modeliyle çalışır. Bu API'ler, isteğin durumunu (başarı veya hata) belirten anında bir HTTP yanıtı sağlar. Ancak istek senkronize olsa da istek sonucunda yapılan işlemler asenkron süreçler içerebilir. Örneğin, müşteri temsilcisi bilgilerini güncellemek için yapılan bir API çağrısına verilen başarılı yanıt, güncellemenin her yere anında yansıtıldığı anlamına gelmez. Kısa bir dağıtım gecikmesi olabilir.
Webhook uç noktası: Eşzamansız etkinlikler
Aşağıdaki etkinlikler, webhook uç noktanıza eşzamansız olarak gönderilir:
- Gelen kullanıcı mesajları: RBM platformu, gelen kullanıcı mesajlarını webhook uç noktanıza gönderir. Gelen iletileri doğruladığınızdan emin olun.
- Teslim ve okundu bilgisi: Mesaj teslimi ve okunma durumuyla ilgili bildirimler webhook'lar aracılığıyla gönderilir.
- Görüşme etkinlikleri: Yazma göstergeleri gibi görüşmeyle ilgili bazı etkinlikler webhook'lar aracılığıyla gönderilir.
- Mesajın süresi sonu ve iptal etkinlikleri: RBM platformu, süresi dolmuş bir mesajın başarıyla iptal edilip edilmediğini doğrulamak için etkinlikler gönderir.