Mengirim peristiwa dari agen ke pengguna.
Peristiwa agen dapat digunakan untuk menunjukkan bahwa agen telah membaca pesan dari pengguna atau bahwa agen sedang dalam proses mengetik (yang menambahkan elemen manusia ke pengalaman RBM). Jika RBM tidak dapat menjangkau pengguna, platform RBM akan menampilkan 404 NOT_FOUND
.
Tidak seperti pesan agen, peristiwa agen tidak dapat dicabut setelah mengirim.
Permintaan HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
parent |
"phones/{E.164}", dengan {E.164} adalah nomor telepon pengguna dalam format E.164. Misalnya, untuk pengguna dengan nomor telepon AS +1-222-333-4444, nilainya adalah ponsel/+12223334444, dan endpoint yang dihasilkan adalah https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents. |
Parameter kueri
Parameter | |
---|---|
eventId |
ID peristiwa, yang ditetapkan oleh agen. Ini harus berupa UUID, seperti yang didefinisikan di https://tools.ietf.org/html/rfc4122. Platform RBM mengabaikan pesan agen apa pun yang dikirim dengan ID yang digunakan oleh pesan atau peristiwa sebelumnya yang dikirim dari agen yang sama. |
agentId |
Wajib. ID unik agen. |
Isi permintaan
Isi permintaan memuat instance AgentEvent
.
Isi respons
Jika berhasil, isi respons memuat instance AgentEvent
yang baru dibuat.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/rcsbusinessmessaging
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.