n8n-nodes-revora

Custom node n8n untuk Revora — kirim pesan WhatsApp dan terima event masuk langsung di workflow n8n, tanpa perlu susun HTTP Request/Webhook node manual.

Isi paket

• Revora (action node) — operasi:
  • Send Text / Image / Video / Document / Audio (voice note) Message
  • Send Location / Contact / Poll
  • Send Buttons / Send List (pesan interaktif)
  • Send Template (dengan variable substitution + optional media)
  • Set Typing Presence (Start Typing / Stop Typing / Recording / Available / Unavailable)
  • React to Message, Mark as Read, Edit Message, Revoke Message
  • Send Broadcast Campaign (banyak sesi sekaligus, target individual/grup, pesan statis atau template + media)
  • Bisa dipakai sebagai Tool oleh AI Agent node n8n (usableAsTool) — LLM bisa memutuskan sendiri kapan mengirim WhatsApp berdasarkan isi percakapan
• Revora Trigger (trigger node) — menjalankan workflow saat Revora mengirim webhook event (default: message.received, bisa juga message.status, message.addon, session.status, group.event). Registrasi & hapus webhook di Revora dilakukan otomatis saat workflow diaktifkan/dinonaktifkan.
• Revora API (credential) — Base URL + API Key (revora_..., dari Dashboard → Settings → API Keys).

Field Session (di kedua node) dan Template (di operasi Send Template) memakai resourceLocator: bisa pilih dari dropdown pencarian ("From List", fetch langsung dari akun Revora-mu) atau isi ID manual — tidak perlu lagi copy-paste sessionId/templateId mentah dari dashboard.

Setup development

npm install
npm run build

Coba di n8n lokal (belum publish ke npm)

npm link
cd ~/.n8n/custom   # buat foldernya kalau belum ada
npm link n8n-nodes-revora

Lalu jalankan n8n seperti biasa (n8n start) — node "Revora" dan "Revora Trigger" akan muncul di panel node.

Kalau sedang aktif development, npm run dev (tsc --watch) lalu restart n8n tiap ada perubahan cukup — tidak perlu npm link ulang.

Kredensial

Field Base URL default ke https://server.sanscode.id/api/v1 — hanya diubah kalau self-host Revora sendiri. Field API Key ambil dari Dashboard Revora, bukan session dashboard biasa.

Catatan Revora Trigger

• Kolom Session ID & Events hanya dibaca ulang oleh Revora saat webhook pertama kali dibuat (workflow diaktifkan). Kalau kamu ubah salah satunya setelah workflow pernah aktif, nonaktifkan lalu aktifkan lagi workflow-nya supaya Revora dikabari ulang.

• Verifikasi X-Webhook-Signature (HMAC-SHA256) dilakukan otomatis di dalam node — payload yang tidak valid ditolak dengan HTTP 401 sebelum masuk ke workflow.

• Path webhook n8n sendiri (URL production/test yang di-generate n8n) sudah acak & sulit ditebak, jadi signature check ini sifatnya defense-in-depth, bukan satu-satunya proteksi.

• Chat Type (khusus event Message Received) memfilter pesan langsung di dalam node, sebelum masuk ke workflow — tidak perlu Filter/IF node tambahan lagi:

  • Individual Chats Only (default) — hanya pesan 1:1 (JID @s.whatsapp.net / @lid)
  • Group Chats Only — hanya pesan dari grup (@g.us)
  • All — semua event diteruskan apa adanya, termasuk broadcast list (@broadcast) dan newsletter/channel (@newsletter)

  Baik "Individual" maupun "Group" otomatis mengecualikan broadcast & newsletter, karena keduanya bukan salah satu dari dua jenis chat itu.

• Status Filter (khusus event Message Status) — pilih status tertentu (mis. hanya "Failed") supaya workflow cuma jalan untuk kasus itu, tanpa IF node tambahan. Kosongkan untuk meneruskan semua status (sent/delivered/read/played/failed/cancelled).

AI Agent Tool

Node Revora bisa ditambahkan sebagai Tool ke AI Agent node bawaan n8n (cari "Revora" di panel "Add Tool"). Begitu ditambahkan, LLM bisa memanggil operasi apa pun di atas (Send Text, Send Image, dst) sendiri berdasarkan konteks percakapan — n8n otomatis menghasilkan skema parameter untuk agent dari properties node ini, jadi tidak perlu konfigurasi tambahan.

Publish ke npm (community node resmi)

npm run build
npm publish

Nama paket harus diawali n8n-nodes- (sudah sesuai) supaya bisa dipasang lewat "Install a community node" langsung dari UI n8n. Submit ke n8n community nodes verification kalau mau muncul di listing resmi tanpa embel-embel "unverified".