Method: phones.agentEvents.create

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

string

"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

string

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

string

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.