Integrasi Telegram

Ringkasan rapat masuk ke grup Telegram lewat bot. Cara tercepat mendapatkan notulen otomatis yang berfungsi, karena bot Telegram tidak butuh persetujuan siapa pun.

#Kenapa menghubungkannya

Untuk tim yang ingin mencoba apakah notulen otomatis benar-benar berguna bagi mereka, Telegram adalah titik awal dengan hambatan paling rendah. Bot dibuat dalam dua menit lewat BotFather, tanpa proses persetujuan seperti WhatsApp Business API dan tanpa administrator workspace seperti Slack.

#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 bot lewat @BotFather di Telegram dan salin token-nya
2. Tambahkan bot ke grup tujuan, lalu ambil chat id grup itu
3. Pasang community node n8n-nodes-sehari dan buat kredensial Se-Hari
4. Impor resep notulen ke Telegram
5. Isi token bot dan chat id, lalu aktifkan Workflow siap impornya ada di resep telegram — 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 Telegram"}'

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

Chat id grup bernilai negatif — itu normal, bukan kesalahan penyalinan. Aktifkan mode parse MarkdownV2 kalau Anda ingin judul tercetak tebal, tapi ingat bahwa mode itu mewajibkan sejumlah karakter di-escape.

#Hal yang mudah terlewat

Telegram menolak seluruh pesan yang melebihi 4.096 karakter, bukan memotongnya. Ringkasan rapat panjang akan hilang sepenuhnya tanpa error yang terlihat di Telegram — periksa riwayat eksekusi n8n kalau pesan tidak pernah sampai.

#Kredit dan keamanan

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