Contact Center AI Platform (CCAI Platform) menyediakan integrasi dengan CRM ServiceNow.
Setelan developer ServiceNow
Persyaratan Versi ServiceNow minimum yang direkomendasikan: Tokyo patch 1
Menyiapkan pengguna autentikasi dasar
Kemungkinan akun administrator ServiceNow telah mengaktifkan verifikasi 2 langkah dan dikaitkan dengan pengguna tersebut. Akibatnya, akun ini tidak dapat digunakan untuk mendapatkan akses administrator di CCAI Platform. Anda harus membuat akun pengguna di ServiceNow untuk tujuan ini.
Buat pengguna dasar dengan kredensial:
Buka User > New.
Isi detail, lalu pilih Web service access only.
Catat ID pengguna dan sandi.
Peran yang diperlukan di ServiceNow
Peran default di ServiceNow telah dikonfigurasi sebelumnya untuk memberikan akses dan izin tertentu dalam platform. Admin dapat membuat dan mengonfigurasi peran yang memberikan izin tertentu, yang mengatur tindakan yang dapat dilakukan oleh pengguna dan grup dengan peran tersebut.
Untuk melakukan integrasi ini, Anda harus memiliki peran berikut di ServiceNow:
user_admin: Peran ini dirancang untuk administrator yang perlu mengelola pengguna, grup, lokasi, dan perusahaan dalam instance ServiceNow.
sn_incident_read: Peran ini memberikan akses hanya baca ke Aplikasi Pengelolaan Insiden dan fungsi terkaitnya. Fitur ini memungkinkan pengguna melihat catatan insiden.
sn_incident_write: Peran ini memberikan akses tulis ke Aplikasi Pengelolaan Insiden dan fungsi terkaitnya, sehingga pengguna dapat membuat dan mengubah data insiden.
personalize_dictionary: Peran ini memungkinkan penyesuaian entri dan label kamus untuk memenuhi persyaratan bisnis tertentu.
function_field_admin: Peran ini ditujukan untuk pengguna yang perlu membuat, mengedit, dan melihat kolom fungsi secara khusus dalam desainer laporan. Alat ini tidak menyediakan kemampuan untuk membuat atau menghapus kolom fungsi dari daftar atau formulir platform.
Mengonfigurasi tampilan instance
Bagian berikut menguraikan perubahan konfigurasi yang diperlukan untuk tampilan instance.
(Opsional) Menambahkan favorit
Favorit adalah cara cepat untuk menemukan link yang paling sering Anda gunakan dalam instance ServiceNow. Untuk menambahkan favorit, pilih ikon bintang di samping kolom di panel Navigator. Jika nanti Anda ingin memfilter panel navigator untuk hanya melihat favorit, Anda dapat memilih ikon bintang tepat di bawah kolom filter navigator di panel Navigator.
Contoh favorit yang berguna:
Insiden: Pengaitan ke data untuk CRM kustom.
Pengguna: Pengaitan ke akun untuk CRM kustom.
REST API Explorer: Cara yang baik untuk menguji API.
Menambahkan kolom kustom secara manual
Pilih ikon luaskan (3 garis horizontal) di sudut kiri atas di dalam tampilan objek yang ingin Anda ubah. Anda dapat melakukannya di Tampilan Layanan Mandiri atau Tampilan Default.
Di menu, pilih Configure > Form Design untuk membuka Form Designer.
Di kolom kiri, pilih tab Field Types.
Tarik jenis kolom kustom yang ingin Anda tambahkan.
Setelah Anda meletakkan jenis kolom ke bagian yang diinginkan, pilih ikon roda gigi untuk melihat Setelan.
Di dalam jendela, ubah label dan catat namanya. Nama ini adalah nama yang Anda gunakan di setelan aplikasi CCAI Platform.
Pilih Simpan di pojok kanan atas layar.
Memetakan data sesi ke CRM
Anda harus memetakan data sesi yang sesuai dari CCAIP menggunakan Dialogflow dan menggunakan parameter berikut:
Data Agen Virtual
{
"ujet": {
"session_variable": {
"capture_target": "payload",
"payload": {
"value_one": "$session.params.payload_value_one"
};
"capture_type": [ "comment", "field" ] // optional, default of ["comment"]
}
}
}
Metadata
https://INSTANCE.service-now.com/api/now/table/sys_dictionary?sysparm_query=name%3Dsys_user https://INSTANCE.service-now.com/api/now/table/sys_dictionary?sysparm_query=name%3Dincident
Label: column_label
Kunci API: element
Kolom kustom berada di level yang sama dengan kolom standar dalam respons
sys_user atau incident.
Mengupload file dari CCAI Platform ke CRM
https://INSTANCE_URL.service-now.com/api/now/attachment/upload
Metode: POST
Format data permintaan: property
Lokasi data respons: data.result
Jenis: Multi-part form
Jenis lampiran: Attachment Url
URL Lampiran: download_link
Parameter: table below
Contoh permintaan:
{
file: FILE_DATA,
table_name: incident,
table_sys_id: RECORD_ID
}
Mengintegrasikan adaptor agen (formulir kustom)
Langkah-langkah berikut akan memandu Anda melalui proses mengaktifkan adaptor agen dan fungsi klik untuk menelepon di instance ServiceNow.
Menginstal dan mengonfigurasi OpenFrame
Buka All > System Applications > All Available Applications > All.
Telusuri OpenFrame.
Instal OpenFrame.
Setelah menginstal, buka All > OpenFrame > Configurations.
Membuat konfigurasi dengan URL. Jika Anda memiliki beberapa konfigurasi dalam instance ServiceNow, pengguna Anda mungkin tidak memiliki akses ke konfigurasi yang baru dibuat. Periksa grup Anda dan daftar urutan konfigurasi OpenFrame untuk menentukan konfigurasi yang digunakan pengguna Anda.
Ketik
sys_properties.listdi penelusuran.Edit
glide.ui.concourse.onmessage_enforce_same_origin_whitelist.Tambahkan URL baru ke daftar nilai.
Edit
sn_openframe.cross.origin.access.Tambahkan
autoplayke daftar nilai.
Mengaktifkan pengalaman UI Berikutnya untuk pengguna
Ketik
sys_properties.listdi menu navigasi, lalu klik Enter.Tetapkan properti sistem
glide.ui.polaris.experienceke true.Tetapkan preferensi pengguna
glide.ui.polaris.useke false untuk sistem.Tetapkan preferensi pengguna
glide.ui.polaris.useke true untuk pengguna. (Anda dapat membuat baris preferensi pengguna.)
Memperbarui properti sistem
Masukkan
sys_properties.listke menu navigasi, lalu klik Enter.Edit
glide.ui.concourse.onmessage_enforce_same_origin_whitelist.Tambahkan URL ke daftar nilai. Beberapa nilai harus dipisahkan dengan koma.
Edit
sn_openframe.cross.origin.access.Tambahkan putar otomatis ke daftar nilai.
Edit
glide.ui.polaris.experience.Ubah ke false, karena beberapa fitur tidak berfungsi jika diaktifkan.
Menambahkan klik untuk menelepon ke bagian atas formulir
Buka System UI > UI Actions.
Pilih Create New Action.
Dalam formulir seperti yang diilustrasikan, pilih tabel yang akan menyertakan klik untuk menelepon ini.

Untuk formulir dengan referensi ke kontak atau pengguna, gunakan
g_form.getReferenceAPI untuk mengakses nomor telepon pengguna. Untuk tabel kustom, ID Referensi dan atribut yang dihasilkan mungkin berbeda. Komunikasi ke CCAI Platform akan sama, sehingga payload dan struktur data harus tetap sama dengan berikut:function clickToDial() { var user = g_form.getReference('caller_id',function(res) { var phone = res.phone || res.mobile_phone; var payload = {"name": "clicktodial", "number": phone}; var data = {"payload": payload, "method": "openframe_communication" }; CustomEvent.fireAll("openframe_request", data); }); }Untuk formulir yang memiliki nomor dalam formulir yang akan dipanggil, gunakan
g_form.getValueAPI untuk mengambil nilai yang relevan. Ini adalah contoh dari tindakan UI untuk tabel Users. Untuk tabel kustom, nama kolom formulir mungkin berbeda. Komunikasi ke CCAI Platform akan sama, sehingga payload dan struktur data harus tetap sama dengan berikut:function clickToDial() { var phone = g_form.getValue('phone') || g_form.getValue('mobile_phone'); var payload = {"name": "clicktodial", "number": phone}; var context = {"payload": payload, "method" : "openframe_communication" }; CustomEvent.fireAll("openframe_request", context); }
Menambahkan klik untuk menelepon di samping referensi
Tombol panggil di samping referensi ke kontak harus diedit dalam formulir. Klik kanan kolom dan buka Configure Dictionary. Untuk atribut, tambahkan nilai
show_phoneataushow_phone_customer_serviceke nilairef_contributions.Di UI Macros, edit
show_phonedanshow_phone_customer_service.Ganti kode berikut:
Sebelumnya:
var task = {"entity": p.attr('data-task-table'), "query" :"sys_id="+p.attr('data-task-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-task-value'),"label":p.attr('data-task-label')};
var company = {"entity": p.attr('data-company-table'),"query":"sys_id="+p.attr('data-company-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-company-value'),"label":p.attr('data-company-label')};
var caller = {"entity": p.attr('data-caller-table'),"query": "sys_id="+p.attr('data-caller-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-caller-value'),"label":p.attr('data-caller-label')};
var callContext = [];
callContext.push(task);
callContext.push(company);
callContext.push(caller);
var metaData = {"phoneNumber":p.attr('data-caller-phone'),"taskId":p.attr('data-task-id')};
var data = {"metaData":metaData , "data": callContext};
var payload = {"type": "OUTGOING_CALL", "data" : data};
var createInteractionData ={};
createInteractionData.interactionSysId = -1;
createInteractionData.direction = 'outbound';
createInteractionData.context_document = p.attr('data-task-id');
createInteractionData.context_table = p.attr('data-task-table');
createInteractionData.account = p.attr('data-company-id');
if(p.attr('data-caller-table') === 'customer_contact')
createInteractionData.contact = p.attr('data-caller-id');
createInteractionData.opened_for = p.attr('data-caller-id');
var ga = new GlideAjax('sn_openframe.OpenFrameAjaxUtility');
ga.addParam('sysparm_name', 'createInteractionWithPropertyCheck');
ga.addParam('context', JSON.stringify(createInteractionData));
ga.getXML(function(serverResponse) {
var result = serverResponse.responseXML.getElementsByTagName("result");
var output = JSON.parse(result[0].getAttribute("data"));
if(output.status == "success"){
var interaction = {"entity": "interaction", "query" :"sys_id="+output.fields.interactionSysId, "value":output.fields.number, "label":"Interaction", "display":false};
payload.data.data.push(interaction);
}
var context = {"payload": payload, "method" : "openframe_communication" };
jslog("context with interaction : "+ JSON.stringify(context));
CustomEvent.fireAll("openframe_request", context);
});
Baru:
var phone = p.attr('data-caller-phone')
var payload = {"name": "clicktodial", "number": phone};
var data = {"payload": payload, "method": "openframe_communication" };
CustomEvent.fireAll("openframe_request", data);
Setelan CRM
Langkah-langkah berikut menggambarkan cara menghubungkan API ke ServiceNow menggunakan portal CCAI Platform.
Di portal CCAI Platform, buka Settings > Developer Settings > CRM.
Di bagian Agent Platform, pilih ServiceNow.
Masukkan informasi domain ServiceNow Anda di kolom ServiceNow Domain. Ini mungkin berupa instance developer atau instance vendor sesuai kebutuhan, tetapi merupakan korelasi langsung dengan instance dan merupakan bagian pertama dari URL di alamat web portal ServiceNow:
https://{your instance}.servicenow.com.Di kolom ServiceNow Cloud Selection, pilih
Incidentuntuk jenis tiket dasar. Jika Anda memilihCustom, opsi tambahan akan muncul. Insiden adalah ekstensi tabel tugas; objek kustom harus merupakan ekstensi insiden.Di kolom kredensial autentikasi, masukkan nama pengguna dan sandi Anda.
Jika Anda memilih
Incidentuntuk jenis kolom pemilihan cloud, Anda akan melihat kolom berikut:- Lookup account object mencakup tiga kolom drop-down:
Object Type,Phone Number lookup fields, danPhone number primary field.
- Lookup account object mencakup tiga kolom drop-down:
Jika Anda memilih
Customuntuk jenis kolom pemilihan cloud, Anda akan melihat kolom berikut:Objek data pencarian:
Base record object type: Pilih jenis tabel
taskatauincident.Record object type: Kolom ini akan diisi dengan data jika tabel insiden telah diperluas, dan Anda dapat memilihnya jika diperlukan.
Lookup account object mencakup tiga kolom drop-down:
Object Type,Phone Number lookup fields, danPhone number primary field.
Kolom ID pengguna kustom: Centang kotak ini jika Anda ingin mengaktifkan kolom pencarian pengguna kustom untuk sesi Mobile atau Web SDK, atau Apps API (Chat).
Format nomor telepon: Memberikan kemampuan untuk memilih format yang ingin Anda gunakan untuk menampilkan nomor telepon.
File metadata sesi: Centang kotak ini untuk melampirkan metadata sesi ke data CRM.
Klik Simpan untuk menyimpan pilihan Anda.
Kolom kustom untuk kumpulan data
Ini adalah kolom kustom yang telah dibuat untuk instance ServiceNow di Form Designer, dan dapat digunakan di CCAI Platform. Anda juga dapat membuat kolom kustom lainnya dengan memilih Create di bagian Custom Fields for Records di menu.
| Kolom | Jenis | Definisi |
|---|---|---|
u_ujet_custom_field_after_call_work |
String | Durasi Pekerjaan Setelah Panggilan |
u_ujet_custom_field_call_duration |
String | Durasi Panggilan |
u_ujet_custom_field_comm_id |
Bilangan bulat | ID panggilan atau chat bergantung pada jenis kontak |
u_ujet_custom_field_rating |
Bilangan bulat | Skor CSAT |
u_ujet_custom_field_email_via_web |
String | Email dikirim dari web |
u_ujet_custom_field_feedback |
String | Masukan |
u_ujet_custom_field_from_phone_number |
String | Nomor telepon penelepon |
u_ujet_custom_field_hold_duration |
String | Total waktu tunggu |
u_ujet_custom_field_menu_path |
String | Pemilihan Menu |
u_ujet_custom_field_queue_name |
String | Nama Antrean |
u_ujet_custom_field_session_type |
String | Jenis Sesi |
u_ujet_custom_field_verification |
Benar/Salah | Konfirmasi verifikasi selesai |
u_ujet_custom_field_wait_time |
String | Total waktu tunggu |
Menyiapkan OAuth
Untuk mengonfigurasi OAuth, lakukan langkah-langkah untuk membuat aplikasi OAuth di ServiceNow. Kemudian, masukkan kredensial (Client ID OAuth dan Rahasia Klien OAuth) di bagian Developer Settings > CRM > Metode Autentikasi.
Membuat aplikasi OAuth di ServiceNow
Di akun ServiceNow, buka All > System OAuth > Application Registry.
Buat aplikasi OAuth dan pilih Create an OAuth API endpoint for external clients.
Konfigurasi kolom berikut:
Name: Masukkan nama unik.
Client ID: Client ID dibuat secara otomatis oleh server OAuth ServiceNow.
Rahasia klien: Ini adalah rahasia klien untuk aplikasi OAuth. Biarkan kosong untuk pembuatan otomatis.
Masa aktif token refresh: Waktu, dalam detik, token refresh akan valid.
Masa aktif token akses: Waktu, dalam detik, token akses akan valid.
Redirect URL: Masukkan URL lingkungan Anda beserta subdirektorinya. Contoh:
https://servicenow.yourcompany.co/v1/servicenow/oauth_callbackEnforce token restriction: Membatasi penggunaan token akses ke API yang ditentukan dalam REST API Access Policies yang ada dalam dokumentasi ServiceNow. Jika opsi ini tidak dipilih, token akses dapat digunakan di REST API lainnya.
Klik Kirim.
Setelah membuat aplikasi, kembali ke data dan ambil Client ID dan Client Secret yang baru dibuat.
Memperbarui setelan di setelan developer
Buka Developer Settings > CRM.
Pastikan setelan dimasukkan dan dikonfigurasi sesuai dengan langkah-langkah sebelumnya.
Di bagian metode autentikasi, klik OAuth.
Masukkan Client ID OAuth dan rahasia klien OAuth. (Lihat langkah 5 di atas.)
Klik Save.
Klik link credentials.
Pemetaan kolom kustom untuk Agen Virtual
Jika menggunakan Agen Virtual, konfigurasikan kolom ini di layar Pemetaan Kolom Kustom. Hal ini memungkinkan variabel Agen Virtual ditransfer dari payload sesi Agen Virtual ke ServiceNow. Nama variabel dapat berupa string apa pun, label kolom yang tercantum di sini adalah contoh.
Di layar Custom Field Mappings, konfigurasikan koneksi antara variabel yang dibuat oleh definisi payload yang Anda gunakan dalam konfigurasi Virtual Agent awal dan variabel yang relevan dalam ServiceNow.
| Judul Pemetaan Kolom | Label Kolom CRM | Label Kolom Data Kustom |
|---|---|---|
| Masukan Agen Virtual | ccaip_custom_field_incident_feedback |
va_feedback |
Menambahkan pemetaan kolom CRM
Buka Settings > Operation Management.
Buka bagian CRM Custom Field Mapping > klik View All.
Klik link + Add CRM Field Mapping.
Field Mapping Title: Nama CCAI Platform untuk pemetaan kolom kustom ini yang digunakan di Portal CCAI Platform.
CRM Field Label: Label dalam CRM Anda untuk kolom CRM yang Anda petakan.
Custom Data Field Label (kunci data kustom): Nama kunci tingkat teratas dalam payload data kustom CCAI Platform yang ingin Anda petakan (misalnya,
deviceuntuk payload SDK, atauorderIduntuk payload Chat Apps API). Kunci ini harus dikirim oleh CCAI Platform Web atau Mobile SDK atau (untuk interaksi chat) menggunakan endpoint Apps APISend custom data in a chat. Kunci harus sama persis (termasuk penggunaan huruf kapital).
Klik Simpan.
Mengonfigurasi setelan lainnya
Anda akan menemukan setelan lain yang memungkinkan Anda mengintegrasikan CCAI Platform dengan benar ke instance ServiceNow di menu drop-down Settings. Lihat link dalam daftar berikut untuk mengetahui informasi tambahan tentang cara mengonfigurasi setiap bagian.
Output pengujian
Sekarang Anda dapat memverifikasi fungsi alur panggilan dan chat dengan mengklik tombol yang relevan di bagian atas layar portal CCAI Platform. Pastikan pemblokir pop-up Anda dinonaktifkan saat menjalankan pengujian ini.
Anda akan melihat Insiden dibuat di ServiceNow, dengan kontak panggilan atau chat yang tercantum di bagian Aktivitas insiden. Hal ini akan muncul sebagai Catatan Kerja, bukan komentar insiden, sehingga aktivitas backend ini tidak terlihat oleh pelanggan.
Deskripsi kasus akan diisi otomatis dengan "Call using CCAI Platform" atau "Chat using CCAI Platform" dan mungkin perlu diperbarui oleh agen.
Setelah puas dengan output panggilan atau chat, Anda dapat memasukkan kode dan catatan penyelesaian (jika kolom kode dan catatan penyelesaian ServiceNow telah dikonfigurasi), lalu menutup kasus.
Untuk memverifikasi bahwa kasus telah ditutup, Anda mungkin perlu mengklik tombol navigasi back
di browser. Perilaku yang diharapkan dalam instance ServiceNow adalah setelah menyelesaikan kasus, instance tersebut akan otomatis ditutup dan mengarahkan Anda ke halaman data pelanggan.