Simpan mesej dan kenalan WhatsApp ke Google Sheets secara automatik
Untuk menyimpan mesej WhatsApp Business ke Google Sheets secara automatik, hantar mesej sebagai HTTP POST yang ditandatangani ke alat automasi seperti n8n, Make atau Zapier, dan biarkan langkah Google Sheets di dalamnya menambah satu baris bagi setiap mesej: masa, arah, nombor telefon, nama, teks dan ID mesej. Tab kedua yang diindeks mengikut nombor telefon menyimpan satu baris bagi setiap kenalan, dan dikemas kini apabila mereka menulis semula.
easyCoexistence menyambungkan nombor WhatsApp Business yang anda simpan dalam aplikasi kepada Cloud API Meta melalui Coexistence.
Penghantaran yang dimajukan dicuba semula selepas kira-kira 1, 5, 30, 120, 360 dan 1,440 minit apabila URL anda gagal.
Tempoh permintaan POST yang dimajukan menunggu respons 2xx sebelum penghantaran itu dicuba semula.
Kuota permintaan tulis Google Sheets API dibenarkan setiap minit bagi setiap pengguna setiap projek; 300 setiap projek.
Output aplikasi web Apps Script diubah hala ke URL sekali guna di script.googleusercontent.com.
Objek acara doPost Apps Script mendedahkan badan dan parameter, bukan pengepala permintaan HTTP.
Laluan mana patut mengisi hamparan?
Terdapat dua laluan pada satu nombor yang mesejnya melalui easyCoexistence, dan keduanya menjawab keperluan yang berbeza. Forward URL, yang ditetapkan sekali bagi setiap nombor, meneruskan acara asal Meta sama ada automasi menjawab atau tidak: mesej pelanggan, balasan yang ditaip pasukan anda dalam aplikasi WhatsApp Business dan status penghantaran. Ia ialah laluan untuk log mesej yang lengkap. Langkah Call my webhook di dalam automasi hanya dicetuskan untuk mesej yang dipilih automasi itu, dan membawa perbualan terkini, termasuk balasan yang baru dihantar automasi. Ia sesuai untuk hamparan prospek, pesanan atau permintaan yang dikendalikan oleh satu automasi. Kedua-duanya ditandatangani, dengan rahsia yang berbeza.
| Forward URL (per number) | Call my webhook step (per automation) | |
|---|---|---|
| Fires on | Any message event on the number, with or without automations | Only messages that automation is picked for |
| Carries | Meta's original value: messages, phone replies, statuses | The message, the contact and up to 10 recent messages |
| Automated replies | Delivery statuses only, without the text | In history, direction out |
| Retries | 7 attempts over about 33 hours | One attempt |
| Signed with | The number's forward secret, shown once | The automation's Signing secret |
| Set in | Number page, Where incoming messages go card | The automation editor, or create_automation |
Apakah medan yang tiba, dan apakah lajur yang patut ada dalam hamparan?
Satu POST yang dimajukan membungkus satu perubahan Meta: id (penghantaran), event (nama medan Meta, seperti messages atau smb_message_echoes), received_at, connection (ID nombor anda, phone dan phone_number_id) dan value, tepat seperti yang Meta hantar. Dalam value, messages memegang apa yang ditulis pelanggan dan message_echoes memegang apa yang ditaip pasukan anda pada telefon. Nombor telefon tiba sebagai digit dengan kod negara dan tanpa tanda plus; simpan lajur itu sebagai teks biasa supaya Sheets tidak menukarkannya kepada nombor. Pengguna yang mempunyai nama pengguna WhatsApp mungkin tiba dengan ID pengguna terskop perniagaan di sebelah nombor, atau sebagai ganti nombor, jadi simpan satu lajur untuknya.
Bagaimana anda membina log mesej dalam n8n?
Tiga nod. Nod Webhook dengan HTTP Method POST, Respond ditetapkan kepada Immediately, dan Production URL-nya disimpan sebagai Forward URL nombor itu. Nod Code yang menyemak X-EC-Signature dengan rahsia forward dan menukar acara kepada baris, sambil melangkau status penghantaran. Nod Google Sheets dengan operasi Append or Update Row, dan Column to match on ditetapkan kepada ID mesej, supaya penghantaran yang dicuba semula menulis semula baris yang sama dan bukan menambah satu lagi.
Rahsia forward muncul sekali, apabila anda menyimpan Forward URL; jika ia hilang, klik New secret dan tampal yang baharu. n8n Cloud membenarkan modul crypto dalam nod Code; n8n yang dihoskan sendiri memerlukan NODE_FUNCTION_ALLOW_BUILTIN=crypto.
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 anda mengekalkan satu baris bagi setiap kenalan?
Tambah nod Google Sheets kedua pada tab Contacts, juga dengan Append or Update Row, dipadankan pada Phone. Petakan telefon, nama profil, ID pengguna, masa dan teks mesej terkini. Mesej pertama daripada satu nombor mencipta barisnya; mesej seterusnya mengemas kini lajur nama dan hubungan terakhir, jadi tab itu juga berfungsi sebagai senarai siapa yang menulis dan bila. Simpan nota tulisan tangan pada tab berasingan, dicari mengikut telefon, supaya aliran kerja tidak sekali-kali menulis ganti.
Kenalan yang disimpan dalam buku alamat telefon tidak tiba dengan cara ini. Meta menghantarnya, bersama sehingga 6 bulan perbualan, hanya ke destinasi webhook terus yang disimpan dalam masa 24 jam selepas menyambungkan nombor.
Bolehkah Apps Script menerima mesej secara terus?
Tidak dengan bersih, jadi letakkan alat aliran kerja di hadapan hamparan. Google menghidangkan respons aplikasi web Apps Script melalui ubah hala ke URL sekali guna script.googleusercontent.com, dan easyCoexistence tidak mengikut ubah hala. Respons 302 dikira sebagai penghantaran gagal: penghantaran yang dimajukan dicuba semula sehingga 7 kali, dan setiap percubaan semula menjalankan doPost semula serta menulis satu lagi baris, manakala langkah Call my webhook gagal dan menghantar e-mel kepada anda. doPost juga tidak boleh membaca pengepala permintaan, jadi semakan X-EC-Signature mustahil dilakukan di sana.
Apps Script kekal sesuai untuk arah sebaliknya, iaitu menghantar templat yang diluluskan daripada baris hamparan, yang diliputi oleh halaman integrasi Google Sheets, dengan kod.
Bolehkah Make atau Zapier mengisi hamparan sebaliknya?
Boleh. Dalam Make, mulakan senario dengan Webhooks > Custom webhook dan tambah Google Sheets > Add a Row; dalam Zapier, guna Webhooks by Zapier dengan Catch Raw Hook, yang mengekalkan pengepala, kemudian Google Sheets > Create Spreadsheet Row. Kedua-duanya menjawab POST serta-merta dengan 2xx, yang diperlukan oleh penghantaran yang dimajukan dalam 10 saat. Petakan medan yang sama seperti di atas daripada value.messages, dan tapis keluar acara yang value-nya membawa statuses dan bukan messages.
Anggap URL hook sebagai kata laluan, kerana sesiapa yang memegangnya boleh menghantar baris. Jika pelan anda termasuk langkah kod, semak X-EC-Signature di sana dengan resipi HMAC yang sama seperti digunakan dalam nod n8n.
Bagaimana anda mengelak baris pendua atau yang hilang?
Pendua datang daripada percubaan semula. Penghantaran yang dimajukan tanpa respons 2xx dalam 10 saat dihantar semula dengan pengepala X-EC-Delivery yang sama dan id yang sama dalam badan, dan mesej di dalamnya mengekalkan wamid mereka, jadi memadankan pada ID mesej menjadikan percubaan semula tidak berbahaya. Pada laluan langkah webhook, ujian daripada Try it tiba dengan dry_run true: hala ke tab ujian atau buangkannya.
Baris yang hilang datang daripada kuota tulis Google. API Sheets membenarkan 60 permintaan tulis seminit bagi setiap pengguna setiap projek, dan satu bukti kelayakan n8n ialah satu pengguna; lonjakan balasan selepas kempen templat boleh melebihinya dan menerima HTTP 429. Hidupkan Retry On Fail dalam tetapan nod Google Sheets, atau kumpulkan mesej selama beberapa saat dan tambahkannya dalam satu permintaan.
Cara menetapkannya
- 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.
- 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.
- 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.
- 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.
Kesilapan biasa
- Menyemak penghantaran yang dimajukan dengan rahsia penandatangan automasi, atau sebaliknya. Forward URL ditandatangani dengan rahsia forward nombor dan Call my webhook dengan rahsia automasi itu sendiri; pilih rahsia mengikut pengepala X-EC-Event.
- Menambah satu baris bagi setiap POST tanpa kunci. Penghantaran yang dicuba semula selepas respons perlahan menulis mesej yang sama dua kali; guna Append or Update Row yang dipadankan pada ID mesej.
- Menulis status penghantaran sebagai mesej. Acara messages juga membawa status dihantar, disampaikan dan dibaca dalam value.statuses, yang tiada teks dan mencipta baris kosong.
- Menyimpan URL web app Apps Script sebagai Forward URL. Ubah hala daripadanya dikira sebagai kegagalan, jadi setiap daripada 7 cubaan menjalankan doPost semula dan menambah baris pendua.
Dengan automasi dihidupkan, Forward URL menghantar acara asal Meta kepada aliran kerja anda, ditandatangani dengan rahsia yang hanya anda pegang dan dicuba semula apabila URL anda tidak berfungsi, dan langkah Call my webhook menghantar apa yang dikendalikan automasi, bersama balasannya. Kedua-duanya termasuk dalam pelan. Daripada US$ 9 setiap nombor yang disambungkan sebulan, turun kepada US$ 0.75 apabila nombor ditambah, dengan 3 hari percubaan percuma.
Soalan lazim
Adakah hamparan menerima mesej yang ditaip pasukan saya pada telefon?
Ya, melalui Forward URL. Balasan yang ditaip dalam aplikasi WhatsApp Business tiba sebagai acara smb_message_echoes, dengan nombor pelanggan dalam to. Balasan yang dihantar oleh automasi hanya kembali sebagai status penghantaran, jadi log teksnya daripada langkah Call my webhook yang diletakkan selepas balasan.
Bolehkah saya memuatkan perbualan sedia ada ke dalam hamparan?
Tidak pada nombor yang mesejnya melalui easyCoexistence. Meta menghantar sehingga 6 bulan perbualan satu-satu hanya ke destinasi webhook terus yang disimpan dalam masa 24 jam selepas menyambung, sekali bagi setiap sambungan. Nombor yang disalurkan melalui easyCoexistence mencatat dari saat Forward URL disimpan.
Adakah easyCoexistence menyimpan salinan mesej?
Sebahagiannya. Pada nombor yang dilaluikan melalui easyCoexistence dengan automasi dihidupkan, teks mesej disimpan selama tempoh yang anda pilih, 30, 90 atau 365 hari (90 secara lalai), dan dipaparkan dalam Perbualan; penghantaran yang dimajukan disimpan sehingga 7 hari untuk percubaan semula, dan log larian selama 30 hari. Hamparan ialah salinan kekal anda.
Bolehkah AI saya membaca hamparan untuk menjawab pelanggan?
Tidak daripada langkah Reply with AI, yang hanya membaca Instructions dan perbualan. Ejen AI boleh mencari maklumat melalui alat HTTP tersuai, dan langkah Call my webhook atau Call an API boleh menghantar soalan kepada aliran kerja yang mencari jawapan dalam hamparan dan memulangkannya sebagai balasan.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada