Slack

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

Batasan

Hanya bahasa agen default yang didukung oleh integrasi ini.

Menyiapkan Slack

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

Membuat Aplikasi Slack

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

Tambahkan 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 Always Show My Bot as Online dan edit App Dislay Name jika diperlukan (ini 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, Rahasia Klien, dan Token Verifikasi.

  1. Di Dialogflow, buka Integrasi 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 Start

Melanjutkan Penyiapan Slack

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

Tambahkan URL OAuth

  1. Salin URL OAuth dari halaman setelan Slack Dialogflow
  1. Buka Konsol Developer Slack, lalu 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 Simpan URL

Menambahkan URL Permintaan Acara dan Mengaktifkan Langganan Acara

  1. Salin Event Request URL dari halaman setelan Slack Dialogflow
  2. Buka Slack Developer Console, lalu klik Langganan Acara di menu kiri
  3. Klik tombol untuk mengaktifkan Peristiwa, dan tempel URL Langganan Acara ke kolom URL Permintaan

    Setelah beberapa saat, Anda akan melihat tanda "Terverifikasi" berwarna hijau di atas kolom URL Permintaan.

  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 oleh bot. Berikut daftar peristiwa yang kami sarankan untuk ditambahkan:

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

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

Tambahkan Slack Bot ke Tim

  1. Di Konsol Developer Slack, klik Kelola Distribusi di menu sebelah kiri
  2. Di bagian Share Your App with Your Workplace, klik tombol Add to 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 Integrasi 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 bernama @dialogflow-bot. Anda dapat mengirim pesan langsung kepada agen untuk mengujinya atau menambahkannya ke saluran di instance Anda.

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 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 dengan sekali klik

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

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