Temsilciden kullanıcıya bir etkinlik gönderir.
Aracı etkinlikleri, temsilcinin kullanıcıdan gelen bir mesajı okuduğunu veya yazma sürecinde olduğunu (RBM deneyimine bir insan öğesi ekler) belirtmek için kullanılabilir. RBM kullanıcıya erişemezse RBM platformu 404 NOT_FOUND
değerini döndürür.
Temsilci mesajlarında olduğu gibi, aracı 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, Türkiye'deki telefon numarası +1-222-333-4444 olan bir kullanıcı için değer telefon/+12223334444 olur ve elde edilen uç nokta https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents olur. |
Sorgu parametreleri
Parametreler | |
---|---|
eventId |
Etkinliğin temsilci tarafından atanan kimliği. Bu, https://tools.ietf.org/html/rfc4122 adresinde tanımlandığı gibi bir UUID olmalıdır. RBM platformu, aynı temsilciden gönderilen önceki bir mesaj veya etkinlik tarafından kullanılan bir kimlikle gönderilen tüm temsilci mesajlarını yok sayar. |
agentId |
Zorunlu. Temsilcinin benzersiz tanımlayıcısı. |
İstek içeriği
İstek metni, AgentEvent
öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılı olursa yanıt gövdesi, yeni oluşturulan 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'a Genel Bakış başlıklı makaleye bakın.