Dialogflow: Parameter

Respond.io menggunakan parameter Dialogflow kustom untuk meningkatkan fungsi aplikasi agar sesuai dengan berbagai kasus penggunaan.

Dalam Dialogflow, parameter umumnya digunakan untuk menghubungkan kata dan frasa dalam respons Pengguna terhadap entitas. Jadi jika seseorang mengatakan "Ulang tahun saya tanggal 13 Maret," frasa "13 Maret" akan secara otomatis terdeteksi dan diperlakukan sebagai entitas tanggal. Anda dapat membaca lebih lanjut tentang parameter di Dialogflow pada halaman dokumentasinya.

Dengan platform respond.io, Anda dapat menggunakan parameter untuk mencakup lebih banyak kasus penggunaan. Anda dapat menggunakannya untuk menyimpan dan mengumpulkan informasi yang diberikan oleh Kontak Anda, misalnya dengan menetapkan tag dinamis, menetapkan bidang khusus. Anda bahkan dapat memberi tahu perwakilan dukungan saat kontak memerlukan bantuan. Anda juga dapat menggunakan platform respond.io untuk menyimpan dan mengelola respons maksud Anda dengan mudah.

Ada banyak hal yang dapat dicapai saat Anda menggunakan platform respond.io bersama dengan parameter Dialogflow Intent.

Referensi Parameter

Daftar parameter yang dapat Anda gunakan pada Dialogflow untuk berkomunikasi dengan platform respond.io.

Nama Parameter	Nilai	Keterangan
RB_TAMBAHKANTAG	tag1, [tag2, ...]	Menambahkan tag yang ditentukan ke profil Kontak pada platform respond.io
Hapus Tag	tag1, [tag2, ...]	Menghapus tag yang ditentukan dari profil Kontak di platform respond.io
RB_STATUS BOT	PALSU	Mematikan bot untuk kontak tertentu. Ini berguna dalam kasus di mana Anda ingin meneruskan percakapan dari bot ke manusia.
RB_MARKDONE	benar/salah	Membuka atau menutup percakapan untuk Kontak. Ini berguna untuk dukungan. Membuka percakapan untuk Kontak yang masih menantikan sesuatu, sedangkan menutup percakapan menandakan Kontak yang telah dilayani.
RB_PEMBERITAHUAN	pemberitahuan_pesan	Mengirimkan pemberitahuan kepada manusia di platform respond.io, disertai dengan pesan pemberitahuan
RB_BERLANGGANAN	benar/salah	Berlangganan atau berhenti berlangganan Kontak. Kontak yang berhenti berlangganan tidak akan menerima pesan siaran.
RB_FIELD_FIRSTNAME	nilai	Mengisi bidang Nama Depan profil Kontak dengan nilai yang ditentukan
RB_FIELD_LASTNAME	nilai	Mengisi bidang Nama Belakang profil Kontak dengan nilai yang ditentukan
RB_FIELD_FULLNAME	nilai	Mengisi bidang Nama Lengkap profil Kontak dengan nilai yang ditentukan
RB_FIELD_EMAIL	nilai	Mengisi bidang Alamat Email dari profil Kontak dengan nilai yang ditentukan
RB_FIELD_PHONE	nilai	Mengisi bidang Nomor Telepon di profil Kontak dengan nilai yang ditentukan
RB_FIELD_LANGUAGE	nilai	Mengisi bidang Bahasa pada profil Kontak dengan nilai yang ditentukan, misalnya en-us
RB_FIELD_[NAME]	nilai	Menambahkan bidang khusus ke profil Kontak'dengan nilai yang ditentukan. Ini paling baik digunakan untuk informasi non-dinamis, seperti email, ulang tahun, dll.
RB_REMOVEFIELDS	bidang1, [bidang2, ...]	Menghapus bidang kustom yang ditentukan dari Kontak di platform
RB_USER_ASSIGN	nilai	Menetapkan Kontak ke satu Pengguna di tim Anda
RB_SNIPPET	cuplikan_id	Mengirimkan Snippet yang ditentukan ke Kontak
RB_FILE	id_berkas	Mengirim file tertentu yang disimpan di platform ke Kontak

Penandaan

Informasi kontak' dapat disimpan dalam bentuk tag. Tag dapat ditambahkan/dihapus secara manual dalam Modul Kontak atau Modul Kotak Masuk , ditambahkan/dihapus secara terprogram menggunakan Alur Kerja , dan ditambahkan/dihapus menggunakan parameter dalam maksud Dialogflow.

Penting: Tag digunakan untuk segmentasi pemirsa dalam siaran. Ingatlah hal itu saat menambahkan/menghapus tag menggunakan maksud Dialogflow.

Menggunakan Parameter Tag

Menambahkan Tag

Dengan menggunakan parameter RB_ADDTAGS , Anda dapat menetapkan tag ke kontak. Tag akan ditambahkan ke kontak berdasarkan nilai parameter. Anda memiliki opsi untuk menambahkan beberapa tag dengan memisahkannya dengan koma.

Perhatikan bahwa nama tag tidak boleh mengandung spasi. Anda mungkin ingin menggunakan garis bawah sebagai gantinya.

Menghapus Tag

Dengan menggunakan parameter RB_REMOVETAGS , Anda dapat menghapus tag dari kontak. Tag akan ditambahkan ke kontak berdasarkan nilai parameter. Anda memiliki pilihan untuk menghapus beberapa tag dengan memisahkannya dengan koma.

Praktik Terbaik

Saat membuat tag baru, ada baiknya untuk menentukan nama yang pendek tetapi bermakna dan mudah dikenali. Idealnya, Anda ingin orang lain dapat memahami tag yang dikaitkan dengan pengguna.

Dengan pengisian slot menggunakan entitas, Anda memiliki opsi untuk membuat tag baru secara dinamis. Namun, hal ini tidak disarankan karena akan cepat menyebabkan penumpukan tag.

Untuk mengurangi pencemaran tag, usahakan untuk tidak terlalu spesifik atau terlalu banyak memberi tag agar jumlah tag tetap minimum.

Saat menggunakan tag untuk melacak minat topik pengguna, Anda dapat menggunakan tag yang sama dalam beberapa maksud yang memiliki topik yang sama. Hal ini dapat mengidentifikasi bahwa pengguna memiliki minat atau perhatian tertentu sekaligus mengurangi polusi tag.

Mematikan Bot

Bot Dialogflow dapat dihidupkan/dimatikan secara manual dari Modul Kotak Masuk dan secara otomatis menggunakan Alur Kerja. Selain itu, bot juga dapat dimatikan menggunakan parameter dalam maksud Dialogflow.

Menggunakan intent Dialogflow untuk mematikan Status Bot kontak dapat digunakan untuk membuat pengalihan ke manusia dalam alur kerja bot Anda.

Ketika Bot dinonaktifkan untuk Kontak, tidak ada pesan yang diteruskan ke Dialogflow. Kontak dengan Bot dinonaktifkan akan muncul pada platform di bawah bagian Tidak Ditugaskan di Dasbor.

Menggunakan Parameter Status Bot

Dengan RB_BOTSTATUS, Anda dapat mematikan bot untuk pengguna tertentu dengan menetapkan nilainya ke false.

Praktik Terbaik

Maksud Fallback tidak menyertakan tempat untuk menambahkan parameter. Saat mematikan bot dari Dialogflow, Anda harus membuat balasan cepat dalam maksud Fallback Anda yang menanyakan Kontak apakah mereka ingin berbicara dengan manusia. Jika Kontak merespons dengan balasan cepat ya , itu akan mengarahkan mereka ke maksud dengan parameter RB_BOTSTATUS .

Saat menggunakan parameter ini untuk menonaktifkan bot, Anda mungkin juga ingin memperbarui status Pengguna pada platform dengan RB_MARKDONE dan mengirim pemberitahuan pada platform dengan parameter RB_NOTIFY dalam satu maksud.

Menutup Percakapan

Sistem Penugasan dan Penutupan Percakapan membuka percakapan baru untuk semua Kontak baru dan semua Kontak dengan pesan baru. Ini memastikan semua Kontak yang memerlukan bantuan muncul dalam daftar yang tidak ditetapkan.

Secara default, platform akan membuka percakapan baru untuk semua Kontak baru dan Kontak yang mengirim pesan baru.

Percakapan dapat dibuka atau ditutup untuk Kontak secara manual di Modul Kontak atau Modul Kotak Masuk , dibuka atau ditutup secara terprogram menggunakan Alur Kerja , dan ditutup menggunakan parameter dalam maksud Dialogflow.

Untuk menutup percakapan Kontak dari Dialogflow, gunakan parameter RB_MARKDONE di Intent Dialogflow Anda.

Menggunakan Parameter yang Ditandai Selesai

Untuk menutup percakapan Kontak, gunakan parameter RB_MARKDONE dalam maksud Dialogflow Anda dan tetapkan nilainya ke true.

Kontak mana pun yang memicu maksud menggunakan parameter RB_MARKDONE dengan nilai true akan menutup percakapannya di platform respond.io.

Praktik Terbaik

Secara default, semua Kontak baru dan Kontak dengan pesan baru akan membuka percakapan baru. Anda ingin menetapkan RB_MARKDONE sebagai true untuk maksud yang tidak memerlukan agen manusia saat dipicu.

Anda mungkin ingin mempertimbangkan untuk menggunakan maksud ini bersama-sama dengan RB_NOTIFY untuk memicu pemberitahuan saat percakapan dibuka untuk Kontak. Pesan pemberitahuan dapat digunakan untuk menyampaikan informasi tentang apa yang perlu dilakukan untuk Kontak tertentu.

Menugaskan

Untuk menetapkan Kontak ke Pengguna dari Dialogflow, gunakan parameter RB_USER_ASSIGN di Intent Dialogflow Anda.

Menggunakan Parameter Penugasan

Untuk menetapkan Kontak ke Pengguna, gunakan parameter RB_USER_ASSIGN dalam maksud Dialogflow Anda dan tetapkan nilainya sebagai email Pengguna platform yang ingin Anda tetapkan.

Setiap Kontak yang memicu maksud menggunakan parameter RB_USER_ASSIGN dengan email Pengguna yang valid di Nilai ditetapkan ke Pengguna tersebut di platform respond.io.

Mengirim Pemberitahuan Kustom

Secara default, Sistem Notifikasi akan mengirimkan notifikasi ke Pengguna platform saat Kontak mengirimkan pesan baru. Pemberitahuan tambahan dapat dibuat dan dikirim ke Pengguna platform menggunakan parameter di Dialogflow Intents.

Untuk mengirim pemberitahuan ke Pengguna platform, gunakan parameter RB_NOTIFY di Intent Dialogflow Anda.

Menggunakan Parameter Notifikasi

Pemberitahuan dapat dikirim ke platform menggunakan RB_NOTIFY sebagai Nama Parameter. Nilai parameter akan dikirim sebagai notifikasi.

Tip: Anda dapat menggunakan variabel dinamis dalam nilai parameter dengan mengetik $dynamic.variable.

Praktik Terbaik

Gunakan variabel dinamis $contact.name untuk memberi tahu Pengguna platform Kontak mana yang memerlukan perhatian.

Gunakan RB_NOTIFY bersama dengan RB_BOTSTATUS dan RB_MARKDONE untuk memastikan Kontak mendapat perhatian yang mereka butuhkan.

Kiat: Pelajari lebih lanjut tentang cara kerja notifikasi pada platform di sini.

Berhenti berlangganan

Kadang-kadang Anda akan menerima pesan teks dari Kontak yang memberi Anda "STOP". Ini mungkin karena mereka tidak ingin lagi menerima siaran . Menetapkan RB_SUBSCRIBE sebagai false dalam Dialogflow akan menghentikan langganan Kontak dari semua siaran mendatang.

Respons bot dan pesan langsung tidak akan terpengaruh.

Menggunakan Parameter Berlangganan

Dengan RB_SUBSCRIBE, Anda dapat berlangganan atau berhenti berlangganan Kontak ke bot dengan menetapkan nilainya ke true atau false masing-masing. Kontak yang berhenti berlangganan tidak akan disertakan dalam siaran platform mendatang.

Praktik Terbaik

Jika Anda menggunakan parameter RB_SUBSCRIBE untuk mengelola izin siaran, Anda harus membuat bidang khusus di respond.io untuk menampilkan status langganan Kontak. Hal ini dapat dilakukan dengan menggunakan parameter RB_FIELD_[NAME] bersama dengan RB_SUBSCRIBE.

Bidang dan Nilai Kontak

Informasi Kontak dapat disimpan dalam bentuk nilai di Bidang Kontak.

Selain bidang default, bidang kustom dapat ditambahkan & dihapus dalam Modul Pengaturan. Bidang kustom baru juga dapat dibuat dari Dialogflow.

Jika Anda menggunakan parameter bidang di Dialogflow dan bidang kustom yang sesuai tidak ada di platform, bidang kustom baru akan dibuat.

Nilai bidang kontak dapat diubah secara manual dalam Modul Kontak Contacts Module atau Inbox Module, diubah secara terprogram menggunakan Alur Kerja, atau diubah menggunakan parameter dalam maksud Dialogflow.

Menggunakan Parameter Lapangan

Menetapkan Nilai Bidang

Anda dapat mengedit nilai bidang kustom Kontak dengan RB_FIELD_[FIELD_ID] di mana “[FIELD_ID]” diganti dengan ID bidang kustom. ID bidang kustom dibuat sebagai nama bidang kustom di SNAKE_CASING. Nilai bidang kustom akan ditetapkan sebagai nilai dalam parameter. Misalnya, jika Anda mengumpulkan golongan darah Kontak dan Kontak memiliki golongan darah AB positif, Anda akan mengirim parameter RB_FIELD_BLOODTYPE dengan nilai AB+.

Tip: Anda dapat menggunakan nilai bidang kustom sebagai variabel dinamis.

Bidang Default

Hal yang sama dapat dilakukan untuk bidang Kontak default mana pun. Misalnya, parameter RB_FIELD_PHONE dapat digunakan untuk memperbarui nilai nomor telepon Kontak.

Secara default, Kontak pada respond.io memiliki bidang Kontak berikut:

Nama Lapangan	PENGENAL	Keterangan
Nama depan	NAMA DEPAN	Nama depan Kontak
Nama belakang	NAMA BELAKANG	Nama belakang kontak
Nama Lengkap	NAMA LENGKAP	Nama lengkap Kontak, yaitu Nama Depan + Nama Belakang
Alamat email	E-MAIL	Alamat email Kontak
Nomor telepon	TELEPON	Nomor telepon Kontak
Bahasa	BAHASA	Bahasa Kontak

Kolom default ini otomatis terisi menggunakan informasi yang tersedia yang disediakan oleh saluran saat Kontak pertama kali dibuat.

Menghapus Bidang

Untuk menghapus nilai bidang untuk kontak, Anda dapat menggunakan parameter RB_REMOVEFIELDS. Nilainya adalah nama bidang yang ingin Anda hapus. Anda memiliki pilihan untuk menghapus beberapa bidang sekaligus dengan memisahkannya menggunakan koma.

Potongan

Sistem Snippet digunakan untuk menyimpan konten respons yang umum digunakan pada platform respond.io.

Cuplikan dapat dikirim secara manual di Modul Kotak Masuk untuk mengurangi pengetikan atau dikirim menggunakan parameter di Maksud Dialogflow.

Dengan mengirimkan Snippet di Agen Dialogflow Anda, Anda dapat menyimpan konten respons Intent di platform respond.io yang memudahkan Anda dalam mengelola dan mengeditnya.

Beberapa maksud juga dapat menggunakan Snippet yang sama. Dalam kasus ini, pengeditan Snippet akan memperbarui konten respons di semua Intent.

Untuk mengirim Snippet menggunakan Dialogflow Intents, gunakan parameter RB_SNIPPET . Intent yang memicu akan merespons dengan konten Snippet.

Menggunakan Parameter Snippet

Dengan RB_SNIPPET, Anda dapat mengirim Snippet sebagai respons. Tetapkan nilai parameter ke ID Cuplikan yang ingin Anda kirim.

Memperbarui atau mengubah nama atau konten Snippet akan mempertahankan ID Snippet yang ada.

Mengirim File

File dapat dikirim secara manual di Modul Kotak Masuk atau dikirim menggunakan parameter di Maksud Dialogflow.

Dengan menggunakan parameter RB_FILE, Anda dapat mengirim file yang disimpan di File Manager ke Kontak yang memicu Intent Dialogflow.

Menggunakan Parameter File

Sebelum Anda dapat mengirim berkas, Anda harus mengunggah berkas tersebut ke respond.io File Manager. Kemudian gunakan parameter RB_FILE dengan ID file sebagai nilai untuk mengirim file ke Kontak.