📡 Day 4: JSON, Expressions, Autentikasi & Integrasi (Pushover, Telegram, Slack)

Rangkuman 7 video: JSON & Tipe Data, Expressions di n8n, Metode Autentikasi, Integrasi Pushover, Membuat Bot Telegram, Integrasi Telegram–n8n, dan Integrasi Slack OAuth2

🎯 Tujuan Hari Ini

Hari keempat berfokus pada fondasi data (JSON & expressions), metode autentikasi dari yang paling sederhana hingga paling kompleks, dan tiga integrasi nyata — Pushover (satu arah), Telegram (dua arah), serta Slack (dua arah dengan OAuth2 penuh). Setelah hari ini, kamu sudah punya pengalaman langsung membangun komunikasi antara n8n dan platform eksternal.

📦 Bagian 1: JSON — Bahasa Data Universal

JSON (JavaScript Object Notation) adalah format data yang akan kamu temui di mana-mana saat bekerja dengan n8n dan API. Pahami strukturnya sekali, dan kamu akan nyaman membaca data apa pun.

Empat Blok Bangunan JSON

#	Konsep	Sintaks	Contoh
1	Key-Value Pair	`"key": value`	`"name": "Alice"`
2	Object (Dictionary)	`{ }` kurung kurawal	`{"name": "Alice", "age": 30}`
3	Array (List)	`[ ]` kurung siku	`["apple", "banana", "cherry"]`
4	Nesting	Object dalam object	`{"address": {"city": "Jakarta"}}`

Tipe Data dalam Value

┌─────────────┬──────────────────────┐
│ Tipe        │ Contoh               │
├─────────────┼──────────────────────┤
│ String      │ "hello"              │
│ Number      │ 42, 3.14             │
│ Boolean     │ true, false          │
│ Null        │ null                 │
│ Object      │ {"key": "value"}     │
│ Array       │ [1, 2, 3]            │
└─────────────┴──────────────────────┘

Contoh JSON Nyata (dari n8n)

json

{
  "message": {
    "message_id": 123,
    "from": {"first_name": "Ed", "username": "edbot"},
    "chat": {"id": 987654321, "type": "private"},
    "text": "Hi there"
  }
}

💡 Insight: Setiap data yang mengalir antar-node di n8n berbentuk JSON. Memahami JSON = memahami cara data bergerak dalam workflow-mu.

⚡ Bagian 2: Expressions di n8n

Expressions adalah cara dinamis mengakses dan memanipulasi data. Alih-alih menulis nilai tetap (fixed), kamu bisa menulis expression yang dievaluasi saat runtime.

Sintaks Dasar

Expression	Arti	Contoh Hasil
`{{ $json.name }}`	Ambil field `name` dari data masuk	`"Alice"`
`{{ $json.address.city }}`	Drill ke nested object	`"Jakarta"`
`{{ $node["Telegram Trigger"].json.message.chat.id }}`	Ambil data dari node lain	`987654321`
`{{ JSON.stringify($json) }}`	Ubah JSON jadi text	`'{"name":"Alice"}'`

Diagram Alur Expression

┌─────────────────┐     ┌──────────────────────┐     ┌──────────────┐
│  Data Masuk      │────▶│   Expression          │────▶│  Nilai Akhir │
│  (JSON Object)   │     │   {{ $json.field }}   │     │  (String/Num)│
└─────────────────┘     └──────────────────────┘     └──────────────┘

Toggle Fixed vs Expression

Di setiap field pada node n8n, kamu bisa beralih antara:

Fixed → Nilai tetap, misal "bananas"
Expression → Nilai dinamis, misal {{ $json.output }}

Tips Drag & Drop

Kamu tidak perlu menghafal expression. Cukup:

Klik field yang ingin diisi
Pilih mode Expression
Drag & drop dari panel data di sebelah kiri ke field expression
n8n otomatis menuliskan expression yang benar!

🔐 Bagian 3: Tiga Tingkat Autentikasi

Setiap integrasi dengan layanan pihak ketiga memerlukan autentikasi. Ada tiga tingkat kesulitan:

  Mudah                    Sedang                      Sulit
┌──────────┐          ┌──────────────┐          ┌──────────────────┐
│ API Key  │          │ Pre-config   │          │ Full OAuth2      │
│          │          │ OAuth2       │          │                  │
│ Copy key │          │ Click to     │          │ Setup scopes,    │
│ ──▶ Paste│          │ connect ──▶  │          │ tokens, webhooks │
│ ──▶ Done │          │ Popup ──▶    │          │ ──▶ Banyak       │
│          │          │ Allow ──▶    │          │     langkah!     │
│          │          │ Done         │          │                  │
└──────────┘          └──────────────┘          └──────────────────┘
  OpenAI,                Google Sheets,             Slack
  MarketStack,           Google Drive,
  Pushover,              Gmail
  Telegram

Level	Metode	Langkah	Contoh Platform
🟢 Mudah	API Key	Copy key → Paste di n8n → Selesai	OpenAI, MarketStack, Pushover, Telegram
🟡 Sedang	Pre-configured OAuth2	Klik "Connect" → Pop-up → Allow → Selesai	Google Sheets, Drive, Gmail
🔴 Sulit	Full OAuth2	Setup scopes, token, webhook, banyak bolak-balik	Slack

📱 Bagian 4: Integrasi Pushover (Satu Arah)

Pushover adalah layanan push notification yang sangat sederhana — cocok untuk mengirim alert dari workflow n8n ke ponselmu.

Setup Pushover

┌─────────────────────────────────────────────────┐
│              SETUP PUSHOVER                      │
├─────────────────────────────────────────────────┤
│ 1. Daftar di pushover.net                       │
│ 2. Dapatkan User Key (awalan "U...")            │
│ 3. Buat Application → dapat App Token ("A...")  │
│ 4. Install app Pushover di HP                   │
│ 5. Di n8n: tambahkan Pushover sebagai Tool      │
│    pada AI Agent                                │
│ 6. Masukkan kedua token di credential n8n       │
└─────────────────────────────────────────────────┘

Konfigurasi di n8n

Parameter	Nilai
Credential	User Key (U...) + App Token (A...)
Message	Let the model decide — LLM yang menentukan isi pesan
Prioritas	High (agar bersuara di HP)

Alur Kerja

[Chat Trigger] ──▶ [AI Agent] ──tool──▶ [Pushover]
                       │                     │
                       │                     ▼
                       │              📱 Notifikasi
                       │                 di HP!
                       ▼
                   [Date/Time Tool]

💡 Catatan: Pushover hanya satu arah — n8n mengirim notifikasi ke HP, tapi pengguna tidak bisa membalas lewat Pushover.

🤖 Bagian 5: Integrasi Telegram (Dua Arah)

Telegram menyediakan integrasi dua arah yang cukup mudah karena menggunakan API Key sederhana melalui BotFather.

Langkah 1: Buat Bot Telegram

┌──────────────────────────────────────────────────┐
│           MEMBUAT BOT TELEGRAM                    │
├──────────────────────────────────────────────────┤
│ 1. Buka Telegram → cari @BotFather               │
│ 2. Kirim: /start                                 │
│ 3. Kirim: /newbot                                │
│ 4. Beri nama bot (misal: "TG_Convo")             │
│ 5. Beri username (harus akhiran "bot")            │
│    misal: tg_convo_bot                            │
│ 6. BotFather memberikan API Token → COPY!         │
│    ⚠️  Hati-hati jangan copy spasi di ujung       │
└──────────────────────────────────────────────────┘

Langkah 2: Bangun Workflow di n8n

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Telegram    │────▶│   AI Agent   │────▶│   Telegram   │
│   Trigger     │     │              │     │  Send Text   │
│  (on message) │     │  + Memory    │     │   Message    │
│               │     │  + Tools     │     │              │
└──────────────┘     └──────────────┘     └──────────────┘
       │                                         │
       │         Ambil dari trigger:              │
       │         ┌────────────────────┐           │
       └────────▶│ chat.id → Chat ID  │──────────┘
                 │ text → Prompt      │
                 └────────────────────┘

Konfigurasi Kritis

Komponen	Konfigurasi
Telegram Trigger	Credential: paste API token, Event: "On Message"
AI Agent — Prompt	Source: "Define Below" → Expression: `{{ $json.message.text }}`
Telegram Send	Text: `{{ $json.output }}` (output AI Agent)
Chat ID	Expression: `{{ $node["Telegram Trigger"].json.message.chat.id }}`
Memory Session Key	Expression: Chat ID (atau username untuk persistensi antar-sesi)

Masalah Umum & Solusi

Masalah	Penyebab	Solusi
"No prompt specified"	Source masih "Chat Trigger Node"	Ubah ke "Define Below", drag `message.text`
Respons tidak masuk chat yg benar	Chat ID belum diisi	Drag `chat.id` dari Telegram Trigger
Memory tidak bekerja	Session key default	Set session key ke chat ID atau username

Publish ke Production

Setelah semuanya bekerja di mode test (Execute Workflow), tekan Publish untuk deploy. Workflow akan berjalan otomatis tanpa perlu klik "Execute" lagi. Untuk menghentikan, pilih Unpublish dari menu titik tiga.

💬 Bagian 6: Integrasi Slack (Dua Arah — Full OAuth2)

Slack adalah integrasi paling kompleks hari ini karena menggunakan OAuth2 penuh, setup scopes, dan webhook. Ini adalah latihan terbaik untuk memahami integrasi tingkat lanjut.

Alur Setup Lengkap

┌─────────────────────────────────────────────────────────────┐
│                    SETUP SLACK BOT                            │
│                                                              │
│  SLACK SIDE                          N8N SIDE                │
│  ═════════                           ════════                │
│                                                              │
│  1. Apps & Workflows                                         │
│     └─▶ Build (kanan atas)                                   │
│         └─▶ Create New App                                   │
│             └─▶ From Scratch                                 │
│                 └─▶ Beri nama + pilih workspace               │
│                                                              │
│  2. OAuth & Permissions                                      │
│     └─▶ Add OAuth Scopes:          3. Create Workflow        │
│         • app_mentions:read            └─▶ Slack Trigger     │
│         • channels:history                 (Bot/App Mention) │
│         • channels:read                └─▶ Paste Bot Token   │
│         • chat:write                   └─▶ Connection tested │
│         • im:history                                         │
│         • users:read                                         │
│     └─▶ Install to Workspace                                │
│     └─▶ Copy Bot User OAuth Token                           │
│                                                              │
│  4. Buat Channel + Invite Bot      5. Setup AI Agent         │
│     └─▶ /invite @botname              └─▶ OpenAI model      │
│     └─▶ Copy Channel ID               └─▶ Slack Send Msg    │
│         (triple dots → Edit Settings)                        │
│                                                              │
│  6. Event Subscriptions             7. Copy Webhook URL      │
│     └─▶ Enable Events                  dari n8n Trigger      │
│     └─▶ Subscribe: app_mention         (Test / Production)   │
│     └─▶ Paste Webhook URL                                    │
│     └─▶ "Verified" ✅                                        │
│     └─▶ SAVE CHANGES! ⚠️                                     │
└─────────────────────────────────────────────────────────────┘

6 OAuth Scopes yang Diperlukan

Scope	Fungsi
`app_mentions:read`	Baca pesan yang men-tag bot
`channels:history`	Lihat riwayat channel
`channels:read`	Baca info channel
`chat:write`	Kirim pesan sebagai bot
`im:history`	Lihat pesan DM
`users:read`	Lihat info anggota workspace

Trik: Kirim Seluruh JSON ke LLM

Alih-alih hanya mengirim teks pesan, kamu bisa mengirim seluruh JSON dari Slack ke AI Agent:

Prompt:
"Please respond to this message from Slack:

{{ JSON.stringify($json) }}"

LLM cukup cerdas untuk membaca dan memahami struktur JSON, jadi ia bisa mengekstrak sendiri informasi yang relevan — termasuk username, channel, timestamp, dll.

Konfigurasi Output Slack

Field	Expression
Resource	Message
Operation	Send
Channel	By ID → paste Channel ID
Message Text	`{{ $json.output }}`

Deploy ke Production

Saat deploy ke production, webhook URL berubah! Kamu harus:

Copy Production URL dari Slack Trigger di n8n
Kembali ke Slack → Event Subscriptions
Ganti Request URL dengan production URL
Pastikan muncul "Verified"
Tekan Save Changes (sering terlupa!)
Baru tekan Publish di n8n

📊 Perbandingan Tiga Integrasi

Aspek	Pushover	Telegram	Slack
Arah	Satu arah (→ HP)	Dua arah (↔)	Dua arah (↔)
Autentikasi	API Key (2 token)	API Key (BotFather)	Full OAuth2 + Scopes
Kesulitan	⭐ Mudah	⭐⭐ Sedang	⭐⭐⭐ Sulit
Webhook?	Tidak	Tidak (built-in)	Ya (manual setup)
Trigger	N/A (tool saja)	On Message (otomatis)	Bot/App Mention + Webhook
Cocok Untuk	Alert & notifikasi	Chat bot personal	Bot bisnis/tim

🔑 Konsep Penting: Webhook

Webhook adalah URL endpoint yang kamu sediakan agar sistem eksternal bisa memberi tahu n8n bahwa sesuatu telah terjadi.

  Dua Pola Komunikasi:

  1. REQUEST-RESPONSE (n8n → Platform)
     ┌──────┐    HTTP Request    ┌─────────┐
     │ n8n  │ ──────────────────▶│  Slack   │
     │      │ ◀──────────────────│         │
     └──────┘    Response        └─────────┘
     "Kirim pesan ke channel ini"

  2. WEBHOOK (Platform → n8n)
     ┌──────┐    HTTP POST       ┌─────────┐
     │ n8n  │ ◀──────────────────│  Slack   │
     │      │                    │         │
     └──────┘                    └─────────┘
     "Hey, ada pesan baru yang mention bot-mu!"

⚠️ Penting: Webhook test dan production berbeda URL. Saat publish workflow, pastikan URL di platform eksternal sudah diganti ke production URL.

📝 Glosarium Hari Ini

Istilah	Definisi
JSON	Format data key-value universal, diapit `{ }`
Expression	Nilai dinamis dalam `{{ }}` yang dievaluasi saat runtime
$json	Shortcut expression untuk data JSON dari node sebelumnya
$node["nama"]	Akses data dari node tertentu dalam workflow
JSON.stringify()	Ubah objek JSON menjadi string teks
API Key	Token sederhana untuk autentikasi — copy & paste
OAuth2	Protokol autentikasi standar dengan scopes & token
Scope	Izin spesifik yang diberikan ke aplikasi (read, write, dll.)
Webhook	URL endpoint yang dipanggil sistem luar untuk notifikasi
BotFather	Bot resmi Telegram untuk membuat dan mengelola bot baru
Publish	Deploy workflow n8n ke production (berjalan otomatis)

✅ Progress Tracker

Week 1: Automate with Workflows
=========================================
Day 1 ████████████████████ ✅ AI Agent + Setup
Day 2 ████████████████████ ✅ Teori Agentic AI
Day 3 ████████████████████ ✅ Integrasi Google
Day 4 ████████████████████ ✅ JSON + Auth + 3 Integrasi  ◀── HARI INI
Day 5 ░░░░░░░░░░░░░░░░░░░░    Proyek Bisnis
=========================================
📊 Progress: 27% kursus selesai

🏆 Pencapaian Hari Ini

╔═══════════════════════════════════════════════════╗
║  🎉  ACHIEVEMENT UNLOCKED                         ║
║                                                   ║
║  ✅  Memahami JSON: objects, arrays, nesting       ║
║  ✅  Menguasai expressions n8n ($json, $node)      ║
║  ✅  3 tingkat autentikasi (API Key → OAuth2)      ║
║  ✅  Integrasi Pushover (satu arah)                ║
║  ✅  Bot Telegram dua arah + memory + publish      ║
║  ✅  Bot Slack OAuth2 + webhook + production       ║
║  ✅  Deploy pertama ke production!                 ║
╚═══════════════════════════════════════════════════╝

📡 Day 4: JSON, Expressions, Autentikasi & Integrasi (Pushover, Telegram, Slack) ​

🎯 Tujuan Hari Ini ​

📦 Bagian 1: JSON — Bahasa Data Universal ​

Empat Blok Bangunan JSON ​

Tipe Data dalam Value ​

Contoh JSON Nyata (dari n8n) ​

⚡ Bagian 2: Expressions di n8n ​

Sintaks Dasar ​

Diagram Alur Expression ​

Toggle Fixed vs Expression ​

Tips Drag & Drop ​

🔐 Bagian 3: Tiga Tingkat Autentikasi ​

📱 Bagian 4: Integrasi Pushover (Satu Arah) ​

Setup Pushover ​

Konfigurasi di n8n ​

Alur Kerja ​

🤖 Bagian 5: Integrasi Telegram (Dua Arah) ​

Langkah 1: Buat Bot Telegram ​

Langkah 2: Bangun Workflow di n8n ​

Konfigurasi Kritis ​

Masalah Umum & Solusi ​

Publish ke Production ​

💬 Bagian 6: Integrasi Slack (Dua Arah — Full OAuth2) ​

Alur Setup Lengkap ​

6 OAuth Scopes yang Diperlukan ​

Trik: Kirim Seluruh JSON ke LLM ​

Konfigurasi Output Slack ​

Deploy ke Production ​

📊 Perbandingan Tiga Integrasi ​

🔑 Konsep Penting: Webhook ​

📝 Glosarium Hari Ini ​

✅ Progress Tracker ​

🏆 Pencapaian Hari Ini ​