Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

Tallenna WhatsApp-viestit ja yhteystiedot automaattisesti Google Sheetsiin

Voit tallentaa WhatsApp Business -viestit Google Sheetsiin automaattisesti lähettämällä ne allekirjoitettuina HTTP POST -pyyntöinä automaatiotyökaluun, kuten n8n:ään, Makeen tai Zapieriin. Työkalun Google Sheets -vaihe lisää jokaisesta viestistä oman rivin: aika, suunta, puhelinnumero, nimi, teksti ja viestin tunnus. Toinen välilehti, jonka avaimena on puhelinnumero, pitää yhden rivin per yhteystieto ja päivittää sen, kun yhteystieto kirjoittaa uudelleen.

easyCoexistence yhdistää WhatsApp Business -numeron, jonka pidät sovelluksessa, Metan Cloud API -rajapintaan Coexistence-yhteyden kautta.

7 attempts

Edelleenlähetettyjä toimituksia yritetään uudelleen noin 1, 5, 30, 120, 360 ja 1 440 minuutin kuluttua, kun URL-osoitteesi epäonnistuu.

10 s

Kuinka kauan edelleenlähetetty POST odottaa 2xx-vastausta ennen kuin toimitusta yritetään uudelleen.

60 / min

Google Sheets API:n sallitut kirjoituspyynnöt minuutissa per käyttäjä ja per projekti; projektille 300.

Redirect

Apps Script -verkkosovelluksen vastaus ohjataan kertakäyttöiseen URL-osoitteeseen osoitteessa script.googleusercontent.com.

No headers

Apps Scriptin doPost-tapahtumaobjekti paljastaa rungon ja parametrit, ei HTTP-pyynnön otsikoita.

Mikä reitti täyttää taulukon?

Kahdella reitillä numerolla, jonka viestit kulkevat easyCoexistencen kautta, voi täyttää taulukon, ja ne vastaavat eri tarpeisiin. Forward URL, joka asetetaan kerran per numero, välittää Metan alkuperäiset tapahtumat riippumatta siitä, vastaako automaatio: asiakkaiden viestit, tiimisi WhatsApp Business -sovelluksessa kirjoittamat vastaukset ja toimitustilat. Se on reitti täydelliseen viestilokiin. Automaation sisällä oleva Call my webhook -vaihe käynnistyy vain niille viesteille, jotka kyseinen automaatio valitsee, ja välittää viimeisimmän keskustelun, myös automaation juuri lähettämän vastauksen. Se sopii taulukolle, johon kerätään liidit, tilaukset tai pyynnöt, joita yksi automaatio käsittelee. Molemmat ovat allekirjoitettuja, eri salaisuuksilla.

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

Mitkä kentät saapuvat ja mitä sarakkeita taulukossa pitäisi olla?

Edelleenlähetetty POST kääri yhden Metan muutoksen: id (toimitus), event (Metan kentän nimi, kuten messages tai smb_message_echoes), received_at, connection (numerosi tunnus, phone ja phone_number_id) ja value täsmälleen siinä muodossa, kuin Meta sen lähetti. value-kohdassa messages sisältää asiakkaiden kirjoittamat viestit ja message_echoes tiimisi puhelimella kirjoittamat vastaukset. Puhelinnumerot saapuvat numeroina maatunnuksen kanssa ilman plusmerkkiä; tallenna tämä sarake tekstinä, jotta Sheets ei muuta sitä luvuksi. Käyttäjä, jolla on WhatsApp-käyttäjänimi, voi saapua liiketoimintakohtaisen käyttäjätunnuksen kanssa numeron rinnalla tai sen sijasta, joten varaa sille oma sarake.

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

Miten viestilokin rakennetaan n8n:ssä?

Kolme solmua. Webhook-solmu, jonka HTTP Method on POST, Respond on asetettu Immediately ja jonka Production URL tallennetaan numeron Forward URL -osoitteeksi. Code-solmu, joka tarkistaa X-EC-Signature-allekirjoituksen edelleenlähetyssalaisuudella, muuntaa tapahtuman riveiksi ja ohittaa toimitustilat. Google Sheets -solmu, jossa operaatio on Append tai Update Row ja Column to match on on asetettu arvoon Message id, jolloin uudelleen yritetty toimitus kirjoittaa saman rivin uudelleen eikä lisää uutta.

Edelleenlähetyssalaisuus näkyy kerran, kun tallennat Forward URL -osoitteen. Jos se katoaa, napsauta New secret ja liitä uusi. n8n Cloud sallii crypto-moduulin Code-solmuissa; itse ylläpidetyssä n8n:ssä tarvitaan 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 }));

Miten pidät yhden rivin per yhteystieto?

Lisää toinen Google Sheets -solmu Yhteystiedot-välilehdelle, myös operaatiolla Append tai Update Row, ja täsmää kenttään Phone. Kartoita puhelinnumero, profiilin nimi, käyttäjätunnus sekä uusimman viestin aika ja teksti. Numerosta lähetetty ensimmäinen viesti luo rivin; myöhemmät päivittävät nimi- ja viimeisimmän yhteydenoton sarakkeet, joten välilehti toimii myös luettelona siitä, kuka kirjoitti ja milloin. Pidä käsin kirjoitetut muistiinpanot erillisellä välilehdellä, haettuna puhelinnumerolla, jotta työnkulku ei koskaan ylikirjoita niitä.

Puhelimen osoitekirjassa tallennetut yhteystiedot eivät saavu tätä reittiä. Meta lähettää ne enintään 6 kuukauden keskustelut sisältäen vain suoraan webhook-kohteeseen, joka on tallennettu 24 tunnin sisällä numeron yhdistämisestä.

Voiko Apps Script vastaanottaa viestit suoraan?

Ei kunnolla, joten taulukon eteen kannattaa laittaa työnkulkutyökalu. Google palvelee Apps Script -verkkosovelluksen vastauksen uudelleenohjauksella kertakäyttöiseen script.googleusercontent.com-URL-osoitteeseen, eikä easyCoexistence seuraa uudelleenohjauksia. 302-vastaus lasketaan epäonnistuneeksi toimitukseksi: edelleenlähetys yritetään uudelleen enintään 7 kertaa, ja jokainen uusi yritys ajaa doPost-funktion uudelleen ja kirjoittaa toisen rivin. Call my webhook -vaihe taas epäonnistuu ja lähettää sinulle sähköpostia. doPost ei myöskään lue pyynnön otsikoita, joten X-EC-Signature-tarkistus on siellä mahdoton.

Apps Script sopii edelleen hyvin toiseen suuntaan: hyväksyttyjen viestipohjien lähettämiseen taulukon riveiltä, mitä Google Sheets -integraatiosivu käsittelee koodilla.

Voivatko Make tai Zapier täyttää taulukon sen sijaan?

Voivat. Makessa aloita skenaario Webhooks > Custom webhook -valinnalla ja lisää Google Sheets > Add a Row. Zapierissa käytä Webhooks by Zapier -palvelua Catch Raw Hook -toiminnolla, joka säilyttää otsikot, ja sen jälkeen Google Sheets > Create Spreadsheet Row. Molemmat vastaavat POST-pyyntöön heti 2xx-vastauksella, mitä edelleenlähetys tarvitsee 10 sekunnin sisällä. Kartoita samat kentät kuin edellä kohdasta value.messages ja suodata pois tapahtumat, joiden value sisältää statuses-kentän messages-kentän sijaan.

Käsittele hook-URL-osoitetta salasanana, sillä kuka tahansa sen omaava voi lähettää rivejä. Jos tilaukseesi kuuluu koodivaihe, tarkista X-EC-Signature siellä samalla HMAC-reseptillä kuin n8n-solmussa.

Miten estät kaksoisrivit ja puuttuvat rivit?

Kaksoisrivit syntyvät uudelleenyrityksistä. Edelleenlähetys, joka ei saanut 2xx-vastausta 10 sekunnin sisällä, lähetetään uudelleen samalla X-EC-Delivery-otsikolla ja samalla id-tunnuksella rungossa. Viestit sen sisällä säilyttävät wamid-tunnuksensa, joten täsmäys kenttään Message id tekee uudelleenyrityksestä vaarattoman. Webhook-vaiheen reitillä Try it -testit saapuvat arvolla dry_run true: ohjaa ne testivälilehdelle tai hylkää ne.

Puuttuvat rivit johtuvat Googlen kirjoituskiintiöstä. Sheets API sallii 60 kirjoituspyyntöä minuutissa per käyttäjä per projekti, ja yksi n8n-tunnistetieto on yksi käyttäjä. Vastausten ryöpsähdys viestipohjakampanjan jälkeen voi ylittää rajan ja saada HTTP 429 -vastauksen. Ota Google Sheets -solmun asetuksista käyttöön Retry On Fail tai kerää viestejä muutaman sekunnin ajan ja lisää ne yhdessä pyynnössä.

Näin otat sen käyttöön

  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.

Yleiset virheet

  • Edelleenlähetyksen tarkistaminen automaation Signing secret -salaisuudella tai päinvastoin. Forward URL allekirjoitetaan numeron edelleenlähetyssalaisuudella ja Call my webhook automaation omalla. Valitse salaisuus X-EC-Event-otsikon perusteella.
  • Rivin lisääminen jokaista POST-pyyntöä kohden ilman avainta. Toimitus, joka yritetään uudelleen hitaan vastauksen jälkeen, kirjoittaa saman viestin kahdesti. Käytä Append or Update Row -operaatiota, joka täsmää viestin tunnukseen.
  • Toimitustilojen kirjoittaminen viesteinä. messages-tapahtumassa on myös value.statuses-kentässä lähetetty-, toimitettu- ja luettu-tiloja, joilla ei ole tekstiä ja jotka luovat tyhjiä rivejä.
  • Apps Script -verkkosovelluksen URL-osoitteen tallentaminen Forward URL -osoitteeksi. Sen uudelleenohjaus lasketaan epäonnistumiseksi, joten jokainen 7 yrityksestä ajaa doPost-funktion uudelleen ja lisää kaksoisrivin.
Näin teet tämän EasyCoexistencen avulla

Kun automaatiot ovat päällä, Forward URL välittää Metan alkuperäiset tapahtumat työnkulkuusi, allekirjoitettuina salaisuudella, jonka vain sinä tunnet, ja yritetään uudelleen, kun URL-osoitteesi ei vastaa. Call my webhook -vaihe lähettää sen, minkä automaatio käsitteli, vastauksineen. Molemmat kuuluvat pakettiin. US$ 9:stä US$ 0,75:een numeroa kohden kuukaudessa, kun lisäät numeroita. Ensimmäiset 3 päivää ovat ilmaista kokeilua.

Usein kysytyt kysymykset

Saako taulukko viestit, jotka tiimini kirjoittaa puhelimella?

Kyllä, Forward URL:n kautta. WhatsApp Business -sovelluksessa kirjoitetut vastaukset saapuvat smb_message_echoes-tapahtumina, ja asiakkaan numero on kentässä to. Automaatioiden lähettämät vastaukset palautuvat vain toimitustiloina, joten kirjaa niiden teksti Call my webhook -vaiheesta, joka sijoitetaan vastauksen jälkeen.

Voinko ladata olemassa olevat keskusteluni taulukkoon?

Et numerolla, jonka viestit kulkevat easyCoexistencen kautta. Meta lähettää enintään 6 kuukauden kahden kesken käydyt keskustelut vain suoraan webhook-kohteeseen, joka on tallennettu 24 tunnin sisällä yhdistämisestä, kerran per yhteys. Numero, joka reititetään easyCoexistencen kautta, kirjaa tapahtumat siitä hetkestä, kun Forward URL tallennetaan.

Säilyttääkö easyCoexistence kopion viesteistä?

Osittain. Numerolla, jonka viestit kulkevat easyCoexistencen kautta ja jossa automaatiot ovat päällä, viestien teksti säilytetään valitsemasi ajan, 30, 90 tai 365 päivää (oletuksena 90), ja se näkyy Conversations-näkymässä. Edelleenlähetetyt toimitukset säilytetään enintään 7 päivää uudelleenyrityksiä varten, ja ajojen lokit 30 päivää. Taulukko on sinun pysyvä kopiosi.

Voiko tekoälyni lukea taulukon ja vastata asiakkaille?

Ei Reply with AI -vaiheesta, joka lukee vain omat Instructions-ohjeensa ja keskustelun. AI-agentti voi hakea tietoa mukautetun HTTP-työkalun kautta, ja Call my webhook- tai Call an API -vaihe voi lähettää kysymyksen työnkulkuun, joka etsii vastauksen taulukosta ja palauttaa sen vastauksena.

Lue lisää

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeilu

Vahvistettu