Universal Error Trigger — Pertahanan Lini Pertama

Mengapa Error Trigger Itu Wajib?

Setelah memahami monitoring di chapter sebelumnya, sekarang saatnya membangun sistem yang langsung memberitahu kita setiap kali workflow gagal. Bukan besok, bukan nanti — saat itu juga.

Universal Error Logger = satu workflow yang terhubung ke banyak workflow lain dan otomatis aktif setiap kali salah satu dari mereka error.

┌─────────────────────────────────────────────────┐
│           UNIVERSAL ERROR LOGGER                │
│                                                 │
│  Workflow A ──┐                                 │
│  Workflow B ──┤──▶ Error Trigger ──▶ Notifikasi │
│  Workflow C ──┤       │                         │
│  Workflow D ──┘       ▼                         │
│               Log ke Google Sheet               │
└─────────────────────────────────────────────────┘

---

Cara Kerja Error Trigger

1. Buat Workflow Error Logger

Buat workflow baru dengan Error Trigger node sebagai trigger utama:

Node	Fungsi
Error Trigger	Otomatis aktif saat workflow yang terhubung mengalami error
Google Sheets	Mencatat error ke spreadsheet sebagai log permanen
Telegram	Mengirim notifikasi real-time ke grup/chat pribadi

2. Hubungkan ke Workflow Target

Masuk ke Settings pada workflow yang ingin dimonitor:

1. Buka workflow target (misal: Travel Agent)
2. Klik Settings → Error Workflow
3. Pilih Universal Error Logger
4. Save dan Publish

Kenapa Disebut "Universal"?

Karena satu workflow ini bisa dihubungkan ke puluhan workflow lain. Tidak perlu membuat error handler terpisah untuk setiap workflow.

3. Data yang Didapat Saat Error

Ketika error terjadi, Error Trigger menyediakan informasi lengkap:

┌──────────────────────────────────┐
│      DATA ERROR TRIGGER          │
├──────────────────────────────────┤
│ 📌 Execution URL                 │
│ 📝 Error Message                 │
│ 🔗 Workflow Name                 │
│ 🎯 Node yang Gagal               │
│ 📊 Stack Trace                   │
│ ⏰ Timestamp                     │
└──────────────────────────────────┘

---

Membangun Sistem Notifikasi

Log ke Google Sheets

Buat spreadsheet dengan kolom all_error sebagai error log:

Timestamp	Workflow	Node	Error Message	Execution URL
2024-01-15 09:23	Travel Agent	Agent	Bad request	https://...
2024-01-15 14:05	CRM Sync	HTTP Request	Timeout	https://...

Mapping data dari Error Trigger:

• Timestamp → ambil dari atau field timestamp
• Workflow → nama workflow yang gagal
• Node → node spesifik tempat error terjadi
• URL → link langsung ke execution yang gagal

Notifikasi via Telegram

Kirim pesan ringkas ke Telegram dengan format:

⚠️ Workflow Failed!
📋 Name: Travel Agent
🎯 Node: Agent
⏰ Time: 2024-01-15 09:23
🔗 [Lihat Execution]

Langkah setup:

1. Tambahkan node Telegram — Send Text Message
2. Masukkan Bot Token dan Chat ID
3. Buat template pesan dengan expression mode
4. Non-aktifkan "Append Attribution" agar pesan bersih

---

Strategi Lanjutan

Routing Error per Client

Gunakan IF node setelah Error Trigger untuk memfilter berdasarkan nama workflow:

Error Trigger
     │
     ▼
  IF Node ──▶ Contains "Client A"? ──▶ Kirim ke Channel A
     │
     ▼
  Contains "Client B"? ──▶ Kirim ke Channel B
     │
     ▼
  Default ──▶ Kirim ke Channel Umum

Inilah pentingnya naming convention pada workflow — nama yang mengandung identitas client memudahkan routing error secara otomatis.

Dedicated Error Group

Buat grup Telegram khusus untuk error monitoring:

• Satu grup per client, atau satu grup untuk semua error
• Forward pesan ke tim teknis jika perlu
• Review setiap pagi sebagai rutinitas

---

Best Practices

Praktik	Penjelasan
Jaga workflow logger tetap sederhana	Hindari logika kompleks di dalamnya — jika logger sendiri error, siapa yang memberitahu?
Selalu publish	Error Trigger hanya bekerja pada workflow yang sudah di-publish dan aktif
Gunakan dummy data untuk testing	Pin data dari execution yang gagal untuk membangun mapping field
Sertakan link execution	Agar bisa langsung klik dan lihat detail error
Bagikan akses ke client	Beri transparansi — client juga bisa melihat log error

---

Proaktif > Reaktif

Pengalaman instruktur menunjukkan pola yang konsisten:

"Sebelum client saya menghubungi, saya sudah menghubungi dia duluan — 'Hei, ada error di workflow kamu, saya sedang cek.' Dan dia sangat senang dengan proaktifnya saya."

Inilah yang membedakan freelancer biasa dengan agensi profesional:

❌ Client lapor error → Kamu baru tahu → Panik → Perbaiki

✅ Error terjadi → Kamu langsung tahu → Hubungi client →
   Perbaiki → Kirim laporan → Client kagum

---

Checklist Implementasi

• [ ] Buat workflow Universal Error Logger
• [ ] Tambahkan Error Trigger node
• [ ] Hubungkan ke Google Sheets untuk logging
• [ ] Hubungkan ke Telegram untuk notifikasi
• [ ] Hubungkan semua workflow production ke Error Logger
• [ ] Test dengan sengaja membuat workflow gagal
• [ ] Pastikan semua workflow sudah di-publish
• [ ] Review error log setiap pagi sebagai rutinitas