Bu belgede, İşletmeler için RCS platformunun mesaj gönderme ve diğer API etkileşimlerini nasıl işlediği, senkron ve asenkron işlemler arasındaki farklar açıklanarak netleştirilmektedir.
RBM API etkileşimleri genellikle HTTP düzeyinde senkronize istek-yanıt kalıbını izler. Ancak özellikle ileti teslimi 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.
İleti gönderme: Eşzamanlı istek, eşzamansız teslimat
phones.agentMessages.create
API isteği, API açısından eşzamanlı olarak işlenir. İş için RCS platformuna bir HTTP isteği gönderdiğinizde sunucu, isteğin alınıp alınmadığını ve geçerli olup olmadığını belirtmek için neredeyse anında standart bir HTTP durum koduyla (ör. 200 OK veya bir hata) yanıt verir.
Ancak iletinin son kullanıcıya gerçek teslimatı eşzamansız olarak işlenir. Bu süreci aşağıdaki faktörler etkileyebilir:
- Alıcı durumu: Kullanıcı çevrimdışı olabilir, pilinin şarjı bitmiş olabilir veya RCS'yi etkinleştirmemiş olabilir.
- Ağ koşulları: Operatör ağı sorunları, mesaj teslimatını geciktirebilir veya engelleyebilir.
İşletmeler için RCS platformu, webhook'lar aracılığıyla mesaj teslim durumu güncellemelerini (ör. teslimat bilgileri ve okundu bilgileri) eşzamansız olarak sağlar.
Bu nedenle, ilk API isteği senkronize olsa da mesaj teslimini izlemek için asenkron webhook etkinliklerini kullanmanız gerekir. phones.agentMessages.create yanıtından teslimat durumunun hemen onaylanmasını beklemeyin.
Diğer RBM API etkileşimleri
HTTP tabanlı diğer RBM API'lerinin çoğu da senkron istek-yanıt modeliyle çalışır. Bu API'ler, isteğin durumunu (başarılı veya hatalı) belirten anında bir HTTP yanıtı sağlar. Ancak istek eşzamanlı olsa da istekten kaynaklanan işlemler eşzamansız süreçler içerebilir. Örneğin, aracı bilgilerini güncellemek için yapılan bir API çağrısına verilen başarılı yanıt, güncellemenin her yerde anında yansıtıldığı anlamına gelmez. Kısa bir yayılma gecikmesi olabilir.
Webhook uç noktası: Eşzamansız etkinlikler
Aşağıdaki etkinlikler, webhook uç noktanıza eşzamansız olarak iletilir:
- Gelen kullanıcı mesajları: Business için RCS platformu, gelen kullanıcı mesajlarını webhook uç noktanıza gönderir. Gelen iletileri doğruladığınızdan emin olun.
- Teslim ve okunma bilgileri: 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üresinin dolması ve iptal edilmesi: İşletmeler için RCS platformu, süresi dolan bir mesajın başarıyla iptal edilip edilmediğini onaylamak için etkinlikler gönderir.