Node n8n WiTalk

Node n8n untuk API Bisnis WiTalk: kirim pesan dari akun resmi perusahaan dan jalankan workflow saat karyawan membalas, menekan tombol, atau membaca pesan. Paket ini tidak ada di daftar community node n8n; dipasang langsung dari berkas di bawah ke n8n yang Anda kelola sendiri (Docker atau npm). n8n Cloud tidak bisa memasang node seperti ini.

Paket

Berkasn8n-nodes-witalk-0.1.0.tgz
SHA-2564c2c317776c8502ad9338ed77fda229d481026f0ff4b2d8823a933ce0f50e8b4
Nama paketn8n-nodes-witalk
NodeWiTalk (n8n-nodes-witalk.witalk), WiTalk Trigger (n8n-nodes-witalk.witalkTrigger)
KredensialWiTalk Business API (witalkApi)
Butuhn8n 1.x atau 2.x yang dipasang sendiri

Memasang di n8n Docker

Ganti n8n dengan nama kontainer Anda. Folder /home/node/.n8n harus berupa volume agar node tetap ada saat kontainer diperbarui.

# Unduh n8n-nodes-witalk-0.1.0.tgz dari tautan di tabel Paket ke folder ini, lalu:
echo "4c2c317776c8502ad9338ed77fda229d481026f0ff4b2d8823a933ce0f50e8b4  n8n-nodes-witalk-0.1.0.tgz" | sha256sum -c -
docker cp n8n-nodes-witalk-0.1.0.tgz n8n:/tmp/
docker exec -u node n8n sh -c 'mkdir -p /home/node/.n8n/nodes && cd /home/node/.n8n/nodes && npm install --omit=dev /tmp/n8n-nodes-witalk-0.1.0.tgz'
docker restart n8n

Untuk Docker Compose, gunakan docker compose exec -u node <layanan> ... dan docker compose restart <layanan>. Bila n8n memakai N8N_USER_FOLDER lain, pasang di folder nodes di dalamnya.

Memasang di n8n tanpa Docker

mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes
npm install --omit=dev /path/ke/n8n-nodes-witalk-0.1.0.tgz

Lalu mulai ulang n8n. Sesudahnya node WiTalk dan WiTalk Trigger muncul di pencarian node.

Kredensial

Admin WiTalk membuat akun resmi di aplikasi (Setelan, Admin, Akun resmi (API)) dan memberikan datanya. Di n8n buat kredensial WiTalk Business API:

KolomIsi
Alamat Serveralamat server WiTalk perusahaan, misalnya https://talk.wiracode.com
Versi APIv21.0 (versi Graph mana pun diterima)
Phone Number ID15 angka dari admin
WABA ID15 angka dari admin, untuk template
Tokenwtb_... dari admin
App Secretdari admin, untuk memeriksa tanda tangan webhook

Tombol uji kredensial memanggil GET /{versi}/{phone-number-id}.

Node WiTalk

Penerima boleh nomor kantor karyawan (0812... atau 62812...), nama pengguna, NIK, email, atau from dari WiTalk Trigger. Balas Pesan diisi wamid pesan yang dibalas.

ResourceOperasiYang diisi
PesanKirim TeksTeks, Pratinjau Tautan
PesanKirim MediaJenis (gambar, dokumen, audio, video, stiker), Sumber (tautan https, media ID, atau data biner node sebelumnya), Keterangan, Nama Berkas
PesanKirim TombolJudul, Isi, Catatan Kaki, sampai 3 tombol (ID dan Judul)
PesanKirim Daftar PilihanJudul, Isi, Catatan Kaki, Label Tombol Daftar, pilihan (Bagian, ID, Judul, Keterangan)
PesanKirim Tombol TautanJudul, Isi, Catatan Kaki, Teks Tombol, Alamat Tautan
PesanKirim TemplateNama, Bahasa, Parameter Isi (berurutan, atau dengan Nama), Parameter Judul, Komponen Tambahan (JSON WhatsApp)
PesanKirim LokasiLatitude, Longitude, Nama Tempat, Alamat
PesanKirim ReaksiID Pesan, Emoji (kosong untuk menghapus)
PesanTandai DibacaID Pesan, Tampilkan Sedang Mengetik
PesanKirim JSON WhatsAppisi POST /messages WhatsApp apa adanya
MediaUnggah, Ambil Info, Unduh, Hapusproperti biner atau Media ID
TemplateDaftar, Buat (JSON WhatsApp), Hapus

Keluaran pengiriman adalah jawaban API apa adanya; ID pesan ada di messages[0].id.

Node WiTalk Trigger

  1. Tambahkan WiTalk Trigger, pilih kredensial, isi Verify Token dengan kata rahasia bebas, pilih Peristiwa (Pesan Masuk, Status Pesan, atau keduanya), lalu aktifkan workflow.
  2. Salin Production URL node itu.
  3. Di aplikasi WiTalk, admin membuka akun resmi, mengisi Webhook dengan URL tadi dan Verify Token yang sama, lalu menekan Simpan & verifikasi.

Satu akun resmi punya satu alamat webhook. Node ini menjawab verifikasi hub.challenge dan menolak kiriman yang tanda tangannya tidak cocok dengan App Secret.

Setiap pesan atau status menjadi satu item:

KolomIsi
eventmessage atau status
from, namewa_id dan nama pengirim (pesan)
idwamid pesan
typetext, image, document, audio, video, location, contacts, interactive, button, reaction, unsupported
text.bodyisi teks
interactive.button_reply.id, interactive.list_reply.idpilihan yang ditekan
button.payloadbalas cepat template
context.idwamid pesan yang dibalas
status, recipient_idsent, delivered, read dan penerimanya (status)
rawisi webhook utuh

Contoh Workflow

Membalas otomatis saat karyawan menekan tombol Hadir atau Izin. Salin JSON ini, lalu tempel di kanvas n8n (Ctrl+V) dan pilih kredensialnya.

{
  "nodes": [
    {
      "name": "WiTalk Trigger",
      "type": "n8n-nodes-witalk.witalkTrigger",
      "typeVersion": 1,
      "position": [0, 0],
      "parameters": { "verifyToken": "ganti-kata-rahasia", "events": ["messages"], "checkSignature": true }
    },
    {
      "name": "Jawaban tombol?",
      "type": "n8n-nodes-base.if",
      "typeVersion": 2,
      "position": [240, 0],
      "parameters": {
        "conditions": {
          "options": { "caseSensitive": true, "leftValue": "", "typeValidation": "strict" },
          "conditions": [
            { "id": "jenis", "leftValue": "={{ $json.type }}", "rightValue": "interactive", "operator": { "type": "string", "operation": "equals" } }
          ],
          "combinator": "and"
        },
        "options": {}
      }
    },
    {
      "name": "Balas",
      "type": "n8n-nodes-witalk.witalk",
      "typeVersion": 1,
      "position": [480, 0],
      "parameters": {
        "resource": "message",
        "operation": "sendText",
        "to": "={{ $json.from }}",
        "replyTo": "={{ $json.id }}",
        "text": "=Terima kasih, {{ $json.name }}. Jawaban \"{{ $json.interactive.button_reply.title }}\" sudah dicatat."
      }
    }
  ],
  "connections": {
    "WiTalk Trigger": { "main": [[{ "node": "Jawaban tombol?", "type": "main", "index": 0 }]] },
    "Jawaban tombol?": { "main": [[{ "node": "Balas", "type": "main", "index": 0 }], []] }
  }
}

Pesan dengan tombolnya dikirim dari workflow lain memakai WiTalk, operasi Kirim Tombol, dengan tombol hadir / Hadir dan izin / Izin.

Memperbarui

Versi baru diumumkan di halaman ini. Pasang berkas .tgz yang baru dengan perintah yang sama, lalu mulai ulang n8n.