# n8n (/n8n)

[n8n](https://n8n.io) adalah alat otomasi berbasis workflow. Tebar punya dua node resmi di n8n:

- **Tebar**: membuat dan menjadwalkan post, upload media, membaca akun, serta membalas dan menyembunyikan komentar.
- **Tebar Trigger**: menjalankan workflow saat sesuatu terjadi di Tebar, misalnya post terbit atau gagal, komentar baru, atau DM Instagram masuk.

Kode sumber dan rilisnya ada di [github.com/tebarapp/n8n-nodes-tebar](https://github.com/tebarapp/n8n-nodes-tebar).

<Callout>
  Node ini memakai API Tebar, jadi butuh paket berbayar: Starter, Basic, Pro, atau Agency. Lihat
  [Paket & batas](/paket).
</Callout>

## Pasang node [#pasang-node]

1. Di n8n, buka panel node (tombol **+**) lalu cari **Tebar**.
2. Kalau belum muncul, pasang manual: **Settings** → **Community nodes** → **Install**, isi `n8n-nodes-tebar`, lalu centang persetujuan dan klik **Install**.

## Hubungkan akun Tebar [#hubungkan-akun-tebar]

1. Di dashboard Tebar, buka menu akun (pojok kiri bawah) → **API key** → **Buat API key**. Centang **Izinkan menulis** kalau workflow-mu memposting atau membalas komentar. Key hanya ditampilkan sekali.
2. Di n8n, tambahkan node Tebar, lalu di **Credential** pilih **Create new credential** dan tempel API key-nya.
3. Simpan. n8n langsung mengecek key-nya ke Tebar.

| Isian    | Keterangan                                                                                                                                                                                           |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Key  | Key `tb_live_…` dari dashboard                                                                                                                                                                       |
| Profile  | Opsional. Untuk API key utama: isi External ID [workspace](/profile) supaya workflow hanya bekerja di workspace itu. Kosongkan untuk menjangkau semua workspace (post baru masuk ke workspace Utama) |
| Base URL | Biarkan `https://api.tebar.app`                                                                                                                                                                      |

Kalau kamu punya beberapa workspace dan workflow-nya hanya untuk satu klien atau brand, cara paling mudah adalah memilih workspace itu di isian **Workspace** saat membuat API key. Key seperti ini tidak bisa menyentuh workspace lain, jadi kolom Profile tidak perlu diisi.

<Callout type="warn">
  API key setara password. Simpan hanya di credential n8n, jangan di teks workflow atau sticky note.
</Callout>

## Yang bisa dilakukan node Tebar [#yang-bisa-dilakukan-node-tebar]

| Resource | Operasi                                                                                                                      |
| -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Post     | **Create** (terbit sekarang atau terjadwal), **Get**, **Get Many**, **Cancel** (post terjadwal), **Retry** (akun yang gagal) |
| Media    | **Upload** (file dari node sebelumnya, maks 100 MB), **Upload From URL**, **Get**, **Get Many**, **Delete**                  |
| Comment  | **Get Many** (misalnya yang belum dibalas), **Get**, **Reply**, **Hide**                                                     |
| Account  | **Get Many**, **Get**                                                                                                        |

Node Tebar juga bisa dipakai sebagai tool oleh **AI Agent** di n8n.

### Membuat post [#membuat-post]

- **Select Accounts**: teks dan media yang sama ke semua akun yang dipilih.
- **Targets JSON**: tulis sendiri daftar akun untuk teks, media, atau opsi yang berbeda per akun, misalnya polling Threads, Story Instagram, atau judul YouTube. YouTube wajib `title` dan `made_for_kids`, Pinterest wajib `board_id`. Daftar opsinya ada di [API Reference](/reference).

```json
[
  { "account_id": "ID_AKUN_THREADS", "options": { "poll": { "options": ["Tubruk", "Susu"] } } },
  { "account_id": "ID_AKUN_YOUTUBE", "options": { "title": "Menu baru", "made_for_kids": false } }
]
```

Hal yang perlu diingat:

- **Schedule At** dibaca dalam zona waktu workflow. Kosongkan untuk langsung terbit.
- Isi **Idempotency Key** kalau workflow bisa jalan dua kali untuk post yang sama. Tebar akan mengembalikan post pertama, bukan membuat post baru.
- Instagram dan TikTok wajib punya foto atau video. Post teks saja ke akun itu akan gagal.
- Post ke X dipotong dari saldo (Rp400, atau Rp4.000 kalau teksnya berisi link). Lihat [X](/x).

## Tebar Trigger [#tebar-trigger]

Pilih event yang ingin ditangkap, lalu aktifkan workflow. Tebar Trigger mendaftarkan [webhook](/api/webhook) di Tebar secara otomatis dan menghapusnya lagi saat workflow dinonaktifkan. Setiap kiriman dicek tanda tangannya, jadi kiriman palsu ditolak.

| Event                                                                                         | Kapan                                                                   |
| --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `post.published`, `post.failed`                                                               | Post terbit atau gagal di satu akun (gagal: setelah percobaan terakhir) |
| `comment.created`, `comment.replied`, `comment.hidden`, `comment.unhidden`, `comment.deleted` | Ada komentar baru, dibalas, disembunyikan, ditampilkan, atau dihapus    |
| `message.received`, `message.sent`                                                            | DM Instagram masuk atau terkirim                                        |
| `account.connected`, `account.expired`, `account.disconnected`                                | Akun terhubung, perlu dihubungkan ulang, atau diputus                   |
| `automation.run`, `profile.deleted`                                                           | [Automation](/automations) selesai berjalan, workspace dihapus          |

Syaratnya:

- Pakai **API key utama**. API key khusus workspace tidak bisa membuat webhook. Untuk membatasi ke satu workspace, isi kolom **Profile ID** di node Tebar Trigger.
- Tebar hanya mengirim ke alamat `https` yang bisa diakses dari internet. n8n Cloud langsung bisa. n8n self-hosted perlu `WEBHOOK_URL` berupa alamat https publik.
- Event yang sama bisa terkirim lebih dari sekali. Pakai `id` event kalau perlu menyaring duplikat.

## Contoh workflow [#contoh-workflow]

Setiap contoh sudah diuji di n8n 2.47 dengan node Tebar 0.1.2. Cara memasangnya:

1. Di n8n, buat workflow baru, klik menu **⋯** di kanan atas → **Import from URL**.
2. Tempel link contoh di bawah, lalu klik **Import**. Bisa juga unduh file JSON-nya lalu pilih **Import from file**.
3. Ikuti catatan kuning di dalam workflow: pilih credential, akun, dan isian lain yang ditandai.
4. Aktifkan workflow.

### Post foto atau video dari form [#post-foto-atau-video-dari-form]

Form n8n dengan isian caption dan satu foto atau video. File di-upload ke [Media](/media) Tebar, lalu langsung diposting ke akun yang dipilih. Cocok untuk tim yang tidak punya akses dashboard.

```txt
https://raw.githubusercontent.com/tebarapp/n8n-nodes-tebar/main/examples/form-to-post.json
```

Di node **Create post**, pilih akun yang menerima media (Instagram, Threads, TikTok, Facebook, dan lainnya). Setelah aktif, buka **Production URL** di node **Form**.

### Bagikan artikel baru dari RSS [#bagikan-artikel-baru-dari-rss]

Setiap jam, artikel baru di feed RSS diposting dengan judul dan link-nya. Artikel yang sudah ada di feed saat workflow diaktifkan tidak ikut diposting.

```txt
https://raw.githubusercontent.com/tebarapp/n8n-nodes-tebar/main/examples/rss-to-post.json
```

Ganti URL feed di node **New item in feed**, lalu pilih akun yang menerima post teks: Threads, X, LinkedIn, Facebook, Telegram, atau Discord. Ingat biaya X untuk post berisi link.

### Notifikasi Telegram saat post gagal [#notifikasi-telegram-saat-post-gagal]

Saat post gagal di satu akun, kamu menerima pesan Telegram berisi platform dan alasannya.

```txt
https://raw.githubusercontent.com/tebarapp/n8n-nodes-tebar/main/examples/failed-post-alert.json
```

Butuh bot Telegram (buat lewat [@BotFather](https://t.me/BotFather)) dan chat ID tujuanmu. Credential Tebar di node **Post failed** harus memakai API key utama.

### Rangkuman komentar belum dibalas setiap pagi [#rangkuman-komentar-belum-dibalas-setiap-pagi]

Setiap hari jam 9 pagi, Telegram menerima daftar 20 komentar terbaru yang belum dibalas, beserta link ke halaman [Komentar](/komentar). Kalau tidak ada komentar, tidak ada pesan.

```txt
https://raw.githubusercontent.com/tebarapp/n8n-nodes-tebar/main/examples/unreplied-comments-digest.json
```

Isi komentar ditulis orang lain, jadi contoh ini menampilkannya sebagai teks biasa. Karakter seperti `<`, `&`, atau `_` di komentar tidak merusak pesan Telegram.

## Kalau ada error [#kalau-ada-error]

Node menampilkan pesan error dari Tebar, misalnya `account_expired` (akun perlu dihubungkan ulang) atau `plan_required` (butuh paket berbayar). Daftar lengkapnya ada di [Error](/api/error).
