Hubungkan WhatsApp ke n8n melalui Cloud API resmi

Bagaimana pesan WhatsApp masuk ke workflow n8n?

Meta mengirimkan setiap pesan yang masuk ke nomor tersebut ke satu URL yang Anda tentukan, melalui HTTP POST. URL itu adalah seluruh integrasi. Tempatkan simpul Webhook n8n pada URL produksi, tetapkan sebagai tujuan webhook nomor tersebut, dan workflow akan berjalan setiap kali ada pesan masuk.

Payload membawa pengirim, teks atau referensi media, cap waktu, dan ID pesan. Setelah itu, prosesnya menjadi workflow n8n biasa: buat percabangan berdasarkan isi, cari data pelanggan, panggil layanan lain yang Anda gunakan, lalu tentukan apakah perlu membalas.

Karena ini adalah Coexistence, pesan yang sama juga tetap ada di aplikasi WhatsApp Business pada ponsel. Manusia dapat menjawabnya. Workflow melihat pesan yang dikirim manusia, dan manusia melihat pesan yang dikirim workflow, sehingga keduanya tidak saling menimpa balasan.

{
  "from": "14155550188",
  "id": "wamid.HBgLMTQxNTU1NTAxODgVAgAS",
  "timestamp": "1758412800",
  "type": "text",
  "text": { "body": "do you have anything friday?" }
}

Bagaimana workflow mengirim balasan?

Gunakan simpul HTTP ke Cloud API dengan `phone_number_id` dan token akses nomor tersebut. Keduanya dapat dibaca dari dashboard atau melalui konektor MCP jika Anda ingin assistant mengambilnya.

Yang dikirim bergantung pada waktu, dan bagian ini sering mengecoh pengguna. Dalam 24 jam sejak pesan terakhir pelanggan, teks bebas dapat digunakan dan balasannya adalah apa pun yang dibuat workflow. Di luar jendela itu, hanya template yang sudah disetujui Meta yang dapat dikirim. Workflow yang hanya mengirim teks bebas akan terlihat sempurna saat pengujian, karena pengujian selalu dilakukan beberapa detik setelah pesan, lalu berhenti pada kasus nyata pertama yang berlangsung semalaman.

Bentuk yang kuat adalah percabangan: periksa berapa lama sejak pesan masuk terakhir, lalu pilih teks bebas atau template sesuai hasilnya.

Apakah n8n juga dapat menggunakan konektor MCP?

Ya, dan n8n cukup berbeda dalam hal ini. Simpul MCP Client Tool-nya terhubung ke server MCP jarak jauh dan mendukung OAuth2, sesuai kebutuhan kami, sehingga simpul AI Agent dalam workflow dapat memanggil alat kami secara langsung.

Hal ini penting karena sebagian besar platform otomasi tidak dapat melakukannya. Make dan Zapier sama-sama menjalankan server MCP milik mereka sendiri dan tidak berfungsi sebagai klien, sehingga keduanya tidak dapat menjangkau server pihak ketiga. n8n bisa.

Kegunaannya adalah untuk bagian tindakan: simpul agent yang memutuskan untuk mengirim pesan, memeriksa kondisi nomor, atau membaca status persetujuan template saat workflow berjalan. Yang tidak dapat dilakukan MCP adalah menggantikan webhook, karena MCP tidak memiliki cara untuk dibangunkan oleh pesan masuk.

Jalur mana yang harus digunakan workflow?

Gunakan keduanya untuk bagian yang berbeda, dan pembagian ini bukan soal preferensi.

Webhook adalah cara sesuatu dimulai. Pelanggan menulis pesan, Meta mengirimkannya ke simpul Webhook Anda, lalu workflow berjalan. Tidak ada padanan MCP untuk hal ini di alat mana pun, karena protokolnya berbentuk permintaan dan respons, bukan sesuatu yang dapat dipanggil dari luar.

MCP Client Tool digunakan oleh agent di dalam workflow untuk bertindak tanpa Anda menulis panggilan secara manual. Jika workflow sudah mengetahui persis apa yang harus dikirim, simpul HTTP ke Cloud API lebih sederhana dan memiliki lebih sedikit titik kesalahan. Jika agent yang mengambil keputusan, konektor menyediakan 11 alat beserta aturan dalam deskripsinya, termasuk jendela 24 jam.

Apa perbedaan ini dari simpul WhatsApp n8n yang sudah banyak digunakan?

Sebagian besar setup WhatsApp n8n yang beredar dibuat di atas gateway tidak resmi yang masuk sebagai perangkat tertaut. Produk itu berbeda dari Coexistence. Biayanya bergantung pada penyedia gateway, dan mekanismenya menempatkan nomor pada risiko karena melanggar ketentuan WhatsApp. Meta mendeteksi pola lalu lintasnya, bukan hanya pustaka yang digunakan.

Jalur umum lainnya adalah API resmi tanpa Coexistence, yang berfungsi tetapi memindahkan nomor. Aplikasi WhatsApp Business berhenti berfungsi pada nomor tersebut, sehingga tim yang sebelumnya menjawab sepanjang hari harus berpindah ke alat baru. Bagi sebagian besar bisnis kecil, ini tidak dapat diterima, sehingga banyak yang akhirnya menggunakan gateway tidak resmi.

Coexistence adalah kombinasi yang sebelumnya belum tersedia: API resmi, sementara ponsel tetap berfungsi.

Kesalahan umum

• Menggunakan URL Pengujian n8n sebagai tujuan webhook. URL itu berhenti mendengarkan saat editor ditutup, sehingga pesan dikirim ke tujuan yang tidak menerima apa pun.
• Tidak menjawab permintaan verifikasi Meta. Meta mengirim GET dengan challenge sebelum mengirimkan apa pun, dan simpul yang tidak mengembalikannya tidak akan pernah menerima pesan.
• Membalas dengan teks bebas di luar jendela 24 jam. Dari sudut pandang workflow, proses ini gagal tanpa tanda yang jelas, dan hanya template yang disetujui yang dapat dikirim.

Pertanyaan yang sering diajukan

Lanjut membaca