Adaptor agen dapat menggunakan postMessage() API browser untuk mengirim peristiwa ke iFrame induk. Peristiwa ini dapat digunakan oleh JavaScript di iFrame induk dan digunakan untuk melakukan berbagai tindakan dalam penerapan CRM kustom Anda. Untuk melakukannya, aplikasi Anda harus memproses MessageEvent di jendela induk. Berdasarkan peristiwa, aplikasi Anda dapat memicu tindakan seperti membuka tab tiket untuk ID sesi tertentu. Adaptor panggilan dan adaptor chat memiliki peristiwa tertentu yang dapat digunakan untuk meningkatkan kemampuan CRM.
Contact Center AI Platform mendukung peristiwa asisten tugas virtual berikut:
Asisten tugas virtual bergabung
Asisten tugas virtual keluar
Variabel sesi kustom asisten tugas virtual diterima
Untuk mengetahui daftar lengkap peristiwa postingan yang terkait dengan adaptor agen, lihat Adaptor agen.
Asisten tugas virtual bergabung
Peristiwa ini diteruskan saat asisten tugas virtual bergabung dalam sesi.
Kolom Data
call_id. ID untuk sesi suara (IVR).chat_id. ID untuk sesi chat web atau seluler.campaign_id: ID untuk panggilan kampanye.campaign_name: Nama kampanye.virtual_agent_id: ID untuk asisten tugas virtual.virtual_agent_name: Nama asisten tugas virtual.participant_id: ID peserta untuk asisten tugas virtual.queue_id: ID untuk antrean tempat sesi berasal. ID ini hanya disertakan jika sesi berasal dari antrean.queue_path: Jalur antrean tempat sesi berasal. ID ini hanya disertakan jika sesi berasal dari antrean.queue_language_id: Bahasa antrean tempat sesi berasal. ID ini hanya disertakan jika sesi berasal dari antrean.session_type: Jenis sesi—misalnya, pesan masuk melalui chat web.conversation_id: ID untuk sesi agen virtual yang menggunakan profil percakapan.session_id: ID untuk sesi agen virtual yang tidak menggunakan profil percakapan.timestamp: Tanggal dan waktu suatu peristiwa.data_parameters: Variabel yang dikonfigurasi di portal CCAI Platform dan dikirim ke asisten tugas virtual.
Contoh payload
{
"type": "Task_VA_Joined",
"data": {
"chat_id": 103646,
"campaign_id": 1432,// omitted if not available
"campaign_name": "Survey Movie", // omitted if not available
"virtual_agent_id": 1,
"virtual_agent_name": "name",
"participant_id": 1,
"queue_id": 8469, // omitted if not available
"queue_path": "Developers / James", // omitted if not available
"queue_language_id": "en", // omitted if not available
"session_type": "Messaging Inbound (SMS)",
"conversation_id": "12345",
"session_id": "78534G4RT4284", // omitted if not available
"timestamp": "1727853575",
"data_parameters": {
"param1": "one",
"param2": "two"
}
}
}
Asisten tugas virtual keluar
Peristiwa ini diteruskan saat asisten tugas virtual keluar dari sesi.
Kolom data
call_id. ID untuk sesi suara (IVR).chat_id. ID untuk sesi chat web atau seluler.campaign_id: ID untuk panggilan kampanye.campaign_name: Nama kampanye.virtual_agent_id: ID untuk asisten tugas virtual.virtual_agent_name: Nama asisten tugas virtual.participant_id: ID peserta untuk asisten tugas virtual.queue_id: ID untuk antrean tempat sesi berasal. ID ini hanya disertakan jika sesi berasal dari antrean.queue_path: Jalur antrean tempat sesi berasal. ID ini hanya disertakan jika sesi berasal dari antrean.queue_language_id: Bahasa antrean tempat sesi berasal. ID ini hanya disertakan jika sesi berasal dari antrean.session_type: Jenis sesi—misalnya, pesan masuk melalui chat web.conversation_id: ID untuk sesi agen virtual yang menggunakan profil percakapan.session_id: ID untuk sesi agen virtual yang tidak menggunakan profil percakapan.timestamp: Tanggal dan waktu suatu peristiwa.finish_reason: Alasan akhir saat sesi agen virtual berakhir.data_parameters: Variabel yang dikonfigurasi di portal CCAI Platform dan dikirim ke asisten tugas virtual.captured_variables: Variabel sesi yang diambil oleh asisten tugas virtual.
Contoh payload
{
"type": "Task_VA_Left",
"data": {
"chat_id": 103646,
"campaign_id": 1432, // omitted if not available
"campaign_name": "Survey Movie", // omitted if not available
"virtual_agent_id": 1,
"virtual_agent_name": "name",
"participant_id": 1,
"queue_id": 8469, // omitted if not available
"queue_path": "Developers / James", // omitted if not available
"queue_language_id": "en", // omitted if not available
"session_type": "Messaging Inbound (SMS)",
"conversation_id": "12345",
"session_id": "78534G4RT4284", // omitted if not available
"timestamp": "1727853575",
"finish_reason": "Task VA failed", // Finish reason passed when the VTA session ends
"data_parameters": {
"param1": "one",
"param2": "two"
},
"captured_variables": [
{
"intent_name": null,
"variables": {
"testkey": "testvalue"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp": "1727853575"
},
{
"intent_name": null,
"variables": {
"testkey2": "testvalue2"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp": "1727853575"
}
]
}
}
Variabel sesi asisten tugas virtual yang diterima
Ini akan diteruskan saat asisten tugas virtual mengirimkan payload variabel sesi kustom.
Kolom Data
call_id. ID untuk sesi suara (IVR).chat_id. ID untuk sesi chat web atau seluler.campaign_id: ID untuk panggilan kampanye.campaign_name: Nama kampanye.virtual_agent_id: ID untuk asisten tugas virtual.virtual_agent_name: Nama asisten tugas virtual.queue_id: ID untuk antrean tempat sesi berasal. ID ini hanya disertakan jika sesi berasal dari antrean.queue_path: Jalur antrean tempat sesi berasal. ID ini hanya disertakan jika sesi berasal dari antrean.queue_language_id: Bahasa antrean tempat sesi berasal. ID ini hanya disertakan jika sesi berasal dari antrean.session_type: Jenis sesi—misalnya, pesan masuk melalui chat web.conversation_id: ID untuk sesi agen virtual yang menggunakan profil percakapan.session_id: ID untuk sesi agen virtual yang tidak menggunakan profil percakapan.timestamp: Tanggal dan waktu suatu peristiwa.data_parameters: Variabel yang dikonfigurasi di portal CCAI Platform dan dikirim ke asisten tugas virtual.captured_variables: Variabel sesi yang diambil oleh asisten tugas virtual.
Contoh Payload
{
"type": "Task_VA_Variables_Received",
"data": {
"chat_id": 103646,
"campaign_id": 1432, // omitted if not available
"campaign_name": "Survey Movie", // omitted if not available
"virtual_agent_id": 1,
"virtual_agent_name": "name",
"participant_id": 1,
"queue_id": 8469, // omitted if not available
"queue_path": "Developers / James", // omitted if not available
"queue_language_id": "en", // omitted if not available
"session_type": "Messaging Inbound (SMS)",
"conversation_id": "12345",
"session_id": "78534G4RT4284", // omitted if not available
"timestamp": "1727853575",
"data_parameters": {
"param1": "one",
"param2": "two"
},
"captured_variables": [
{
"intent_name": null,
"variables": {
"testkey_1": "testvalue"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp": "1727853575"
},
{
"intent_name": null,
"variables": {
"testkey_2": "testvalue2"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp" : "1727853575"
}
]
}
}
Payload Dialogflow untuk variabel sesi kustom
Payload variabel sesi kustom Dialogflow mendukung peristiwa postingan asisten tugas virtual.
Properti yang tersedia di payload variabel sesi pelanggan mencakup berikut ini:
capture_type:event: Menunjukkan bahwa nilai yang ditampilkan dalam payload variabel sesi pelanggan harus diteruskan dalam peristiwa postingan asisten tugas virtual.capture_type:agent: Menunjukkan bahwa nilai yang ditampilkan dalam payload variabel sesi pelanggan harus diteruskan ke adaptor agen.capture_type:comment: Menunjukkan bahwa nilai yang ditampilkan dalam payload variabel sesi pelanggan harus diteruskan ke data CRM sebagai komentar.invisible_to_adapter_events. Nilai kunci yang ditentukan dalam properti ini harus dikecualikan dari peristiwa postingan asisten tugas virtual.
Contoh payload
{
"ujet": {
"session_variable": {
"payload": {
"key_two": "$session.params.favfood",
"key_three": "$session.params.budget",
"key_one": "$session.params.location",
"key_four": "$session.params.startdate",
"key_five": "$session.params.enddate"
},
"capture_type": [
"comment",
"agent",
"event"
],
"capture_target": "payload",
"invisible_to_agent": [
"key_one",
"key_two"
],
"invisible_to_adapter_events": [
"key_three",
"key_two"
]
}
}
}