Method: phones.agentEvents.create

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 RCS for Business tidak dapat menghubungi pengguna, platform RCS for Business akan menampilkan 404 NOT_FOUND.

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

string

"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

string

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

string

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:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.