MasukMulai uji coba gratis
Meta Tech Provider

Simpan pesan dan kontak WhatsApp ke Google Sheets secara otomatis

Untuk menyimpan pesan WhatsApp Business ke Google Sheets secara otomatis, kirimkan sebagai HTTP POST bertanda tangan ke alat otomasi seperti n8n, Make, atau Zapier, lalu biarkan langkah Google Sheets-nya menambahkan satu baris per pesan: waktu, arah, nomor telepon, nama, teks, dan ID pesan. Tab kedua yang memakai nomor telepon sebagai kunci menyimpan satu baris per kontak, dan baris itu diperbarui setiap kali kontak tersebut menulis lagi.

easyCoexistence menghubungkan nomor WhatsApp Business yang Anda simpan di aplikasi ke Cloud API Meta melalui Coexistence.

7 attempts

Pengiriman forward akan dicoba kembali setelah sekitar 1, 5, 30, 120, 360, dan 1,440 menit jika URL Anda gagal.

10 s

Berapa lama POST yang diteruskan menunggu jawaban 2xx sebelum pengiriman tersebut dicoba kembali.

60 / min

Permintaan tulis Google Sheets API yang diizinkan per menit per pengguna per proyek; 300 per proyek.

Redirect

Keluaran web app Apps Script dialihkan ke URL sekali pakai di script.googleusercontent.com.

No headers

Objek event doPost pada Apps Script menampilkan body dan parameter, bukan header permintaan HTTP.

Rute mana yang harus mengisi spreadsheet?

Ada dua rute pada nomor yang pesannya melalui easyCoexistence, dan keduanya melayani kebutuhan yang berbeda. Forward URL, yang diatur sekali per nomor, meneruskan event asli dari Meta baik otomasi menjawab maupun tidak: pesan pelanggan, balasan yang diketik tim Anda di aplikasi WhatsApp Business, dan status pengiriman. Inilah rute untuk log pesan lengkap. Langkah Call my webhook di dalam otomasi hanya aktif untuk pesan yang dipilih otomasi tersebut, dan membawa chat terbaru, termasuk balasan yang baru saja dikirim otomasi. Rute ini cocok untuk spreadsheet berisi prospek, pesanan, atau permintaan yang ditangani satu otomasi. Keduanya ditandatangani, dengan rahasia yang berbeda.

Forward URL (per number)Call my webhook step (per automation)
Fires onAny message event on the number, with or without automationsOnly messages that automation is picked for
CarriesMeta's original value: messages, phone replies, statusesThe message, the contact and up to 10 recent messages
Automated repliesDelivery statuses only, without the textIn history, direction out
Retries7 attempts over about 33 hoursOne attempt
Signed withThe number's forward secret, shown onceThe automation's Signing secret
Set inNumber page, Where incoming messages go cardThe automation editor, or create_automation

Field apa yang masuk, dan kolom apa yang harus dimiliki spreadsheet?

POST yang diteruskan membungkus satu perubahan Meta: id (pengiriman), event (nama field Meta, seperti messages atau smb_message_echoes), received_at, connection (id nomor Anda, phone, dan phone_number_id), dan value, persis seperti yang dikirim Meta. Dalam value, messages berisi apa yang ditulis pelanggan, dan message_echoes berisi apa yang diketik tim Anda di ponsel. Nomor telepon datang sebagai digit dengan kode negara tanpa tanda plus; simpan kolom itu sebagai teks biasa agar Sheets tidak mengubahnya menjadi angka. Pengguna dengan username WhatsApp mungkin datang dengan user ID berlingkup bisnis di samping nomor, atau sebagai pengganti nomor, jadi sediakan satu kolom untuknya.

Timemessages[].timestamp, Unix seconds, converted to a date
Directionin for messages, out for smb_message_echoes
Phonemessages[].from, or message_echoes[].to for your replies
User IDmessages[].from_user_id, the BSUID, when Meta sends it
Namecontacts[].profile.name, the customer's WhatsApp profile name
Texttext.body, a button's text, or [image] with its caption
Message idmessages[].id, the wamid: the key that stops duplicates
Your numberconnection.phone, to tell several numbers apart

Bagaimana cara membuat log pesan di n8n?

Tiga node. Node Webhook dengan HTTP Method POST, Respond diatur ke Immediately, dan Production URL-nya disimpan sebagai Forward URL nomor tersebut. Node Code yang memeriksa X-EC-Signature dengan rahasia forward dan mengubah event menjadi baris, sambil melewati status pengiriman. Node Google Sheets dengan operasi Append or Update Row, Column to match on diatur ke Message id, sehingga pengiriman yang dicoba kembali menulis ulang baris yang sama, bukan menambah baris baru.

Rahasia forward hanya muncul sekali, saat Anda menyimpan Forward URL; jika hilang, klik New secret dan tempel yang baru. n8n Cloud mengizinkan modul crypto di node Code; n8n self-hosted memerlukan NODE_FUNCTION_ALLOW_BUILTIN=crypto.

n8n Code node (Run Once for All Items): verify a forward and return rows
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the number's forward secret, shown once when you saved the Forward URL

const { headers, body } = $input.first().json;
const sig = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(headers['x-ec-signature'] || '');
if (!sig || Math.abs(Date.now() / 1000 - Number(sig[1])) > 300) throw new Error('Bad or stale signature');
// n8n has parsed the body; it was sent as compact JSON, so JSON.stringify rebuilds the signed bytes.
const mac = crypto.createHmac('sha256', SECRET).update(sig[1] + '.' + JSON.stringify(body)).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(sig[2], 'hex'))) throw new Error('Bad signature');

const { event, connection, value } = body;
const names = Object.fromEntries((value.contacts || []).map((c) => [c.wa_id, c.profile?.name || '']));
const textOf = (m) => m.text?.body ?? m.button?.text ?? m.interactive?.button_reply?.title
  ?? m.interactive?.list_reply?.title ?? ('[' + m.type + '] ' + (m[m.type]?.caption || '')).trim();
const row = (m, direction, phone) => ({
  time: new Date(Number(m.timestamp) * 1000).toISOString(), direction, phone,
  user_id: m.from_user_id || '', name: names[phone] || '', text: textOf(m),
  message_id: m.id, number: connection.phone,
});

let rows = [];
if (event === 'messages') rows = (value.messages || []).map((m) => row(m, 'in', m.from || ''));   // statuses skipped
if (event === 'smb_message_echoes') rows = (value.message_echoes || []).map((m) => row(m, 'out', m.to || ''));
return rows.map((json) => ({ json }));

Bagaimana cara menjaga satu baris per kontak?

Tambahkan node Google Sheets kedua pada tab Contacts, juga dengan Append or Update Row, dicocokkan pada Phone. Petakan nomor telepon, nama profil, user ID, waktu, dan teks pesan terbaru. Pesan pertama dari sebuah nomor membuat barisnya; pesan berikutnya memperbarui kolom nama dan kontak terakhir, sehingga tab ini sekaligus menjadi daftar siapa yang menulis dan kapan. Simpan catatan tulisan tangan di tab terpisah, dicari berdasarkan nomor telepon, agar alur kerja tidak pernah menimpanya.

Kontak yang tersimpan di buku alamat ponsel tidak datang dengan cara ini. Meta mengirimkannya, bersama chat hingga 6 bulan, hanya ke tujuan webhook langsung yang disimpan dalam 24 jam setelah menghubungkan nomor.

Bisakah Apps Script menerima pesan secara langsung?

Tidak dengan rapi, jadi letakkan alat alur kerja di depan spreadsheet. Google menyajikan respons web app Apps Script melalui pengalihan ke URL sekali pakai script.googleusercontent.com, dan easyCoexistence tidak mengikuti pengalihan. Respons 302 dihitung sebagai pengiriman gagal: sebuah forward dicoba kembali hingga 7 kali, dan setiap percobaan menjalankan doPost lagi dan menulis baris lain, sementara langkah Call my webhook gagal dan mengirim email kepada Anda. doPost juga tidak dapat membaca header permintaan, sehingga pemeriksaan X-EC-Signature tidak mungkin dilakukan di sana.

Apps Script tetap cocok untuk arah sebaliknya, yaitu mengirim template yang disetujui dari baris spreadsheet, yang dibahas dengan kode di halaman integrasi Google Sheets.

Bisakah Make atau Zapier yang mengisi spreadsheet sebagai gantinya?

Bisa. Di Make, mulai skenario dengan Webhooks > Custom webhook lalu tambahkan Google Sheets > Add a Row; di Zapier, gunakan Webhooks by Zapier dengan Catch Raw Hook, yang mempertahankan header, lalu Google Sheets > Create Spreadsheet Row. Keduanya langsung membalas POST dengan 2xx, yang dibutuhkan forward dalam batas 10 detik. Petakan field yang sama seperti di atas dari value.messages, dan saring event yang value-nya membawa statuses, bukan messages.

Perlakukan URL hook seperti kata sandi, karena siapa pun yang memilikinya dapat mengirim baris. Jika paket Anda menyertakan langkah kode, periksa X-EC-Signature di sana dengan resep HMAC yang sama seperti di node n8n.

Bagaimana cara menghindari baris ganda atau yang hilang?

Duplikat berasal dari pengiriman yang dicoba kembali. Forward yang tidak mendapat 2xx dalam 10 detik dikirim lagi dengan header X-EC-Delivery yang sama dan id yang sama di body, dan pesan di dalamnya tetap memakai wamid-nya, sehingga pencocokan pada Message id membuat pengiriman ulang tidak berbahaya. Pada rute langkah webhook, tes dari Try it tiba dengan dry_run true: arahkan ke tab uji atau buang.

Baris yang hilang berasal dari kuota penulisan Google. Sheets API mengizinkan 60 permintaan tulis per menit per pengguna per proyek, dan satu kredensial n8n adalah satu pengguna; lonjakan balasan setelah kampanye template dapat melampaui batas itu dan menerima HTTP 429. Aktifkan Retry On Fail di pengaturan node Google Sheets, atau kumpulkan pesan selama beberapa detik lalu tambahkan dalam satu permintaan.

Cara mengonfigurasi

  1. Check the number's modeOn the number's page, the card Where incoming messages go must show Through easyCoexistence. If it shows Straight to your system, choose Through easyCoexistence.
  2. Build the workflowWebhook node (POST, Respond Immediately), the Code node above, then Google Sheets with Append or Update Row matched on Message id. Activate it and copy the Production URL.
  3. Save the Forward URLPaste the Production URL into Forward URL (optional) and click Save forward URL. Copy the signing secret shown once into the Code node.
  4. Send a test messageFrom another phone, write to your number and reply to it from the WhatsApp Business app. Two rows should appear: one in, one out.

Kesalahan umum

  • Memeriksa forward dengan Signing secret milik otomasi, atau sebaliknya. Forward URL ditandatangani dengan rahasia forward milik nomor, dan Call my webhook dengan milik otomasi itu sendiri; pilih rahasia berdasarkan header X-EC-Event.
  • Menambahkan baris per POST tanpa kunci. Pengiriman yang dicoba kembali setelah jawaban lambat menulis pesan yang sama dua kali; gunakan Append or Update Row yang dicocokkan pada ID pesan.
  • Menulis status pengiriman sebagai pesan. Event messages juga membawa status sent, delivered, dan read di value.statuses, yang tidak punya teks dan membuat baris kosong.
  • Menyimpan URL web app Apps Script sebagai Forward URL. Pengalihannya dihitung sebagai kegagalan, sehingga setiap dari 7 percobaan menjalankan doPost lagi dan menambah baris duplikat.
Melakukan ini dengan EasyCoexistence

Dengan mode Automations on, Forward URL meneruskan event asli Meta ke alur kerja Anda, ditandatangani dengan rahasia yang hanya Anda pegang dan dicoba kembali saat URL Anda mati, dan langkah Call my webhook mengirim apa yang ditangani otomasi, beserta balasannya. Keduanya termasuk dalam paket. US$ 9 turun ke US$ 0.75 per nomor per bulan, makin turun seiring Anda menambah nomor, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah spreadsheet menerima pesan yang diketik tim saya di ponsel?

Ya, lewat Forward URL. Balasan yang diketik di aplikasi WhatsApp Business datang sebagai event smb_message_echoes, dengan nomor pelanggan di to. Balasan yang dikirim otomasi hanya kembali sebagai status pengiriman, jadi catat teksnya dari langkah Call my webhook yang diletakkan setelah balasan.

Bisakah saya memuat chat yang sudah ada ke dalam spreadsheet?

Tidak untuk nomor yang pesannya melalui easyCoexistence. Meta hanya mengirim chat satu-ke-satu hingga 6 bulan ke tujuan webhook langsung yang disimpan dalam 24 jam setelah menghubungkan, sekali per koneksi. Nomor yang dirutekan melalui easyCoexistence mencatat sejak Forward URL disimpan.

Apakah easyCoexistence menyimpan salinan pesan?

Sebagian. Pada nomor yang dirutekan melalui easyCoexistence dengan otomasi aktif, teks pesan disimpan selama periode yang Anda pilih, 30, 90, atau 365 hari (default 90 hari), dan ditampilkan di Conversations; pengiriman forward ditahan hingga 7 hari untuk percobaan ulang, dan log eksekusi selama 30 hari. Spreadsheet adalah salinan permanen Anda.

Bisakah AI saya membaca spreadsheet untuk menjawab pelanggan?

Tidak dari langkah Reply with AI, yang hanya membaca Instructions dan chat. Agen AI dapat mencari data melalui tool HTTP kustom, dan langkah Call my webhook atau Call an API dapat mengirim pertanyaan ke alur kerja yang mencari jawabannya di spreadsheet dan mengembalikannya sebagai balasan.

Lanjut membaca

Siap memulai?

Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.

Mulai uji coba gratis

Diverifikasi pada