Temsilciden kullanıcıya bir etkinlik gönderir.
Temsilci etkinlikleri, temsilcinin kullanıcıdan gelen bir mesajı okuduğunu veya temsilcinin yazma aşamasında olduğunu belirtmek için kullanılabilir (bu, RCS for Business deneyimine insan unsuru ekler). Kullanıcıda RCS etkin değilse RCS for Business platformu NOT_FOUND (HTTP 404) hatası döndürür. Kullanıcı RCS'yi etkinleştirdiyse ancak şu anda ulaşılamıyorsa platform 200 OK yanıtı döndürür ve teslimatı etkinlik türüne göre yönetir. Temsilci etkinlikleri, 30 güne kadar depolama ve yönlendirme kuyruğunda bekletilir ve kullanıcı tekrar internete bağlandığında iletilir. Yalnızca IS_TYPING etkinlikleri geçicidir ve sıraya alınmaz.
Temsilci mesajlarının aksine, temsilci etkinlikleri gönderildikten sonra iptal edilemez.
HTTP isteği
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler | |
|---|---|
parent |
"phones/{E.164}" (Burada {E.164}, kullanıcının E.164 biçimindeki telefon numarasıdır.) Örneğin, ABD telefon numarası +1-222-333-4444 olan bir kullanıcı için değer phones/+12223334444, sonuçta elde edilen uç nokta ise https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents olur. |
Sorgu parametreleri
| Parametreler | |
|---|---|
eventId |
Temsilci tarafından atanan etkinliğin kimliği. Bu, https://www.rfc-editor.org/info/rfc9562 adresinde tanımlandığı şekilde bir UUID olmalıdır. RCS for Business platformu, aynı temsilciden gönderilen önceki bir mesaj veya etkinlik tarafından kullanılan bir kimlikle gönderilen tüm temsilci mesajlarını yoksayar. |
agentId |
Zorunlu. Temsilcinin benzersiz tanımlayıcısı. |
İstek metni
İstek metni, AgentEvent öğesinin bir örneğini içerir.
Yanıt metni
Başarılıysa yanıt metni, yeni oluşturulan bir AgentEvent örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/rcsbusinessmessaging
Daha fazla bilgi için OAuth 2.0 Overview sayfasını inceleyin.