Mengintegrasikan Bot dengan Data Sumber Eksternal

Sebagai penyedia informasi, bot harus memiliki sikap ‘Aku-Tahu-Semuanya’. Bot harus memastikan end-user untuk mengerti produknya sehingga seringkali perusahaan membutuhkan sumber daya eksternal untuk memberikan informasi yang beragam agar tidak terjebak pada jenis percakapan yang itu-itu lagi.

Pengembang dialog 3Dolphins dapat mengintegrasikan permintaan itu. Ini dapat dilakukan dengan membangun Kit Pengembangan Perangkat Lunak (SDK) atau dengan fitur Process Flow kami; keduanya memberikan kemampuan bagi pengembang untuk mengintegrasikan sistem 3Dolphins dengan API yang tersedia, dengan atau tanpa otorisasi tergantung pada persyaratan API yang dimiliki. Untuk langkah yang lebih mudah, kami akan menjelaskan prosedur di fitur Alur Proses kami karena di dalam prosesnya ada lebih sedikit coding, ditampilkan dengan mudah di UI yang komprehensif.

Ini adalah penjelasan saat harus memasukkan sumber tanpa otorisasi dan header.

Mengintegrasikan Bot dengan Sumber Data Eksternal tanpa Otorisasi dan header

Cari API yang berisi data yang diinginkan. Contoh:

Proses ini menggunakan Process Flow sebagai contoh untuk mengintegrasikan bot dengan link di atas. Buka tab Process Flow, dan akan melihat ruang kerja yang bersih dengan hanya satu simpul aktivitas “Starti”. Klik ikon “+” di sudut kanan atas ruang kerja. Pilih aktivitas Permintaan HTTP.

Penjelasan :

HTTP Request Name : Nama Node Kegiatan (akan muncul di ruang kerja)
Method : GET atau POST. Untuk kasus ini, cukup gunakan GET.
URL : Link atau Sumber API untuk mendapatkan sekumpulan data.
Key & Value : Jika Anda perlu menambahkan header atau otorisasi. Tambahkan dengan (+) tombol HTTP Header.
Play : Untuk menjalankan Permintaan HTTP itu.
Add : Untuk menyimpan setting dan menambahkannya di workspace.
HTTP Body (second tab) : Untuk menambah body (jika perlu).
HTTP Response (third tab) : Untuk melihat hasilnya jika menjalankan pengaturan menggunakan tombol Play.

Input Setting

Ketika semua parameter selesai untuk pengaturan, Anda dapat menguji aktivitas dengan mengklik tombol play dan pindah ke HTTP Response untuk melihat di output respons API. Tampilannya akan seperti ini.

Developer dapat memproses respons dengan melakukannya di Fungsi MVEL. Developer bisa mendapatkannya dengan mengklik ikon (+) di sudut kanan atas di workspace. Misalnya, jika developer ingin mendapatkan data email pada larik pertama (yaitu [email protected]),dapat dilakukan pada Fungsi MVEL seperti gambar di bawah ini.

Buatlah activity node untuk output. Developer dapat menggunakan Webhook activity.

Sambungkan semua nodes jadi satu flow.

Simpan menjadi satu workflow. Attach workflow tersebut ke dialog flow.

Mengintegrasikan Bot dengan Sumber Data Eksternal Menggunakan Otorisasi dan Header

Eksternal Menggunakan Otorisasi dan Header Proses ini tidak memiliki perbedaan mencolok selain menambahkan lebih banyak pada simpul aktivitas HTTP Request. Jika HTTP Request membutuhkan body, developer dapat menambahkannya di tab HTTP Body. Misalnya, API membutuhkan persyaratan seperti ini:

Headers:

  • Key = X-RapidAPI-Host, dengan nilai yang diberikan
  • Key = X-RapidAPI-Key, dalam nilai yang diberikan

Parameter (letakkan parameter pada URL, lanjutkan URL dengan menambahkan simbol “?”):

  • location_id = 392339
  • currency = IDR

Method = GET

Ingat, Anda dapat menggunakan variabel yang diformat untuk semua parameter input, jika diperlukan input dinamis untuk menjalankan proses aktivitas. Seperti yang dapat Anda lihat, representasi input yang dijelaskan di atas ditampilkan di sini.

Use-case: Jadwal Libur Publik

Karena tahun 2020 masih hangat-hangatnya, dan mungkin beberapa orang belum beli kalender, Bella, misalnya, menawarkan kemudahan untuk memberi tahu end-user tentang jadwal liburan Indonesia. Data dibuat dari sumber eksternal, tetapi harus take-out hari libur yang telah dilewati. Inilah cara penggunaan use-case diselesaikan.

Pertama, kita membutuhkan sumber API untuk membuat proses ini mengalir. Misalnya, penulis mendapat satu API yang menyediakan data.

Tautan URL: (sumber)

Parameter yang dibutuhkan:

  • api_key (developer perlu membuat akun untuk mendapatkan “api_key” dan dimasukkan sebagai parameter.
  • country = ID
  • language = ID
  • year = 2020

Gabungkan URL dan parameter serta hasil untuk dimasukkan ke dalam URL https://calendarific.com/api/v2/holidays?api_key&country=ID&language=id&year=2020

Buat simpul aktivitas, pilih HTTP Request dan buat seperti ini.

Click Edit to save and add activity node on workspace. After that, make a MVEL Function activity node to process the data. Remember, in this case we need to remove holidays that have already passed. In MVEL Function activity node, insert code in MVEL Script tab. And then, make a Webhook as output of MVEL Function activity node.

Catatan: Node aktivitas Fungsi MVEL Penulis dinamai mvelHoliday. Jadi harus berhati-hati tentang output Webhook.

Hubungkan semua node dan simpan ke Process Flow. Developer dapat menguji process flow sebelum developers melampirkannya ke dialog flow.

developers melampirkannya ke dialog flow.

Dan hasilnya seperti ini!

Anda dapat mencoba tentang Bella lebih banyak dari sekedar jadwal hari libur umum, dan bot Anda juga dapat melakukannya. Jika Anda masih penasaran tentang cara membangun integrasi bot dengan sumber data eksternal, Anda selalu dapat menghubungi kami di [email protected]. Tetap stay tune untuk penjelasan yang lebih menyeluruh tentang produk kami dan optimalkan kinerja terbaiknya di sini!

Share :
Facebook
Twitter
LinkedIn
Related Post