Buat Perintah Slash Kustom Anda Sendiri di Slack

Slack adalah alat yang memungkinkan tim untuk berkomunikasi dan berkolaborasi. Salah satu fitur utamanya adalah penggunaan perintah garis miring. Perintah-perintah ini memicu tindakan atau integrasi tertentu dalam platform.

Meskipun Slack memberi Anda beberapa perintah garis miring bawaan, Anda dapat membuat perintah khusus menggunakan API Slack. Anda kemudian dapat mengonfigurasi perintah khusus untuk melakukan tugas tertentu saat pengguna memicunya.

Mengapa Membuat Perintah Slash Khusus di Slack?

Perintah garis miring bawaan Slack mungkin tidak memenuhi kebutuhan spesifik tim atau organisasi Anda. Dengan membuat perintah garis miring khusus, Anda dapat menciptakan pengalaman yang lebih dipersonalisasi untuk tim Anda. Ini pada gilirannya meningkatkan keterlibatan tim.

Baca Juga:

Mau Berkarir di Dunia blockchain? Ini Dia 10 Skill yang Harus Kamu Dalami!

Menyiapkan Aplikasi Slack

Untuk menindaklanjutinya, Anda harus terbiasa dengan penggunaan dasar Slack. Masuk ke akun Slack Anda di browser dan buat ruang kerja baru. Anda akan menggunakan ruang kerja ini untuk menguji aplikasi Anda sebelum menggunakannya di ruang kerja tim Anda.

Buka tab lain dan arahkan ke Situs web API kendur.

Klik pada Buat aplikasi tombol. Di halaman berikutnya yang muncul, pilih opsi untuk membuat aplikasi Dari awal.

Beri nama aplikasi dan pilih ruang kerja tempat aplikasi akan beroperasi.

Klik Buat Aplikasi tombol. Ini akan mengarahkan Anda ke halaman yang berisi informasi dasar tentang aplikasi Anda.

Di bagian fitur, navigasikan ke OAuth & Izin fitur, lalu gulir ke bawah ke Lingkup Token Bot. Tambah sebuah obrolan: tulis ruang lingkup untuk aplikasi Anda. Cakupan ini akan memungkinkan aplikasi Anda mengirim pesan ke ruang kerja.

Gulir ke atas Token OAuth untuk Ruang Kerja Anda bagian, dan klik pada Instal ke Workspace tombol.

Pada halaman berikutnya yang muncul, klik pada Mengizinkan tombol. Ini akan menginstal aplikasi di ruang kerja Anda.

Membuat Perintah Slash Khusus Menggunakan Slack API

Setelah menyiapkan aplikasi Slack, Anda perlu membuat perintah khusus untuk tugas yang ingin Anda selesaikan. Misalnya, perintah tebasan yang mengembalikan lelucon kepada pengguna. Arahkan ke Perintah Tebasan fitur. Klik pada Buat Perintah Baru tombol.

Isi Memerintah, Minta URLDan Deskripsi Singkat dari perintah yang ingin Anda buat. URL Permintaan adalah titik akhir tempat Slack mengirimkan permintaan POST ketika pengguna memicu perintah. Gunakan URL localhost sebagai placeholder; Anda akan mengganti URL ini nanti.

Klik Menyimpan. Saat Anda menyimpan, Slack menambahkan cakupan perintah untuk aplikasi Anda secara otomatis. Cakupan ini memungkinkan aplikasi Anda menambahkan pintasan dan garis miring perintah yang dapat digunakan orang di ruang kerja Anda. Mengubah cakupan akan mengharuskan Anda menginstal ulang aplikasi. Klik pada instal ulang aplikasi Anda tombol.

Pada halaman yang muncul berikutnya, klik izinkan menginstal ulang aplikasi di ruang kerja Anda.

Mengonfigurasi Perilaku Perintah Slash

Luncurkan IDE Python apa pun. Buat lingkungan virtual baru. Buat file Python baru dan file .env baru. Di terminal, jalankan perintah berikut untuk menginstal pustaka yang diperlukan.

 pip install python-dotenv requests Flask slack-bolt 

Itu python-dotenv perpustakaan akan memungkinkan Anda untuk memuat variabel lingkungan dalam file .env. Itu permintaan perpustakaan memungkinkan Anda membuat permintaan HTTP dan Labu menangani permintaan HTTP yang masuk dan mengembalikan respons. Baut kendur menangani permintaan Slack yang masuk.

Buka file .env dan buat dua variabel lingkungan. Beri nama mereka BOT_TOKEN Dan SIGNING_SECRET masing-masing. Arahkan ke situs web Slack API. Di bawah aplikasi Anda Informasi dasar salin rahasia penandatanganan dan gunakan untuk menginisialisasi variabel BOT_TOKEN. Arahkan ke fitur OAuth & Izin dan salin Token OAuth Pengguna Bot. Gunakan untuk menginisialisasi variabel SIGNING_SECRET.

Token bot adalah pengidentifikasi unik yang mengautentikasi aplikasi Anda dengan API Slack saat melakukan panggilan API. Rahasia penandatanganan memverifikasi bahwa permintaan masuk ke aplikasi Anda berasal dari Slack.

Impor pustaka dan modul yang diperlukan.

 import os
from pathlib import Path
from dotenv import load_dotenv
import requests
from flask import Flask, request, jsonify
from slack_bolt import App
from slack_bolt.adapter.flask import SlackRequestHandler 

Buat instance baru dari aplikasi Flask.

 app = Flask(__name__) 

Muat variabel lingkungan dari file .env menggunakan load_dotenv() fungsi.

 env_path = Path('.') / '.env'
load_dotenv(dotenv_path=env_path) 

Buat instance baru aplikasi Slack menggunakan Aplikasi kelas dari perpustakaan slack_bolt.

 slack_app = App(
    token=os.environ['BOT_TOKEN'],
    signing_secret=os.environ['SIGNING_SECRET']
)
 

Buat fungsi penangan rute yang menangani permintaan masuk ke /kendur/perintah titik akhir. Ketika titik akhir menerima a POS permintaan, ini mem-parsing data isi permintaan. Kemudian memeriksa apakah perintahnya /candaan. Jika demikian, itu memanggil get_joke() berfungsi dan mengembalikan respons JSON ke Slack dengan hasil perintah.

 @app.route("/slack/command", methods=["POST"])
def command():
    
    data = request.form
    
    if data["command"] == "/joke":
        message = get_joke()
    else:
        message = f"Invalid command: {data['command']}"
    
    return jsonify({"text": message})
 

Buat fungsi yang mengirimkan permintaan GET ke icanhazdadjoke API untuk mengambil lelucon acak dalam format JSON. Itu kemudian mengembalikan lelucon sebagai string.

 def get_joke():
    url = "https://icanhazdadjoke.com/"
    headers = {"Accept": "application/json"}
    response = requests.get(url, headers=headers, timeout=5)
    joke = response.json()["joke"]
    return joke 

Buat instance baru dari a SlackRequestHandler objek yang akan menangani permintaan masuk dari Slack.

 handler = SlackRequestHandler(slack_app) 

Periksa apakah skrip sedang dijalankan secara langsung dan, jika ya, jalankan aplikasi Flask pada port 5000.

 if __name__ == "__main__":
    
    app.run(port=5000, debug=True) 

Jalankan program untuk memulai server yang berjalan di localhost.

Agar program dapat berkomunikasi dengan Slack, Anda memerlukan URL yang dapat diaksesnya melalui internet. Unduh dan jalankan ngrok. Perangkat lunak ngrok memungkinkan Anda membuat URL publik yang aman yang menyalurkan lalu lintas ke server web yang berjalan di komputer Anda.

Jalankan perintah berikut untuk mendapatkan URL publik:

 ngrok http 5000 

Gambar di bawah menunjukkan URL publik di ngrok, disorot dengan warna putih.

Salin URL dan arahkan ke situs web Slack API. Klik pada Perintah Tebasan fitur. Edit perintah /joke dan ganti placeholder URL permintaan dengan URL publik Anda. Tambahkan /slack/events di akhir URL untuk menunjuk ke titik akhir Anda.

Pergi ke ruang kerja Anda, lalu ketik dan kirim perintah /joke. Anda akan melihat lelucon sebagai tanggapan:

Biasakan Diri Anda Dengan Fitur Slack Lainnya

Slack memiliki banyak fitur untuk ditawarkan di luar perintah Slash. Membiasakan diri dengan fitur-fitur ini akan memungkinkan Anda memahami cara kerjanya.

Anda kemudian dapat mencari cara untuk menyesuaikannya dengan kebutuhan ruang kerja Anda. Ini akan meningkatkan produktivitas tim Anda.