# 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](/developer/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](/api).

## 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](/integrasi/webhook).

## Hasil yang diharapkan

Eksekusi node mengembalikan respons dari tumbuh.ai, dan pesan muncul di [OneInbox](/fitur-utama/oneinbox).

## Masalah umum

- **Tes kredensial gagal dengan 401:** key salah, dicabut, atau kedaluwarsa. Lihat [Autentikasi](/developer/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](/developer/rate-limit-dan-error).
- **Pesan WhatsApp ditolak di luar jendela 24 jam:** gunakan template. Lihat [Konsep Dasar](/memulai/konsep-dasar).