Aracıdan kullanıcıya etkinlik gönderir.
Temsilci etkinlikleri, temsilcinin kullanıcıdan gelen bir mesajı okuduğunu veya yazma sürecinde olduğunu belirtmek için kullanılabilir (bu, RCS Business deneyimine insani bir unsur katar). Kullanıcıda RCS etkin değilse İşletmeler için RCS platformu NOT_FOUND (HTTP 404) hatası döndürür. Kullanıcıda RCS etkinse ancak şu anda ulaşılamıyorsa platform 200 OK yanıtını döndürür ve teslimatı etkinlik türüne göre gerçekleştirir. Aracı etkinlikleri, 30 güne kadar sakla ve ilet kuyruğuna alınır ve kullanıcı tekrar çevrimiçi olduğunda teslim edilir. 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, +1-222-333-4444 ABD telefon numarasına sahip bir kullanıcı için değer phones/+12223334444 olur ve sonuçta elde edilen uç nokta https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents olur. |
Sorgu parametreleri
| Parametreler | |
|---|---|
eventId |
Aracı tarafından atanan etkinliğin kimliği. Bu, https://tools.ietf.org/html/rfc4122 adresinde tanımlandığı gibi bir UUID olmalıdır. İşletmeler için RCS 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ı olursa 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ına bakın.