Ctrlk

Instagram Nodes

Dua node ini menghubungkan N8N langsung ke akun Instagram yang sudah terhubung di dibales.ai. Instagram Trigger menangkap event masuk sebagai pemicu workflow, sementara Instagram (action node) mengirim pesan dan mengelola komentar.

Pastikan kamu sudah:

  • Menginstall package n8n-nodes-dibales-ai di instance N8N kamu

  • Membuat credential dibales.ai account di N8N menggunakan API Key dari dashboard dibales.ai

  • Menghubungkan akun Instagram ke dashboard dibales.ai Integrasi Akun Instagram

Node 1: Instagram Trigger

Memulai workflow setiap kali ada event masuk dari akun Instagram yang terhubung.

Parameter

Parameter
Keterangan

Webhook URLs

URL endpoint yang didaftarkan ke dashboard dibales.ai. Tersedia dua mode: Test URL untuk pengujian saat workflow belum aktif, dan Production URL untuk workflow yang sudah aktif dan dipublish.

Webhook Secret

String rahasia yang disalin dari halaman Webhooks di dashboard dibales.ai. Digunakan untuk memverifikasi bahwa kiriman event benar-benar dari sistem dibales.ai.

Setup

  1. Tambahkan node Instagram Trigger ke workflow kamu Cari dibales.ai - Instagram di panel node N8N, pilih sebagai trigger.

  2. Salin Webhook URL Buka node, expand bagian Webhook URLs, klik tab Test URL & Production URL, lalu copy URL-nya.

  3. Buka dashboard dibales.ai, pilih agent yang ingin dihubungkan → halaman Webhooks → klik Tambah Webhook.

  4. Paste url webhook dari N8N untuk Test URL, dan ulangi dengan klik Tambah Webhook untuk Production URL

OPTIONAL

  1. Salin Webhook Secret Setelah webhook dibuat, salin nilai Secret yang tampil di dashboard.

  1. Paste Secret ke node Kembali ke N8N, buka node Instagram Trigger, paste secret ke field Webhook Secret, lalu simpan workflow.

Bagian ini berfungsi untuk mengamankan URL webhook agar tidak bisa diakses tanpa secret key tersebut

Pastikan secret key sesuai dengan webhook url yang digunakan

✅ Selesai! Workflow akan aktif menerima event dari Instagram. Setiap event yang masuk akan muncul sebagai satu execution di tab Executions.

Output Ports

Node ini memiliki 11 output port. Setiap port aktif untuk tipe event yang berbeda, sehingga kamu bisa membuat routing langsung dari satu trigger ke flow yang berbeda.

Port
Event
Keterangan

0. Message Received

DM baru masuk dari kontak

Teks, gambar, video, audio, file, atau share konten yang dikirim ke akun kamu

1. Message Echo

Pesan yang dikirim dari akun kamu sendiri

Berguna untuk logging atau monitoring pesan keluar

2. Reaction

Kontak menambahkan atau menghapus reaksi emoji pada pesan

Field raw.reaction.action berisi react atau unreact

3. Postback

Kontak menekan tombol pada button template atau generic template

Field raw.postback.payload berisi payload tombol yang ditekan

4. Quick Reply

Kontak menekan opsi quick reply yang kamu kirim

Field raw.message.quick_reply.payload berisi payload opsi yang dipilih

5. Read Receipt

Pesan yang kamu kirim sudah dibaca oleh kontak

6. Story Reply

Kontak membalas story kamu via DM

Field raw.message.reply_to.story.id berisi ID story yang dibalas

7. Story Mention

Kontak mention akun kamu di story-nya

URL story tersedia di raw.message.attachments[0].payload.url

8. Comment Created

Komentar baru di post atau reel kamu

Termasuk reply komentar — cek raw.parent_id untuk bedakan komentar utama vs reply

9. Live Comment Created

Komentar baru di IG Live kamu

10. Other

Event lain yang tidak masuk kategori di atas

Bisa dipakai untuk debugging atau menangkap event baru

💡 Sambungkan hanya port yang kamu butuhkan. Port yang tidak terhubung tidak akan mempengaruhi performa workflow.

Struktur Data Trigger

Payload Instagram menggunakan key raw. Gunakan ekspresi berikut untuk mengakses field dari event di node selanjutnya:

Field tersedia di semua event:

Field
Ekspresi N8N

Tipe event

{{ $json.event_type }}

Timestamp event

{{ $json.occurred_at }}

Untuk event DM (Message Received dan Message Echo):

Field
Ekspresi N8N

ID pengirim

{{ $json.raw.sender.id }}

ID penerima

{{ $json.raw.recipient.id }}

Isi teks

{{ $json.raw.message.text }}

ID pesan (mid)

{{ $json.raw.message.mid }}

Untuk event komentar (Comment Created):

Field
Ekspresi N8N

ID komentar

{{ $json.raw.id }}

Username komentator

{{ $json.raw.from.username }}

Isi komentar

{{ $json.raw.text }}

ID media (post/reel)

{{ $json.raw.media.id }}

ID komentar induk (jika reply)

{{ $json.raw.parent_id }}

💡 Untuk balas DM masuk, gunakan {{ $json.raw.sender.id }} sebagai Recipient Platform ID di node Instagram Send.

Node 2: Instagram

Action node untuk mengirim pesan dan mengelola komentar melalui akun Instagram di dibales.ai.

Credential

Di field Credential, pilih credential dengan tipe dibales.ai account. Jika belum ada, buat credential baru dan isi dengan API Key yang tersedia di dashboard dibales.ai.

Resource: Message

Operation: Send

Kirim pesan ke kontak via DM Instagram.

Parameter utama yang selalu ada:

Parameter
Keterangan

Recipient Platform ID

ID Instagram pengguna tujuan. Ambil dari trigger event: {{ $json.raw.sender.id }}

Type

Pilih tipe pesan yang akan dikirim (lihat daftar di bawah).

Type: Text

Parameter
Keterangan

Text

Isi teks pesan.

Quick Replies

(Opsional) Tambahkan opsi pilihan cepat yang muncul di bawah pesan. Klik Add Quick Reply, isi Title (label tombol) dan Payload (string yang dikirim balik saat opsi dipilih). Maksimal 13 quick reply per pesan.

Type: Button Template

Parameter
Keterangan

Text

Teks utama pesan yang tampil di atas tombol.

Buttons

Daftar tombol. Klik Add Button, isi Title (label tombol) dan Payload (string yang dikirim balik saat tombol ditekan). Maksimal 3 tombol.

Type: Image / Video / Audio / File

Parameter
Keterangan

URL

URL publik dari file media yang akan dikirim. File harus bisa diakses secara publik.

Type: Generic Template (Carousel)

Kirim pesan dalam format kartu yang bisa digeser (carousel). Setiap kartu bisa berisi gambar, judul, subjudul, dan tombol.

Parameter
Keterangan

Elements

Daftar kartu. Klik Add Element untuk menambah kartu baru.

Image URL

URL gambar untuk kartu (per element).

Title

Judul kartu (per element).

Subtitle

(Opsional) Teks deskripsi di bawah judul (per element).

Buttons

(Opsional) Tombol di bawah kartu. Isi Title dan Payload per tombol (per element).

Operation: React

Tambahkan reaksi emoji ke pesan yang sudah terkirim.

Parameter
Keterangan

Platform Message ID

ID pesan di Instagram yang akan diberi reaksi. Ambil dari output send node sebelumnya: platform_message_id

Recipient Platform ID

ID kontak penerima

Reaction

Pilih emoji reaksi dari dropdown

Resource: Comment

Operasi untuk mengelola komentar di post dan reel Instagram.

Operation
Fungsi
Parameter Utama

Reply

Balas komentar di post/reel

Comment ID: ID komentar yang dibalas, Text: isi balasan

Hide

Sembunyikan komentar

Comment ID: ID komentar yang akan disembunyikan

Unhide

Tampilkan kembali komentar yang tersembunyi

Comment ID: ID komentar yang akan ditampilkan

Delete

Hapus komentar

Comment ID: ID komentar yang akan dihapus

💡 Comment ID bisa diambil langsung dari output port Comment Created: {{ $json.raw.id }}

Output Data

Semua operation di Resource: Message > Send mengembalikan output dengan struktur yang konsisten:

Field
Tipe
Keterangan

message_id

String

ID pesan di sistem dibales.ai

platform_message_id

String

ID pesan asli di Instagram. Gunakan ini untuk operation React

sent_at

String (ISO 8601)

Timestamp saat pesan terkirim

Akses field ini di node berikutnya dengan ekspresi: {{ $json.message_id }}, {{ $json.platform_message_id }}, dst.

Last updated