Dokumentasi

Menghubungkan Slack dengan incoming webhook

Buat incoming webhook Slack untuk sebuah channel, tambahkan ke AutoPSEO, kirim pesan uji coba, dan atasi error yang dikembalikan Slack saat pengiriman gagal.

Akun → Slack, Teams & Webhook → Slack - Workspace terhubungMemerlukan langganan atau uji cobaBaca 3 mnt

AutoPSEO mengirim pesan ke Slack melalui incoming webhook. Slack memberi Anda sebuah URL yang menulis ke satu channel, Anda menempelkan URL tersebut ke AutoPSEO, dan laporan serta peringatan akan mulai masuk ke sana. AutoPSEO sendiri tidak memasang apa pun di workspace Anda: AutoPSEO tidak dapat membaca pesan, melihat daftar channel Anda, atau mengirim pesan ke tempat lain selain yang dituju webhook. Tambahkan satu entri untuk setiap channel yang ingin Anda gunakan sebagai tujuan pesan.

Membuat webhook di Slack

Slack menerbitkan incoming webhook melalui sebuah aplikasi Slack. Mengikuti panduan incoming webhook Slack:

Buat aplikasi Slack untuk workspace Anda, atau buka aplikasi yang sudah Anda gunakan untuk notifikasi. Pilih nama yang mudah dikenali tim Anda, misalnya SEO reports.
Di pengaturan aplikasi, buka Incoming Webhooks dan aktifkan Activate Incoming Webhooks.
Klik Add New Webhook to Workspace, pilih channel, lalu setujui. Untuk channel privat, Anda harus menjadi anggotanya terlebih dahulu.
Salin URL baru dari Webhook URLs for Your Workspace. URL ini diawali dengan https://hooks.slack.com/services/.

Ulangi langkah 3 dan 4 untuk setiap channel lainnya; satu aplikasi dapat memiliki beberapa webhook. URL yang dibuat dengan webhook custom integration lama dari Slack juga masih berfungsi, meskipun Slack menyarankan agar webhook tersebut dipindahkan ke aplikasi.

Slack memperlakukan URL ini sebagai rahasia: siapa pun yang memilikinya dapat mengirim pesan ke channel tersebut. Tempelkan URL ke AutoPSEO dan jangan menyimpannya di tiket, wiki, atau tangkapan layar.

Menambahkannya ke AutoPSEO

Di Slack, Teams & Webhooks, temukan Slack - Connected workspaces lalu klik Add to Slack. Formulir New channel akan terbuka dengan Slack sudah terpilih sebagai tujuan.
Name: label untuk daftar di AutoPSEO, riwayat pengiriman, dan pesan uji coba, misalnya #seo-alerts.
Webhook URL: tempelkan URL dari Slack. Untuk entri Slack, AutoPSEO hanya menerima alamat https di slack.com, dan langsung memberi tahu Anda jika URL tidak sesuai.
Klik Add channel, lalu klik Send test pada baris yang baru muncul. Pesan singkat yang menyebut nama entri tersebut akan muncul di Slack dalam hitungan detik, dan AutoPSEO melaporkan berapa lama Slack merespons.

URL disimpan dalam bentuk terenkripsi (AES-GCM). Setelah itu, daftar hanya menampilkan host dan beberapa karakter terakhirnya, jadi pilih nama yang menjelaskan dengan jelas channel Slack mana yang dituju oleh setiap entri.

Selanjutnya, tentukan apa yang akan dikirim: laporan terjadwal atau peringatan. Tabel Slack - Subscriptions di bawah daftar kemudian menampilkan, untuk setiap channel Slack, semua aturan yang mengirim ke sana, jadwalnya, serta statusnya aktif atau dijeda.

Beberapa channel dan workspace

Sebuah URL webhook hanya berlaku untuk satu channel di satu workspace, dan Slack tidak mengizinkan pesan mengganti channel tujuan webhook tersebut. Hal ini membuat semuanya mudah diprediksi:

Satu channel Slack, satu entri. Untuk memisahkan klien antara #client-a dan #client-b, buat webhook untuk masing-masing channel lalu tambahkan keduanya.
Beberapa workspace bekerja dengan cara yang sama, karena setiap webhook berada di workspace tempat Anda membuatnya.
Satu entri dapat memiliki banyak aturan. Kirim laporan mingguan dan peringatan penurunan trafik ke entri yang sama, atau pisahkan peringatan ke channel tersendiri yang lebih ramai.

Penyebab pesan tidak sampai

Send test langsung menampilkan penyebabnya. Untuk pesan terjadwal, buka Delivery history, yang menyimpan respons Slack untuk setiap percobaan yang gagal.

Yang ditampilkan AutoPSEO	Artinya	Yang perlu dilakukan
Slack menolak URL (no_service)	Webhook telah dihapus atau dinonaktifkan di Slack, atau URL salah ketik	Buat webhook baru, tambahkan, lalu hapus entri lama
Channel Slack sudah tidak ada, atau diarsipkan	Slack merespons `channel_not_found` atau `channel_is_archived`	Buat webhook untuk channel yang masih digunakan
Slack membatasi laju permintaan kami	Slack merespons HTTP 429	Tunggu sebentar, lalu gunakan Send now atau Test rule
Waktu habis setelah 10 detik	Slack tidak merespons tepat waktu	Coba lagi nanti
Masa uji coba Anda telah berakhir	Tidak ada paket atau masa uji coba yang aktif	Pilih paket; pengiriman terjadwal akan dilanjutkan bersamanya

Laporan terjadwal yang gagal tidak dikirim ulang pada periode yang sama, jadi gunakan Send now setelah penyebabnya diatasi. Peringatan yang tidak dapat dikirim akan dievaluasi kembali pada pengecekan berikutnya (kapan peringatan dijalankan).

Menghapus channel Slack

Delete pada baris entri akan menghapus URL yang tersimpan dan, setelah konfirmasi yang menyebutkan jumlahnya, setiap aturan yang mengirim ke sana. AutoPSEO tidak mengubah apa pun di Slack: webhook tetap berfungsi sampai seseorang menghapusnya di aplikasi Slack, jadi lakukan juga hal itu jika URL mungkin sudah terlihat oleh orang lain.