Integrasi Asana

Action item hasil rapat menjadi task Asana di project yang Anda pilih, lengkap dengan konteks rapat asalnya.

#Kenapa menghubungkannya

Untuk tim yang sudah menjalankan pekerjaannya di Asana, task yang muncul otomatis dari rapat menutup celah paling umum: keputusan yang diambil di rapat tapi tidak pernah masuk ke sistem kerja, lalu terlupakan sampai rapat berikutnya.

#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. Buat personal access token di pengaturan Asana
2. Catat id project dan section tujuan
3. Pasang community node n8n-nodes-sehari dan buat kredensial Se-Hari
4. Impor resep action item ke Asana
5. Aktifkan workflow Workflow siap impornya ada di resep asana — 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 Asana"}'

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

Sertakan judul rapat di deskripsi task. Action item yang berdiri sendiri — "kirim proposal ke klien" — sering tidak cukup untuk dikerjakan berminggu-minggu kemudian oleh orang yang tidak hadir di rapat itu.

#Hal yang mudah terlewat

Field tenggat pada action item berbentuk teks bebas seperti "minggu depan", karena begitulah orang menyebutkannya dalam rapat. Jangan memetakannya langsung ke due date Asana tanpa mengurainya; kalau ragu, taruh di deskripsi dan biarkan manusia yang menentukan tanggalnya.

#Kredit dan keamanan

Buat API key khusus untuk integrasi Asana 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 Asana 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