new_releases Güncellemeler: Yeni özellikler ve ürün güncellemeleri için
sürüm notlarına bakın.
RBM'de eşzamanlı ve eşzamansız işlemler
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-02-10 UTC.
[null,null,["Son güncelleme tarihi: 2025-02-10 UTC."],[[["\u003cp\u003eRBM API interactions use a synchronous request-response model at the HTTP level, providing immediate feedback on request validity.\u003c/p\u003e\n"],["\u003cp\u003eMessage delivery in the RBM platform is processed asynchronously, relying on webhooks for updates due to factors like recipient status and network conditions.\u003c/p\u003e\n"],["\u003cp\u003eWhile the initial API request for sending messages is synchronous, delivery and read receipts are provided asynchronously through webhook events.\u003c/p\u003e\n"],["\u003cp\u003eOther RBM API interactions follow a synchronous pattern for request handling, but resulting actions may involve asynchronous processes with potential delays.\u003c/p\u003e\n"],["\u003cp\u003eThe RBM platform delivers various asynchronous events, such as incoming user messages, delivery receipts, and conversation updates, through a designated webhook endpoint.\u003c/p\u003e\n"]]],[],null,["# Synchronous and asynchronous operations in RBM\n\nThis document clarifies how the RBM platform handles message sending and other\nAPI interactions, distinguishing between synchronous and asynchronous\noperations.\n\nRBM API interactions generally follow a synchronous request-response pattern at\nthe HTTP level. However, the results of many API calls, especially message\ndelivery, are handled asynchronously through webhooks. Refer to the following\nsections for details.\n\nMessage sending: Synchronous request, asynchronous delivery\n-----------------------------------------------------------\n\nThe [`phones.agentMessages.create`](/business-communications/rcs-business-messaging/reference/rest/v1/phones.agentMessages/create)\nAPI request is processed **synchronously** from the API\nperspective. When you make an HTTP request to the RBM platform, the server\nresponds almost immediately with a standard HTTP status code\n(like `200 OK` or an error) to indicate whether the request was\nreceived and is valid.\n\nHowever, the actual delivery of the message to the end user is\nprocessed **asynchronously**. The following factors can affect this process:\n\n- **Recipient status**: The user might be offline, have an empty battery, or not have RCS enabled.\n- **Network conditions**: Carrier network issues can delay or prevent message delivery.\n\nThe RBM platform provides message delivery status updates (like delivery\nreceipts and read receipts) asynchronously through\n[webhooks](/business-communications/rcs-business-messaging/guides/integrate/webhooks).\nTherefore, while the initial API request is synchronous, you should rely on\nasynchronous webhook [events](/business-communications/rcs-business-messaging/guides/build/events#agent-generated_events)\nto track message delivery. Don't expect immediate confirmation of delivery\nstatus from the\n[`phones.agentMessages.create`](/business-communications/rcs-business-messaging/reference/rest/v1/phones.agentMessages/create)\nresponse.\n\n### Other RBM API interactions\n\nMost other HTTP-based RBM APIs also operate with a synchronous request-response\nmodel. These APIs provide an immediate HTTP response that indicates the status\nof the request (success or error). However, while the request is synchronous,\nthe actions resulting from the request might involve asynchronous processes.\nFor example, a successful response to an API call to update agent information\ndoesn't mean the update is instantly reflected everywhere; there might be a\nshort propagation delay.\n\nWebhook endpoint: Asynchronous events\n-------------------------------------\n\nThe following [events](/business-communications/rcs-business-messaging/guides/build/events#agent-generated_events)\nare delivered asynchronously to your [webhook](/business-communications/rcs-business-messaging/guides/integrate/webhooks)\nendpoint:\n\n- **Incoming user messages** : The RBM platform pushes incoming user messages to your webhook endpoint. Be sure to [verify incoming messages](/business-communications/rcs-business-messaging/guides/integrate/webhooks#verify_incoming_messages).\n- **Delivery and read receipts**: Notifications of message delivery and read status are sent through webhooks.\n- **Conversation events**: Some conversation-related events, such as typing indicators, are sent through webhooks.\n- **Message expiration and revocation events**: The RBM platform sends events to confirm whether an expired message was successfully revoked."]]
