Automatyczne zapisywanie wiadomości i kontaktów WhatsApp w Google Sheets
Aby automatycznie zapisywać wiadomości WhatsApp Business w Google Sheets, wysyłaj je jako podpisane żądania HTTP POST do narzędzia do automatyzacji, takiego jak n8n, Make lub Zapier. Krok Google Sheets w tym narzędziu doda wiersz dla każdej wiadomości: czas, kierunek, numer telefonu, nazwę, treść i identyfikator wiadomości. Druga zakładka, kluczowana numerem telefonu, prowadzi jeden wiersz na kontakt, aktualizowany, gdy kontakt znów napisze.
easyCoexistence łączy numer WhatsApp Business, który trzymasz w aplikacji, z Cloud API firmy Meta przez Coexistence.
Przekazane dostawy są ponawiane po około 1, 5, 30, 120, 360 i 1 440 minutach, gdy Twój adres URL nie działa.
Jak długo przekazane żądanie POST czeka na odpowiedź 2xx, zanim dostawa zostanie ponowiona.
Dozwolone żądania zapisu do Google Sheets API na minutę, na użytkownika i na projekt; 300 na projekt.
Dane wyjściowe aplikacji internetowej Apps Script są przekierowywane pod jednorazowy adres URL na script.googleusercontent.com.
Obiekt zdarzenia doPost w Apps Script udostępnia treść i parametry, a nie nagłówki żądania HTTP.
Która trasa ma wypełniać arkusz?
Na numerze, którego wiadomości przechodzą przez easyCoexistence, istnieją dwie trasy i odpowiadają na różne potrzeby. Forward URL, ustawiany raz dla numeru, przekazuje oryginalne zdarzenia firmy Meta niezależnie od tego, czy automatyzacja odpowiada: wiadomości od klientów, odpowiedzi wpisane przez Twój zespół w aplikacji WhatsApp Business oraz statusy dostarczenia. To trasa dla pełnego dziennika wiadomości. Krok Call my webhook wewnątrz automatyzacji uruchamia się tylko dla wiadomości, które ta automatyzacja wybierze, i przenosi ostatnią rozmowę, łącznie z odpowiedzią, którą automatyzacja właśnie wysłała. Nadaje się do arkusza leadów, zamówień lub zgłoszeń, które obsługuje jedna automatyzacja. Obie trasy są podpisane, ale mają różne sekrety.
| 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 |
Jakie pola docierają i jakie kolumny powinien mieć arkusz?
Przekazane żądanie POST opakowuje jedną zmianę firmy Meta: id (dostarczenie), event (nazwa pola Meta, np. messages lub smb_message_echoes), received_at, connection (identyfikator numeru, phone i phone_number_id) oraz value, dokładnie tak, jak wysłała Meta. W value pole messages zawiera to, co napisali klienci, a message_echoes to, co Twój zespół wpisał w telefonie. Numery telefonów przychodzą jako cyfry z kodem kraju i bez plusa; zapisuj tę kolumnę jako zwykły tekst, aby Sheets nie zamienił jej w liczbę. Użytkownik z nazwą użytkownika WhatsApp może przyjść z identyfikatorem użytkownika w zakresie firmy obok numeru albo zamiast niego, dlatego zachowaj dla niego kolumnę.
Jak zbudować dziennik wiadomości w n8n?
Trzy węzły. Węzeł Webhook z HTTP Method POST, Respond ustawione na Immediately, a jego Production URL zapisany jako Forward URL numeru. Węzeł Code, który sprawdza X-EC-Signature za pomocą sekretu przekazywania i zamienia zdarzenie na wiersze, pomijając statusy dostarczenia. Węzeł Google Sheets z operacją Append or Update Row, Column to match on ustawioną na Message id, dzięki czemu ponowione dostarczenie nadpisuje ten sam wiersz zamiast dodawać nowy.
Sekret przekazywania pojawia się raz, gdy zapiszesz Forward URL; jeśli go zgubisz, kliknij New secret i wklej nowy. n8n Cloud pozwala na moduł crypto w węzłach Code; n8n self-hosted wymaga ustawienia 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 }));Jak utrzymać jeden wiersz na kontakt?
Dodaj drugi węzeł Google Sheets na zakładce Contacts, również z Append or Update Row, dopasowany po Phone. Zmapuj numer telefonu, nazwę profilu, identyfikator użytkownika, czas i treść ostatniej wiadomości. Pierwsza wiadomość z numeru tworzy jego wiersz; kolejne aktualizują nazwę i kolumny ostatniego kontaktu, więc zakładka służy też jako lista tego, kto i kiedy napisał. Notatki pisane ręcznie trzymaj na osobnej zakładce, wyszukiwanej po numerze, aby przepływ nigdy ich nie nadpisał.
Kontakty zapisane w książce adresowej telefonu nie docierają tą drogą. Meta wysyła je, wraz z czatami z okresu do 6 miesięcy wstecz, tylko do bezpośredniego celu typu webhook zapisanego w ciągu 24 godzin od połączenia numeru.
Czy Apps Script może odbierać wiadomości bezpośrednio?
Nie w sposób niezawodny, więc przed arkuszem postaw narzędzie do przepływów pracy. Google obsługuje odpowiedź aplikacji internetowej Apps Script przez przekierowanie na jednorazowy adres script.googleusercontent.com, a easyCoexistence nie podąża za przekierowaniami. Odpowiedź 302 liczy się jako nieudana dostawa: przekazanie jest ponawiane do 7 razy, a każde ponowienie uruchamia doPost od nowa i zapisuje kolejny wiersz, podczas gdy krok Call my webhook zawodzi i wysyła Ci e-mail. doPost też nie odczyta nagłówków żądania, więc sprawdzenie X-EC-Signature jest tam niemożliwe.
Apps Script nadal dobrze sprawdza się w drugim kierunku: wysyłaniu zatwierdzonych szablonów z wierszy arkusza, co strona integracji z Google Sheets pokazuje na przykładzie kodu.
Czy Make lub Zapier mogą zamiast tego wypełniać arkusz?
Tak. W Make uruchom scenariusz od Webhooks > Custom webhook i dodaj Google Sheets > Add a Row; w Zapier użyj Webhooks by Zapier z Catch Raw Hook, który zachowuje nagłówki, a potem Google Sheets > Create Spreadsheet Row. Oba narzędzia od razu odpowiadają na POST kodem 2xx, czego przekazanie wymaga w ciągu 10 sekund. Zmapuj te same pola jak wyżej z value.messages i odfiltruj zdarzenia, w których value zawiera statuses zamiast messages.
Traktuj adres hooka jak hasło, bo każdy, kto go ma, może dopisywać wiersze. Jeśli Twój plan obejmuje krok kodu, sprawdź tam X-EC-Signature tym samym przepisem HMAC, którego używa węzeł n8n.
Jak unikać zduplikowanych lub brakujących wierszy?
Duplikaty biorą się z ponowień. Przekazanie, które nie dostało odpowiedzi 2xx w ciągu 10 sekund, jest wysyłane ponownie z tym samym nagłówkiem X-EC-Delivery i tym samym id w treści, a wiadomości w środku zachowują swój wamid, więc dopasowanie po Message id czyni ponowienie nieszkodliwym. Na trasie kroku webhook testy z Try it przychodzą z dry_run true: kieruj je na zakładkę testową albo je odrzucaj.
Brakujące wiersze biorą się z limitu zapisów Google. Sheets API pozwala na 60 żądań zapisu na minutę na użytkownika i projekt, a jedno poświadczenie n8n to jeden użytkownik; nagły wybuch odpowiedzi po kampanii szablonów może go przekroczyć i dostać HTTP 429. Włącz Retry On Fail w ustawieniach węzła Google Sheets albo zbieraj wiadomości przez kilka sekund i dopisuj je jednym żądaniem.
Jak to skonfigurować
- 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.
Typowe błędy
- Sprawdzanie przekazania sekretem podpisu automatyzacji albo odwrotnie. Forward URL jest podpisany sekretem przekazywania numeru, a Call my webhook własnym sekretem automatyzacji; wybieraj sekret według nagłówka X-EC-Event.
- Dopisywanie wiersza przy każdym POST bez klucza. Dostarczenie ponowione po wolnej odpowiedzi zapisuje tę samą wiadomość dwa razy; używaj Append or Update Row dopasowanego po identyfikatorze wiadomości.
- Zapisywanie statusów dostarczenia jako wiadomości. Zdarzenie messages zawiera też statusy sent, delivered i read w value.statuses; nie mają treści i tworzą puste wiersze.
- Zapisanie adresu aplikacji internetowej Apps Script jako Forward URL. Jej przekierowanie liczy się jako błąd, więc każda z 7 prób uruchamia doPost ponownie i dodaje zduplikowany wiersz.
Przy włączonych automatyzacjach Forward URL przekazuje oryginalne zdarzenia Meta do Twojego przepływu, podpisane sekretem znanym tylko Tobie i ponawiane, gdy Twój adres nie działa. Krok Call my webhook wysyła to, co obsłużyła automatyzacja, wraz z jej odpowiedzią. Obie trasy są wliczone w plan. Od US$ 9 do US$ 0.75 za numer miesięcznie, spadając wraz z dodawaniem numerów, z pierwszymi 3 dniami bezpłatnie.
Najczęściej zadawane pytania
Czy arkusz dostaje wiadomości, które mój zespół wpisuje w telefonie?
Tak, przez Forward URL. Odpowiedzi wpisane w aplikacji WhatsApp Business docierają jako zdarzenia smb_message_echoes z numerem klienta w polu to. Odpowiedzi wysłane przez automatyzacje wracają tylko jako statusy dostarczenia, więc ich treść zapisuj z kroku Call my webhook umieszczonego po odpowiedzi.
Czy mogę wczytać istniejące czaty do arkusza?
Nie na numerze, którego wiadomości przechodzą przez easyCoexistence. Meta wysyła czaty jeden na jeden z okresu do 6 miesięcy wstecz tylko do bezpośredniego celu typu webhook zapisanego w ciągu 24 godzin od połączenia, raz na połączenie. Numer kierowany przez easyCoexistence zapisuje dziennik od chwili zapisania Forward URL.
Czy easyCoexistence przechowuje kopię wiadomości?
Częściowo. Na numerze kierowanym przez easyCoexistence z włączonymi automatyzacjami treść wiadomości jest przechowywana przez wybrany przez Ciebie okres, 30, 90 lub 365 dni (domyślnie 90), i widoczna w Rozmowach; przekazane dostarczenia są trzymane do 7 dni na potrzeby ponowień, a logi uruchomień 30 dni. Arkusz jest Twoją trwałą kopią.
Czy mój AI może odczytać arkusz, żeby odpowiadać klientom?
Nie z kroku Reply with AI, który czyta tylko swoje Instructions i czat. Agent AI może szukać informacji przez własne narzędzie HTTP, a krok Call my webhook lub Call an API może wysłać pytanie do przepływu, który wyszuka odpowiedź w arkuszu i zwróci ją jako odpowiedź.
Czytaj dalej
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyZweryfikowano w