Slack

Integrasi Slack Dialogflow memudahkan Anda membuat aplikasi dan bot Slack sendiri serta melatihnya untuk memahami bahasa alami.

Catatan: Saat menggunakan integrasi pihak ketiga, permintaan dan data pengguna akhir dikirim ke Google dan pihak ketiga tersebut. Persyaratan layanan, SLA, harga, dan kuota untuk edisi agen Anda berlaku untuk penanganan permintaan ini oleh Google. Persyaratan layanan, SLA, harga, dan kuota pihak ketiga berlaku untuk penanganan permintaan ini oleh pihak ketiga tersebut.

Batasan

Hanya bahasa agen default yang didukung oleh integrasi ini.

Menyiapkan Slack

Untuk menyiapkan integrasi Slack bagi agen Anda, Anda memerlukan hal berikut:

• akun Slack
• un Tim Slack

Membuat Aplikasi Slack

1. Buka Konsol Developer Slack
2. Masukkan nama untuk aplikasi Anda
3. Pilih Tim yang ingin Anda kaitkan dengan aplikasi
4. Klik tombol Create App

Menambahkan Pengguna Bot

1. Klik OAuth &Permissions di menu sebelah kiri
2. Buka bagian Scopes dan pastikan Cakupan OAuth berikut ada di bagian Bot Token Scopes
3. Klik App Home di menu sebelah kiri
4. Aktifkan Always Show My Bot as Online dan edit App Display Name jika diperlukan (ini adalah nama yang akan dilihat pengguna untuk bot Anda)

Mengaktifkan Integrasi di Dialogflow

Di Konsol Developer Slack, klik Basic Information di menu sebelah kiri, lalu scroll ke bawah ke bagian App Credentials. Catat Client ID, Client Secret, dan Verification Token.

Menautkan Slack ke Dialogflow

1. Di Dialogflow, buka Integrations di menu sebelah kiri
2. Klik kartu Slack
3. Masukkan nilai terkait ke kolom berikut:
   1. Client ID
   2. Client Secret
   3. Verification Token
4. Klik Start

Melanjutkan Penyiapan Slack

Setelah menyiapkan Slack dan Dialogflow, Anda akan mengaktifkan OAuth, URL Permintaan Peristiwa (disediakan oleh Dialogflow), dan Langganan Peristiwa.

Menambahkan URL OAuth

1. Salin OAuth URL dari halaman setelan Slack Dialogflow

Catatan: Jika Aplikasi Slack Anda adalah Aplikasi Slack klasik dan Anda belum mengupgrade-nya, Anda harus mengklik Show URLs for legacy Slack workflow di halaman setelan Slack Dialogflow, lalu salin OAuth URL. Lihat Panduan Memulai: perbedaan antara aplikasi Slack lama dan baru untuk mengetahui informasi selengkapnya.

1. Buka Konsol Developer Slack dan klik OAuth & Permissions di menu sebelah kiri
2. Klik tombol Add a new Redirect URL dan tempel URL OAuth
3. Klik Add
4. Klik tombol Save URLs

Menambahkan URL Permintaan Peristiwa dan Mengaktifkan Langganan Peristiwa

1. Salin Event Request URL dari halaman setelan Slack Dialogflow
2. Buka Konsol Developer Slack dan klik Event Subscriptions di menu sebelah kiri
3. Klik tombol untuk mengaktifkan Peristiwa, lalu tempel URL Langganan Peristiwa ke kolom Request URL
   
   Setelah beberapa saat, Anda akan melihat "Verified" berwarna hijau di atas kolom Request URL field.

4. Di bagian Subscribe to Bot Events , klik tombol Add Bot User Event button
   
   Tindakan ini akan menampilkan kolom teks dan daftar peristiwa. Anda dapat memasukkan istilah ke kolom ini untuk menelusuri peristiwa yang ingin Anda respons oleh bot. Berikut adalah daftar peristiwa yang sebaiknya Anda tambahkan:
   

   Nama Peristiwa	Deskripsi Peristiwa
   message.im	Pesan diposting di saluran pesan langsung
   message.groups	Pesan diposting ke saluran pribadi
   message.channels	Pesan diposting ke saluran
   im_created	Pesan Langsung dibuat. Di bagian Subscribe to events on behalf of users , klik tombol Add Workspace Event untuk menambahkan peristiwa im_created, lalu tekan Save Changes.

   

5. Setelah selesai memperbarui setelan ini, klik tombol Save Changes di bagian bawah halaman.

Menambahkan Bot Slack ke Tim

1. Di Konsol Developer Slack, klik Manage Distribution di menu sebelah kiri
2. Di bagian Share Your App with Your Workplace, klik tombol Add to Slack button
3. Di halaman berikutnya, klik tombol Authorize untuk menambahkan agen

Pengujian

Anda dapat menguji agen tanpa membuat bot Slack publik. Untuk melakukannya, buka halaman Integrations untuk agen Anda, lalu klik tombol di kartu Slack. Di jendela pop-up, klik tombol Test In Slack.

Anda akan diminta untuk login ke Slack. Setelah login, buka instance dan temukan pengguna bot bernama @dialogflow-bot. Anda dapat mengirim pesan langsung ke agen untuk mengujinya atau menambahkannya ke saluran di instance Anda.

Catatan: Untuk mengubah nama agen atau menambahkan logo, Anda harus membuat bot menjadi publik.

Peristiwa

Peristiwa berikut dipanggil oleh integrasi ini:

Acara	Deskripsi
SLACK_WELCOME	Dipicu saat pengguna memulai percakapan dengan bot Slack Anda.

Pesan respons lengkap

Pesan respons lengkap berikut didukung.

Respons gambar

Format dan ukuran yang didukung:

• gif
• jpeg
• png
• bmp

Respons kartu

Tidak ada kolom wajib untuk kartu di Slack – kombinasi elemen apa pun dapat digunakan.

Tombol dengan URL dan dengan postback teks didukung. Tombol dengan URL ditampilkan sebagai hyperlink.

Respons balasan cepat

Balasan cepat didukung dalam integrasi Slack sekali klik dan sesuai dengan versi teks tombol interaktif Slack.

Respons payload kustom

Teks berformat dalam integrasi Slack sekali klik

Bot Slack Anda dapat mengirim teks berformat, seperti yang ditunjukkan dalam contoh berikut:

{
  "slack": {
    "text": "This is an example of *bold*, _italic_, and `code`."
  }
}