Bagikan melalui

Menyambungkan bot ke Slack

  • Artikel

BERLAKU UNTUK: SDK v4

Anda dapat mengonfigurasi bot untuk berkomunikasi dengan orang-orang melalui aplikasi Slack. Artikel ini menjelaskan cara membuat aplikasi Slack menggunakan Slack, menyambungkan bot Anda ke aplikasi Slack Anda di Azure, dan menguji bot Anda di Slack.

Artikel ini memperlihatkan cara menambahkan saluran Slack ke bot Anda di portal Azure. Untuk informasi tentang cara menggunakan adaptor saluran kustom, lihat Informasi tambahan.

Prasyarat

  • Langganan Azure. Jika Anda belum memilikinya, buat akun gratis sebelum memulai.
  • Bot yang diterbitkan ke Azure yang ingin Anda sambungkan ke Slack.
  • Akses ke ruang kerja Slack dengan izin yang memadai untuk membuat dan mengelola aplikasi di https://api.slack.com/apps. Jika Anda tidak memiliki akses ke lingkungan Slack, Anda dapat membuat ruang kerja.

Membuat aplikasi di Slack

Anda terlebih dahulu membuat aplikasi di Slack, yang menghasilkan informasi yang Anda butuhkan untuk mengonfigurasi saluran Slack untuk bot Anda di Azure.

  1. Buka panel Aplikasi Anda dan masuk ke akun Slack Anda.
  2. Pilih Buat Aplikasi Baru, atau Buat Aplikasi jika ini adalah aplikasi pertama Anda.
    1. Pada halaman Buat aplikasi , pilih Dari awal.
    2. Pada halaman Aplikasi nama & pilih ruang kerja, untuk Nama Aplikasi, masukkan nama aplikasi Slack Anda.
    3. Untuk Pilih ruang kerja untuk mengembangkan aplikasi Anda, pilih ruang kerja untuk aplikasi Anda.
    4. Tinjau dan setujui ketentuan layanan Slack API.
    5. Pilih Buat Aplikasi.

Menambahkan URL pengalihan baru

Setelah aplikasi dibuat, tambahkan URL pengalihan ke aplikasi Anda.

  1. Pilih OAuth & Izin.

  2. Di panel yang dihasilkan, di bawah URL Pengalihan, pilih Tambahkan URL Pengalihan baru.

  3. Dalam kotak input, masukkan salah satu URL pengalihan berikut dan pilih Tambahkan.

    • Untuk bot global, masukkan https://slack.botframework.com.
    • Untuk bot regional, masukkan url berikut sesuai dengan wilayah yang dipilih:
    Wilayah URL Pengalihan
    Eropa https://europe.slack.botframework.com
    India https://india.slack.botframework.com

  4. Pilih Simpan URL.

Berlangganan peristiwa bot

Setelah Anda menambahkan URL pengalihan, berlangganan aplikasi Anda ke peristiwa bot agar Slack memberi tahu bot aktivitas pengguna Anda di URL yang Anda tentukan. Berlangganan peristiwa berdasarkan fitur yang akan digunakan bot Anda di Slack.

  1. Pilih Langganan Peristiwa.

  2. Di panel yang dihasilkan, alihkan Aktifkan Peristiwa ke Aktif.

  3. Untuk URL Permintaan, masukkan salah satu URL permintaan berikut, di mana {bot-name} adalah nama tampilan untuk sumber daya Azure Bot Anda, tanpa kurung kurawal.

    • Untuk bot global, masukkan https://slack.botframework.com/api/Events/{bot-name}.
    • Untuk bot regional, masukkan url berikut sesuai dengan wilayah yang dipilih:
    Wilayah URL Permintaan
    Eropa https://europe.slack.botframework.com/api/Events/{bot-name}
    India https://india.slack.botframework.com/api/Events/{bot-name}

  4. Di bawah Berlangganan peristiwa bot, pilih Tambahkan Peristiwa Pengguna Bot, lalu berlangganan peristiwa. Contohnya:

    • member_joined_channel
    • member_left_channel
    • message.channels
    • message.groups
    • message.im
    • message.mpim

  5. Pilih Simpan Perubahan.

Mengaktifkan pengiriman pesan ke bot oleh pengguna

Setelah Anda berlangganan peristiwa bot, aktifkan pengguna untuk mengirim pesan ke bot Anda.

  1. Pilih Beranda Aplikasi.
  2. Di panel yang dihasilkan, di bagian Perlihatkan Tab di bawah Tab Pesan, aktifkan Izinkan pengguna mengirim perintah dan pesan Garis Miring dari tab pesan.

Menambahkan dan mengonfigurasi pesan interaktif

Secara opsional, aktifkan pesan interaktif.

  1. Pilih Interaktivitas & Pintasan.

  2. Untuk URL Permintaan:

    • Untuk bot global, masukkan https://slack.botframework.com/api/Actions.
    • Untuk bot regional, masukkan url berikut sesuai dengan wilayah yang dipilih:
    Wilayah URL Permintaan
    Eropa https://europe.slack.botframework.com/Actions
    India https://india.slack.botframework.com/Actions

  3. Pilih Simpan perubahan.

Menyalin informasi aplikasi Anda

Anda memerlukan informasi berikut untuk menambahkan saluran Slack ke bot Anda. Selalu salin dan simpan kredensial aplikasi di tempat yang aman.

  1. Pilih Informasi Dasar.
  2. Di panel yang dihasilkan, di bawah Kredensial Aplikasi, temukan ID Klien, Rahasia Klien, dan Rahasia Penandatanganan.
  3. Sekarang, pilih OAuth & Permissions.
  4. Di panel yang dihasilkan, temukan bagian Cakupan . Rekam Cakupan Token Bot untuk aplikasi Anda.

Mengonfigurasi bot Anda di Azure

Untuk menyelesaikan langkah ini, Anda memerlukan kredensial aplikasi Slack dari langkah sebelumnya.

  1. Buka portal Microsoft Azure.

  2. Buka bilah sumber daya Azure Bot untuk bot Anda.

  3. Buka Saluran dan pilih Slack.

  4. Di Konfigurasi Saluran Slack, masukkan informasi yang Anda salin di langkah-langkah sebelumnya.

    1. Masukkan kredensial Slack yang diperlukan untuk aplikasi yang Anda buat di Slack.
    2. Secara opsional, berikan URL Halaman Arahan yang akan dialihkan pengguna Slack setelah mereka menambahkan bot Anda.
    3. Nilai URL Pengalihan OAuth & Izin dan URL Permintaan Langganan Peristiwa harus cocok dengan nilai yang Anda masukkan di Slack untuk menambahkan URL pengalihan dan berlangganan peristiwa bot.

    mengirimkan kredensial

  5. Pilih Terapkan.

  6. Anda dialihkan ke Slack untuk menyelesaikan penginstalan aplikasi Slack Anda.

    • Jika izin yang diminta terlihat benar, pilih Izinkan.

Bot Anda sekarang dikonfigurasi untuk berkomunikasi dengan pengguna di Slack. Pengguna di ruang kerja sekarang dapat berinteraksi dengan bot Anda melalui aplikasi Slack.

Menguji aplikasi Anda di Slack

  1. Masuk ke ruang kerja Slack tempat Anda menginstal aplikasi.
  2. Di bawah Aplikasi, pilih aplikasi Anda.
  3. Di panel yang dihasilkan, kirim pesan ke aplikasi.

Informasi Tambahan

Catatan

Pada Juni 2020 saluran Slack mendukung cakupan izin Slack V2, yang memungkinkan bot untuk menentukan kemampuan dan izinnya dengan cara yang lebih terperinci. Semua saluran Slack yang baru dikonfigurasi akan menggunakan cakupan V2. Untuk mengalihkan bot Anda ke cakupan V2, hapus dan buat ulang konfigurasi saluran Slack di bilah saluran portal Azure.

Untuk informasi selengkapnya tentang dukungan Slack untuk bot, lihat dokumentasi Slack API:

Menyambungkan bot ke Slack menggunakan adaptor Slack

Selain saluran yang tersedia di Azure AI Bot Service untuk menghubungkan bot Anda dengan Slack, repos Komunitas Pembangun Bot menentukan adaptor saluran kustom untuk Slack.

  • Untuk informasi tentang adaptor C#, lihat bagian Adapter di repositori komunitas .NET.
  • Untuk informasi tentang adaptor JavaScript, lihat bagian Adapter di repositori komunitas JavaScript.