WhatsApp mesajlarını ve kişileri Google Sheets'e otomatik kaydedin
WhatsApp Business mesajlarını otomatik olarak Google Sheets'e kaydetmek için mesajları imzalı HTTP POST istekleri olarak n8n, Make veya Zapier gibi bir otomasyon aracına gönderin; aracın Google Sheets adımı her mesaj için bir satır eklesin: zaman, yön, telefon numarası, ad, metin ve mesaj kimliği. Telefon numarasına göre anahtarlanan ikinci bir sekme, kişi başına bir satır tutar ve kişi yeniden yazdığında günceller.
easyCoexistence, uygulamada tuttuğunuz WhatsApp Business numarasını Coexistence üzerinden Meta'nın Cloud API'sine bağlar.
Yönlendirilen teslimatlar, URL'niz başarısız olursa yaklaşık 1, 5, 30, 120, 360 ve 1,440 dakika sonra yeniden denenir.
Yönlendirilen bir POST'un, teslimatın yeniden denenmesinden önce 2xx yanıtını ne kadar süre beklediği.
Google Sheets API yazma isteği sınırı: kullanıcı ve proje başına dakikada izin verilen istek sayısı; proje başına 300.
Apps Script web uygulamasının çıktısı, script.googleusercontent.com adresinde tek kullanımlık bir URL'ye yönlendirilir.
Apps Script'in doPost olay nesnesi gövdeyi ve parametreleri gösterir, HTTP istek başlıklarını göstermez.
Hangi yol tabloyu doldurmalı?
Mesajları easyCoexistence üzerinden geçen bir numarada iki yol vardır ve farklı ihtiyaçlara yanıt verir. Her numara için bir kez ayarlanan Forward URL, bir otomasyon yanıt verse de vermese de Meta'nın özgün olaylarını iletir: müşteri mesajlarını, WhatsApp Business uygulamasında ekibinizin yazdığı yanıtları ve teslimat durumlarını. Tam bir mesaj kaydı için bu yoldur. Bir otomasyonun içindeki Call my webhook adımı yalnızca o otomasyonun seçtiği mesajlar için tetiklenir ve otomasyonun gönderdiği yanıt dahil, son sohbeti taşır. Tek bir otomasyonun işlediği potansiyel müşteri, sipariş ya da talep listeleri için uygundur. İkisi de imzalıdır, ancak farklı gizli anahtarlarla.
| 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 |
Hangi alanlar gelir ve tabloda hangi sütunlar olmalı?
Yönlendirilen bir POST, tek bir Meta değişikliğini sarar: id (teslimat), event (Meta'nın alan adı, örneğin messages ya da smb_message_echoes), received_at, connection (numaranızın kimliği, phone ve phone_number_id) ve value, Meta'nın gönderdiği biçimiyle aynen. value içinde messages, müşterilerin yazdıklarını; message_echoes ise ekibinizin telefonda yazdıklarını taşır. Telefon numaraları, ülke kodu ile birlikte artı işareti olmadan rakam olarak gelir; bu sütunu düz metin olarak saklayın ki Sheets onu sayıya çevirmesin. WhatsApp kullanıcı adı olan bir kullanıcı, numarasının yanında ya da onun yerine işletmeye özgü bir kullanıcı kimliğiyle gelebilir, bu yüzden onun için de bir sütun tutun.
Mesaj kaydını n8n'de nasıl oluşturursunuz?
Üç düğüm. HTTP Method POST olarak ayarlanmış, Respond seçeneği Immediately olan ve Production URL'si numaranın Forward URL'si olarak kaydedilmiş bir Webhook düğümü. X-EC-Signature değerini forward gizli anahtarıyla kontrol eden ve olayı satırlara dönüştüren, teslimat durumlarını atlayan bir Code düğümü. Column to match on sütunu Message id olarak ayarlanmış, Append or Update Row işlemli bir Google Sheets düğümü; böylece yeniden denenen bir teslimat yeni satır eklemek yerine aynı satırı yeniden yazar.
Forward gizli anahtarı, Forward URL'yi kaydederken yalnızca bir kez gösterilir; kaybederseniz New secret'a tıklayıp yeni anahtarı yapıştırın. n8n Cloud, Code düğümlerinde crypto modülüne izin verir; kendi sunucunuzda barındırdığınız n8n için NODE_FUNCTION_ALLOW_BUILTIN=crypto gerekir.
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 }));Kişi başına bir satırı nasıl tutarsınız?
Contacts sekmesinde ikinci bir Google Sheets düğümü ekleyin; o da Append or Update Row işlemiyle, Phone üzerinden eşleşsin. Telefon, profil adı, kullanıcı kimliği, zaman ve en son mesajın metnini eşleyin. Bir numaradan gelen ilk mesaj kendi satırını oluşturur; sonraki mesajlar ad ve son iletişim sütunlarını günceller, böylece sekme kimin ne zaman yazdığının bir listesi olarak da işe yarar. El ile tutulan notları telefona göre aranan ayrı bir sekmede saklayın; böylece iş akışı onların üzerine hiçbir zaman yazmaz.
Telefonun adres defterinde kayıtlı kişiler bu yolla gelmez. Meta bunları, numara bağlandıktan sonraki 24 saat içinde kaydedilmiş doğrudan bir webhook hedefine yalnızca, 6 aya kadar sohbetle birlikte gönderir.
Apps Script mesajları doğrudan alabilir mi?
Temiz bir şekilde alamaz; bu yüzden tablonun önüne bir iş akışı aracı koyun. Google, bir Apps Script web uygulamasının yanıtını tek kullanımlık bir script.googleusercontent.com URL'sine yönlendirmeyle sunar ve easyCoexistence yönlendirmeleri takip etmez. 302 yönlendirmesi başarısız teslimat sayılır: bir yönlendirme en fazla 7 kez yeniden denenir ve her yeniden deneme doPost'u tekrar çalıştırıp başka bir satır yazar; Call my webhook adımı ise başarısız olur ve size e-posta gönderir. doPost ayrıca istek başlıklarını okuyamaz, dolayısıyla X-EC-Signature kontrolü orada imkânsızdır.
Apps Script, diğer yön için yine uygundur: bir tablonun satırlarından onaylı şablonları göndermek; bunu Google Sheets entegrasyon sayfası kodla anlatır.
Bunun yerine Make ya da Zapier tabloyu doldurabilir mi?
Evet. Make'te senaryoyu Webhooks > Custom webhook ile başlatın ve Google Sheets > Add a Row ekleyin; Zapier'de ise başlıkları koruyan Catch Raw Hook'lu Webhooks by Zapier'i kullanın, ardından Google Sheets > Create Spreadsheet Row. İkisi de POST'a hemen 2xx ile yanıt verir; yönlendirmenin 10 saniye içinde ihtiyaç duyduğu budur. Aynı alanları value.messages'tan eşleyin ve value'su messages yerine statuses taşıyan olayları filtreleyin.
Hook URL'sini bir parola gibi görün, çünkü onu bilen herkes satır ekleyebilir. Planınız bir kod adımı içeriyorsa, X-EC-Signature'ı n8n düğümünde kullanılan aynı HMAC tarifiyle orada kontrol edin.
Yinelenen ya da eksik satırları nasıl önlersiniz?
Yinelenenler yeniden denemelerden gelir. 10 saniye içinde 2xx almayan bir yönlendirme, aynı X-EC-Delivery başlığı ve gövdedeki aynı id ile yeniden gönderilir; içindeki mesajlar wamid'lerini korur, bu yüzden Message id üzerinden eşleştirme bir yeniden denemeyi zararsız kılar. Webhook adımı yolunda, Try it'ten gelen testler dry_run true ile gelir: bunları bir test sekmesine yönlendirin ya da atın.
Eksik satırlar Google'ın yazma kotasından gelir. Sheets API, kullanıcı başına ve proje başına dakikada 60 yazma isteğine izin verir ve bir n8n kimlik bilgisi bir kullanıcıdır; bir şablon kampanyasından sonra gelen yanıt patlaması bunu aşıp HTTP 429 alabilir. Google Sheets düğümünün ayarlarında Retry On Fail'i açın ya da mesajları birkaç saniye biriktirip tek istekte ekleyin.
Nasıl kurulur
- 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.
Yaygın hatalar
- Bir yönlendirmeyi, otomasyonun Signing secret'ıyla kontrol etmek ya da tersini yapmak. Forward URL, numaranın forward gizli anahtarıyla, Call my webhook ise otomasyonun kendi anahtarıyla imzalanır; anahtarı X-EC-Event başlığına göre seçin.
- Anahtarsız her POST için satır eklemek. Yavaş bir yanıttan sonra yeniden denenen bir teslimat aynı mesajı iki kez yazar; Message id üzerinden eşleştirilen Append or Update Row kullanın.
- Teslimat durumlarını mesaj olarak yazmak. messages olayı, value.statuses içinde gönderildi, iletildi ve okundu durumlarını da taşır; bunların metni yoktur ve boş satırlar oluşturur.
- Forward URL olarak bir Apps Script web uygulaması URL'si kaydetmek. Yönlendirmesi başarısızlık sayılır; 7 denemenin her biri doPost'u yeniden çalıştırıp bir yinelenen satır ekler.
Otomasyonlar açıkken, bir Forward URL Meta'nın özgün olaylarını yalnızca sizin bildiğiniz bir gizli anahtarla imzalanmış olarak iş akışınıza iletir ve URL'niz kapalıyken yeniden dener; bir Call my webhook adımı ise bir otomasyonun işlediği olayları, yanıtıyla birlikte gönderir. İkisi de planda dahildir. Numara başına aylık US$ 9'dan US$ 0.75'e kadar, numara ekledikçe düşer; ilk 3 gün ücretsiz.
Sık sorulan sorular
Tablo, ekibimin telefonda yazdığı mesajları da alır mı?
Evet, Forward URL üzerinden. WhatsApp Business uygulamasında yazılan yanıtlar, to alanında müşterinin numarası bulunan smb_message_echoes olayları olarak gelir. Otomasyonların gönderdiği yanıtlar yalnızca teslimat durumları olarak döner; bu yüzden metinlerini, yanıttan sonra yerleştirilmiş bir Call my webhook adımından kaydedin.
Mevcut sohbetlerimi tabloya yükleyebilir miyim?
Mesajları easyCoexistence üzerinden geçen bir numarada hayır. Meta, bire bir sohbetleri en fazla 6 ay geriye gidecek şekilde yalnızca, bağlantıdan sonraki 24 saat içinde kaydedilmiş doğrudan bir webhook hedefine, bağlantı başına bir kez gönderir. easyCoexistence üzerinden yönlendirilen bir numara, Forward URL kaydedildiği andan itibaren kayıt tutar.
easyCoexistence mesajların bir kopyasını tutar mı?
Kısmen. Otomasyonları açık ve easyCoexistence üzerinden yönlendirilen bir numarada, mesaj metni seçtiğiniz süre boyunca, 30, 90 veya 365 gün (varsayılan 90), saklanır ve Conversations'ta gösterilir; yönlendirilen teslimatlar yeniden denemeler için en fazla 7 gün, çalıştırma kayıtları ise 30 gün tutulur. Kalıcı kopyanız tablonuzdur.
Yapay zekam müşterilere yanıt vermek için tabloyu okuyabilir mi?
Reply with AI adımından hayır; bu adım yalnızca kendi Instructions'ını ve sohbeti okur. Bir AI ajanı özel bir HTTP aracıyla bir şeyleri arayabilir; bir Call my webhook ya da Call an API adımı da soruyu, cevabı tabloda arayıp yanıt olarak geri döndüren bir iş akışına gönderebilir.
Okumaya devam edin
Başlamaya hazır mısınız?
WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.
Ücretsiz denemeyi başlatınDoğrulama tarihi