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
| Berkas | n8n-nodes-witalk-0.1.0.tgz |
| SHA-256 | 4c2c317776c8502ad9338ed77fda229d481026f0ff4b2d8823a933ce0f50e8b4 |
| Nama paket | n8n-nodes-witalk |
| Node | WiTalk (n8n-nodes-witalk.witalk), WiTalk Trigger (n8n-nodes-witalk.witalkTrigger) |
| Kredensial | WiTalk Business API (witalkApi) |
| Butuh | n8n 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:
| Kolom | Isi |
|---|---|
| Alamat Server | alamat server WiTalk perusahaan, misalnya https://talk.wiracode.com |
| Versi API | v21.0 (versi Graph mana pun diterima) |
| Phone Number ID | 15 angka dari admin |
| WABA ID | 15 angka dari admin, untuk template |
| Token | wtb_... dari admin |
| App Secret | dari 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.
| Resource | Operasi | Yang diisi |
|---|---|---|
| Pesan | Kirim Teks | Teks, Pratinjau Tautan |
| Pesan | Kirim Media | Jenis (gambar, dokumen, audio, video, stiker), Sumber (tautan https, media ID, atau data biner node sebelumnya), Keterangan, Nama Berkas |
| Pesan | Kirim Tombol | Judul, Isi, Catatan Kaki, sampai 3 tombol (ID dan Judul) |
| Pesan | Kirim Daftar Pilihan | Judul, Isi, Catatan Kaki, Label Tombol Daftar, pilihan (Bagian, ID, Judul, Keterangan) |
| Pesan | Kirim Tombol Tautan | Judul, Isi, Catatan Kaki, Teks Tombol, Alamat Tautan |
| Pesan | Kirim Template | Nama, Bahasa, Parameter Isi (berurutan, atau dengan Nama), Parameter Judul, Komponen Tambahan (JSON WhatsApp) |
| Pesan | Kirim Lokasi | Latitude, Longitude, Nama Tempat, Alamat |
| Pesan | Kirim Reaksi | ID Pesan, Emoji (kosong untuk menghapus) |
| Pesan | Tandai Dibaca | ID Pesan, Tampilkan Sedang Mengetik |
| Pesan | Kirim JSON WhatsApp | isi POST /messages WhatsApp apa adanya |
| Media | Unggah, Ambil Info, Unduh, Hapus | properti biner atau Media ID |
| Template | Daftar, Buat (JSON WhatsApp), Hapus |
Keluaran pengiriman adalah jawaban API apa adanya; ID pesan ada di messages[0].id.
Node WiTalk Trigger
- Tambahkan WiTalk Trigger, pilih kredensial, isi Verify Token dengan kata rahasia bebas, pilih Peristiwa (Pesan Masuk, Status Pesan, atau keduanya), lalu aktifkan workflow.
- Salin Production URL node itu.
- 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:
| Kolom | Isi |
|---|---|
event | message atau status |
from, name | wa_id dan nama pengirim (pesan) |
id | wamid pesan |
type | text, image, document, audio, video, location, contacts, interactive, button, reaction, unsupported |
text.body | isi teks |
interactive.button_reply.id, interactive.list_reply.id | pilihan yang ditekan |
button.payload | balas cepat template |
context.id | wamid pesan yang dibalas |
status, recipient_id | sent, delivered, read dan penerimanya (status) |
raw | isi 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.