Mengirim peristiwa dari agen ke pengguna.
Peristiwa agen dapat digunakan untuk menunjukkan bahwa agen telah membaca pesan dari pengguna atau bahwa agen sedang mengetik (yang menambahkan elemen manusia ke pengalaman RCS untuk Bisnis). Jika pengguna tidak mengaktifkan RCS, platform RCS untuk Bisnis akan menampilkan error NOT_FOUND (HTTP 404). Jika pengguna mengaktifkan RCS, tetapi tidak dapat dihubungi saat ini, platform akan menampilkan respons 200 OK dan menangani pengiriman berdasarkan jenis peristiwa. Peristiwa agen diantrekan dalam antrean simpan dan teruskan hingga 30 hari dan dikirimkan setelah pengguna kembali online. Hanya peristiwa IS_TYPING yang bersifat sementara dan tidak diantrekan.
Tidak seperti pesan agen, peristiwa agen tidak dapat dibatalkan setelah dikirim.
Permintaan HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents
URL ini 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 Amerika Serikat +1-222-333-4444, nilainya adalah phones/+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 ditentukan dalam https://tools.ietf.org/html/rfc4122. Platform RCS untuk Bisnis mengabaikan pesan agen 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 akan memuat instance AgentEvent yang baru dibuat.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/rcsbusinessmessaging
Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.