Slack

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

Catatan: Saat menggunakan integrasi pihak ketiga, permintaan dan data pengguna akhir akan dikirim ke Google dan pihak ketiga. 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.

Batasan

Hanya bahasa agen default yang didukung oleh integrasi ini.

Menyiapkan Slack

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

• akun Slack
• Tim Slack

Membuat Aplikasi Slack

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

Menambahkan Pengguna Bot

1. Klik OAuth & Izin di menu sebelah kiri
2. Buka bagian Cakupan dan pastikan Cakupan OAuth berikut ada di bagian Cakupan Token Bot
3. Klik Beranda Aplikasi di menu sebelah kiri
4. Aktifkan Selalu Tampilkan Bot Saya sebagai Online dan edit Nama Tampilan Aplikasi 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 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. Rahasia Klien
   3. Token Verifikasi
4. Klik Mulai

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 URL OAuth dari halaman setelan Slack Dialogflow

Catatan: Jika Aplikasi Slack Anda adalah Aplikasi Slack klasik dan Anda belum mengupgradenya, Anda harus mengklik Tampilkan URL untuk alur kerja Slack lama di halaman setelan Slack Dialogflow, lalu menyalin URL OAuth. Lihat Panduan memulai: perbedaan antara aplikasi Slack lama dan baru untuk mengetahui informasi selengkapnya.

1. Buka Konsol Developer Slack, lalu klik OAuth & Permissions di menu sebelah kiri
2. Klik tombol Tambahkan URL Alihan baru dan tempel URL OAuth
3. Klik Tambahkan
4. Klik tombol Simpan URL

Menambahkan URL Permintaan Peristiwa dan Mengaktifkan Langganan Peristiwa

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

4. Di bagian Berlangganan Peristiwa Bot , klik tombol Tambahkan Peristiwa Pengguna Bot
   
   Tindakan ini akan menampilkan kolom teks dan daftar peristiwa. Anda dapat memasukkan istilah ke kolom ini untuk menelusuri peristiwa yang ingin direspons bot. Berikut adalah daftar peristiwa yang sebaiknya ditambahkan:
   

   Nama Peristiwa	Deskripsi Peristiwa
   message.im	Pesan diposting di saluran pesan langsung
   message.groups	Pesan diposting ke channel pribadi
   message.channels	Pesan diposting ke channel
   im_created	DM telah dibuat. Di bagian Berlangganan peristiwa atas nama pengguna, klik tombol Tambahkan Peristiwa Ruang Kerja untuk menambahkan peristiwa im_created, lalu tekan Simpan Perubahan.

   

5. Setelah selesai memperbarui setelan ini, klik tombol Simpan Perubahan di bagian bawah halaman.

Menambahkan Bot Slack ke Tim

1. Di Konsol Developer Slack, klik Kelola Distribusi di menu kiri
2. Di bagian Bagikan Aplikasi Anda dengan Tempat Kerja, klik tombol Tambahkan ke Slack
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 Uji di Slack.

Anda akan diminta untuk login ke Slack. Setelah login, buka instance dan temukan pengguna bot yang disebut @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 bersifat publik.

Acara

Peristiwa berikut dipanggil oleh integrasi ini:

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

Pesan respons lengkap

Pesan respons kaya 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 contoh berikut:

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