Integrasi Slack

Kirim ringkasan rapat dan action item ke channel Slack segera setelah notulen selesai diproses. Tidak ada yang perlu disalin, dan orang yang tidak hadir tetap tahu apa yang diputuskan.

#Kenapa menghubungkannya

Slack adalah tempat sebagian besar tim sudah berada sepanjang hari. Ringkasan yang datang sendiri ke sana dibaca; ringkasan yang menunggu di dashboard tidak. Untuk tim dengan banyak rapat paralel, ini perbedaan antara "semua orang tahu" dan "yang hadir saja yang tahu".

#Cara kerjanya

Integrasi ini memakai n8n, alat otomasi visual yang bisa Anda hosting sendiri. Se-Hari menyediakan community node resmi, jadi tidak ada kode yang perlu ditulis — cukup impor workflow dan sesuaikan node tujuannya.

#Langkah pemasangan

1. Pasang community node n8n-nodes-sehari di n8n self-hosted Anda
2. Buat kredensial Se-Hari API dengan scope notulen:read dan webhooks:write
3. Impor resep notulen ke Slack
4. Ganti node terakhir dengan node Slack milik Anda dan pilih channel tujuan
5. Aktifkan workflow — endpoint webhook didaftarkan otomatis Workflow siap impornya ada di resep slack — salin JSON-nya, tempel di n8n, sesuaikan kredensial.

#Mendaftarkan webhook secara manual

Node trigger n8n melakukan ini otomatis saat workflow diaktifkan. Kalau Anda merangkainya sendiri, atau sekadar ingin tahu apa yang terjadi di baliknya, ini padanannya:

curl -X POST "https://se-hari.com/api/v1/webhooks" \
  -H "Authorization: Bearer $SEHARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://n8n-anda.com/webhook/sehari","event_types":["note.completed"],"description":"Integrasi Slack"}'

Responsnya memuat secret yang hanya ditampilkan sekali. Simpan sekarang — ia dibutuhkan untuk memverifikasi tanda tangan setiap kiriman. Kalau hilang, POST /webhooks/{id}/rotate-secret memberi yang baru.

#Yang perlu disesuaikan

Slack memotong pesan di sekitar 4.000 karakter. Ringkasan rapat panjang perlu dikirim sebagai lampiran, atau dipecah ke dalam thread. Alternatif yang lebih rapi: kirim ringkasan singkat beserta tautan berbagi notulen, sehingga siapa pun bisa membuka versi lengkapnya tanpa akun Se-Hari.

#Hal yang mudah terlewat

Ringkasan rapat sering memuat hal yang tidak dimaksudkan untuk seluruh perusahaan — angka gaji, penilaian orang, rencana yang belum diumumkan. Pilih channel privat, dan pertimbangkan menyaring berdasarkan judul rapat kalau satu akun Se-Hari dipakai beberapa tim.

#Kredit dan keamanan

Buat API key khusus untuk integrasi Slack ini, jangan memakai ulang key yang sudah dipakai sistem lain. Manfaatnya baru terasa saat ada masalah: key yang dicabut hanya mematikan satu integrasi, log aktivitas menunjukkan integrasi mana yang melakukan apa, dan batas kredit harian bisa disesuaikan per integrasi. Pasang batas kredit harian pada key tersebut. Angkanya tidak perlu presisi — beberapa kali lipat pemakaian normal sudah cukup. Kalau suatu saat key itu bocor atau ada alur yang salah rakit, kerugian Anda berhenti di angka itu alih-alih di saldo yang habis. Beri scope sesempit mungkin. Scope tidak bisa ditambahkan ke key yang sudah ada — itu disengaja, supaya key yang bocor tidak bisa menjadi lebih berbahaya dari waktu ke waktu.

#Kalau tidak berfungsi

Tiga tempat yang perlu diperiksa, dalam urutan ini:

1. Tab Aktivitas di dashboard developer — apakah request-nya sampai sama sekali, dan apa status responsnya
2. Tab Webhooks — kalau integrasi ini memakai event, riwayat pengiriman menampilkan kode respons dari sistem Slack Anda
3. Riwayat eksekusi di alat otomasi Anda — bentuk data yang benar-benar diterima tiap langkah Kalau yang muncul adalah kode error dari Se-Hari, setiap kode punya halaman penjelasannya sendiri di daftar kode error, lengkap dengan penyebab yang paling sering dan cara memperbaikinya.

#Integrasi lain

• Semua integrasi
• Galeri resep n8n
• Referensi API — kalau Anda memilih merangkainya sendiri