Copy page

Integrasi

n8n

Node tumbuh.ai untuk n8n memanggil Public API memakai API key Anda. Cocok untuk mengirim pesan otomatis dari workflow n8n.

Sebelum mulai

• Paket Anda menyertakan akses API.
• Anda sudah membuat API key dengan scope yang sesuai (lihat API Key dan Scope).
• Node tumbuh.ai sudah terpasang di instans n8n Anda. Minta nama pemasangan yang tepat ke tim support bila belum ada.

Membuat kredensial

1. Di n8n, buat kredensial baru bernama "tumbuh.ai API" (nama mengikuti merek deployment Anda).
2. Isi "API Key" dengan key dari Pengembang > API Keys.
3. Isi "API Base URL" dengan alamat Public API deployment Anda, yaitu https://<domain-anda>/api/v1/public.
4. Simpan. n8n menguji kredensial dengan memanggil /health.

Jangan arahkan "API Base URL" ke alamat yang tidak Anda percaya, karena API key dikirim ke sana.

Operasi yang tersedia

Operasi	Fungsi
"Send Message"	Kirim pesan ke pelanggan lewat WhatsApp, Instagram, atau Messenger. Pelanggan dicari lewat "Customer ID", "Phone Number", atau "Instagram Username".
"List Templates"	Daftar template WhatsApp.
"Get Template"	Ambil satu template berdasarkan "Template ID".
"Mark as Read"	Tandai pesan sebagai terbaca.
"Send Typing Indicator"	Tampilkan indikator mengetik.

Tiap operasi membutuhkan scope tertentu pada API key. Cek di API Reference.

Memicu workflow dari pesan masuk

Node ini tidak punya trigger. Untuk memulai workflow saat pesan masuk, buat node Webhook di n8n lalu daftarkan URL-nya di Webhook Keluar.

Hasil yang diharapkan

Eksekusi node mengembalikan respons dari tumbuh.ai, dan pesan muncul di OneInbox.

Masalah umum

• Tes kredensial gagal dengan 401: key salah, dicabut, atau kedaluwarsa. Lihat Autentikasi.
• 403 insufficient_scope: key belum punya scope untuk operasi itu. Buat key baru, scope tidak bisa diubah.
• 429: batas laju terlampaui. Lihat Rate Limit dan Error.
• Pesan WhatsApp ditolak di luar jendela 24 jam: gunakan template. Lihat Konsep Dasar.