ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
Meta Tech Provider

Αυτόματη αποθήκευση μηνυμάτων και επαφών WhatsApp σε Google Sheets

Για την αυτόματη αποθήκευση μηνυμάτων WhatsApp Business σε Google Sheets, στείλτε τα ως υπογεγραμμένα HTTP POST σε ένα εργαλείο αυτοματισμού, όπως τα n8n, Make ή Zapier, και αφήστε το βήμα Google Sheets να προσθέτει μια γραμμή για κάθε μήνυμα: ώρα, κατεύθυνση, αριθμός τηλεφώνου, όνομα, κείμενο και Message id. Ένα δεύτερο φύλλο με κλειδί τον αριθμό τηλεφώνου κρατά μία γραμμή ανά επαφή, ενημερωμένη όταν σας γράψει ξανά.

Το easyCoexistence συνδέει τον αριθμό WhatsApp Business που κρατάτε στην εφαρμογή με το Cloud API της Meta μέσω του Coexistence.

7 attempts

Οι προωθημένες παραδόσεις επαναλαμβάνονται μετά από περίπου 1, 5, 30, 120, 360 και 1.440 λεπτά όταν το URL σας αποτυγχάνει.

10 s

Για πόσο χρόνο περιμένει μια προωθημένη POST απάντηση 2xx πριν επαναληφθεί η παράδοση.

60 / min

Επιτρεπόμενα αιτήματα εγγραφής του Google Sheets API ανά λεπτό, ανά χρήστη και ανά έργο· 300 ανά έργο.

Redirect

Η έξοδος της web app του Apps Script ανακατευθύνεται σε ένα URL μίας χρήσης στο script.googleusercontent.com.

No headers

Το αντικείμενο συμβάντος doPost του Apps Script εκθέτει το σώμα και τις παραμέτρους, όχι τις κεφαλίδες του αιτήματος HTTP.

Ποια διαδρομή πρέπει να γεμίζει το φύλλο;

Σε έναν αριθμό τα μηνύματα του οποίου περνούν μέσα από το easyCoexistence υπάρχουν δύο διαδρομές, και απαντούν σε διαφορετικές ανάγκες. Το Forward URL, που ορίζεται μία φορά ανά αριθμό, προωθεί τα αρχικά συμβάντα της Meta είτε απαντά κάποιος αυτοματισμός είτε όχι: μηνύματα πελατών, τις απαντήσεις που πληκτρολογεί η ομάδα σας στην εφαρμογή WhatsApp Business και τις καταστάσεις παράδοσης. Είναι η διαδρομή για πλήρες ιστορικό μηνυμάτων. Ένα βήμα Call my webhook μέσα σε αυτοματισμό ενεργοποιείται μόνο για τα μηνύματα που επιλέγει ο συγκεκριμένος αυτοματισμός και μεταφέρει την πρόσφατη συνομιλία, συμπεριλαμβανομένης της απάντησης που μόλις έστειλε ο αυτοματισμός. Ταιριάζει σε φύλλο με leads, παραγγελίες ή αιτήματα που χειρίζεται ένας αυτοματισμός. Και οι δύο υπογράφονται, με διαφορετικά μυστικά.

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

Ποια πεδία φτάνουν και ποιες στήλες πρέπει να έχει το φύλλο;

Μια προωθημένη POST περιέχει μία αλλαγή της Meta: id (την παράδοση), event (το όνομα πεδίου της Meta, όπως messages ή smb_message_echoes), received_at, connection (το αναγνωριστικό του αριθμού σας, phone και phone_number_id) και value, όπως ακριβώς τα έστειλε η Meta. Στο value, τα messages περιέχουν όσα έγραψαν οι πελάτες και τα message_echoes όσα πληκτρολόγησε η ομάδα σας στο τηλέφωνο. Οι αριθμοί τηλεφώνου φτάνουν ως ψηφία με τον κωδικό χώρας και χωρίς το σύμβολο +· αποθηκεύστε αυτή τη στήλη ως απλό κείμενο, ώστε το Sheets να μην τη μετατρέψει σε αριθμό. Ένας χρήστης με όνομα χρήστη WhatsApp μπορεί να φτάσει με user ID σε επίπεδο επιχείρησης δίπλα στον αριθμό ή στη θέση του, οπότε κρατήστε μια στήλη και για αυτό.

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

Πώς χτίζετε το ιστορικό μηνυμάτων στο n8n;

Τρεις κόμβοι. Ένας κόμβος Webhook με HTTP Method POST, Respond ορισμένο σε Immediately, και το Production URL του αποθηκευμένο ως Forward URL του αριθμού. Ένας κόμβος Code που ελέγχει το X-EC-Signature με το μυστικό προώθησης και μετατρέπει το συμβάν σε γραμμές, παραλείποντας τις καταστάσεις παράδοσης. Ένας κόμβος Google Sheets με λειτουργία Append or Update Row και Column to match on ορισμένο σε Message id, ώστε μια επαναληπτική παράδοση να ξαναγράφει την ίδια γραμμή αντί να προσθέτει μία νέα.

Το μυστικό προώθησης εμφανίζεται μία φορά, όταν αποθηκεύσετε το Forward URL· αν χαθεί, πατήστε New secret και επικολλήστε το νέο. Το n8n Cloud επιτρέπει το module crypto στους κόμβους Code· το self-hosted n8n χρειάζεται 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 }));

Πώς κρατάτε μία γραμμή ανά επαφή;

Προσθέστε έναν δεύτερο κόμβο Google Sheets σε φύλλο Contacts, επίσης με Append or Update Row, με αντιστοίχιση στο Phone. Αντιστοιχίστε το τηλέφωνο, το όνομα προφίλ, το user ID, την ώρα και το κείμενο του τελευταίου μηνύματος. Το πρώτο μήνυμα από έναν αριθμό δημιουργεί τη γραμμή του· τα επόμενα ενημερώνουν τις στήλες ονόματος και τελευταίας επικοινωνίας, οπότε το φύλλο λειτουργεί και ως λίστα με το ποιος έγραψε και πότε. Κρατήστε τις χειρόγραφες σημειώσεις σε ξεχωριστό φύλλο, με αναζήτηση βάσει τηλεφώνου, ώστε η ροή εργασίας να μην τις αντικαθιστά ποτέ.

Οι επαφές που είναι αποθηκευμένες στο βιβλίο διευθύνσεων του τηλεφώνου δεν φτάνουν με αυτόν τον τρόπο. Τις στέλνει η Meta, μαζί με έως 6 μήνες συνομιλιών, μόνο σε άμεσο προορισμό webhook που έχει αποθηκευτεί εντός 24 ωρών από τη σύνδεση του αριθμού.

Μπορεί το Apps Script να λαμβάνει τα μηνύματα απευθείας;

Όχι καθαρά, γι' αυτό βάλτε ένα εργαλείο ροής εργασιών μπροστά από το φύλλο. Η Google σερβίρει την απάντηση μιας web app του Apps Script με ανακατεύθυνση σε ένα URL μίας χρήσης στο script.googleusercontent.com, και το easyCoexistence δεν ακολουθεί ανακατευθύνσεις. Το 302 μετράει ως αποτυχημένη παράδοση: μια προώθηση επαναλαμβάνεται έως 7 φορές, και κάθε επανάληψη τρέχει ξανά το doPost και γράφει μια ακόμη γραμμή, ενώ ένα βήμα Call my webhook αποτυγχάνει και σας στέλνει email. Το doPost επίσης δεν μπορεί να διαβάσει κεφαλίδες αιτήματος, άρα ο έλεγχος X-EC-Signature είναι αδύνατος εκεί.

Το Apps Script παραμένει καλή επιλογή για την αντίστροφη κατεύθυνση, την αποστολή εγκεκριμένων templates από γραμμές ενός φύλλου, την οποία καλύπτει με κώδικα η σελίδα ενσωμάτωσης Google Sheets.

Μπορούν το Make ή το Zapier να γεμίζουν το φύλλο;

Ναι. Στο Make, ξεκινήστε το σενάριο με Webhooks > Custom webhook και προσθέστε Google Sheets > Add a Row· στο Zapier, χρησιμοποιήστε Webhooks by Zapier με Catch Raw Hook, που διατηρεί τις κεφαλίδες, και μετά Google Sheets > Create Spreadsheet Row. Και τα δύο απαντούν αμέσως στο POST με 2xx, κάτι που χρειάζεται μια προώθηση μέσα στα 10 δευτερόλεπτά της. Αντιστοιχίστε τα ίδια πεδία όπως παραπάνω από το value.messages, και φιλτράρετε τα συμβάντα των οποίων το value περιέχει statuses αντί για messages.

Αντιμετωπίστε τη διεύθυνση του hook ως κωδικό πρόσβασης, αφού όποιος την κατέχει μπορεί να στείλει γραμμές. Όπου το πρόγραμμά σας περιλαμβάνει βήμα κώδικα, ελέγξτε εκεί το X-EC-Signature με την ίδια συνταγή HMAC που χρησιμοποιείται στον κόμβο του n8n.

Πώς αποφεύγετε τις διπλές ή τις χαμένες γραμμές;

Οι διπλότυπες γραμμές προέρχονται από επαναλήψεις. Μια προώθηση που δεν έλαβε απάντηση 2xx μέσα σε 10 δευτερόλεπτα στέλνεται ξανά με την ίδια κεφαλίδα X-EC-Delivery και το ίδιο id στο σώμα, ενώ τα μηνύματα μέσα της κρατούν το wamid τους. Έτσι, η αντιστοίχιση στο Message id κάνει την επανάληψη ακίνδυνη. Στη διαδρομή του βήματος webhook, οι δοκιμές από το Try it φτάνουν με dry_run true· στείλτε τις σε δοκιμαστικό φύλλο ή απορρίψτε τις.

Οι χαμένες γραμμές προέρχονται από το όριο εγγραφής της Google. Το Sheets API επιτρέπει 60 αιτήματα εγγραφής ανά λεπτό ανά χρήστη και ανά έργο, και ένα credential του n8n αντιστοιχεί σε έναν χρήστη· ένα ξέσπασμα απαντήσεων μετά από μια καμπάνια templates μπορεί να το ξεπεράσει και να επιστρέψει HTTP 429. Ενεργοποιήστε το Retry On Fail στις ρυθμίσεις του κόμβου Google Sheets, ή συλλέξτε τα μηνύματα για λίγα δευτερόλεπτα και προσθέστε τα σε ένα αίτημα.

Πώς να το ρυθμίσετε

  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.

Συνηθισμένα λάθη

  • Έλεγχος μιας προώθησης με το Signing secret ενός αυτοματισμού, ή το αντίστροφο. Το Forward URL υπογράφεται με το μυστικό προώθησης του αριθμού και το Call my webhook με το δικό του μυστικό του αυτοματισμού· επιλέξτε το μυστικό με βάση την κεφαλίδα X-EC-Event.
  • Προσθήκη γραμμής για κάθε POST χωρίς κλειδί. Μια παράδοση που επαναλήφθηκε μετά από αργή απάντηση γράφει το ίδιο μήνυμα δύο φορές· χρησιμοποιήστε Append or Update Row με αντιστοίχιση στο Message id.
  • Εγγραφή των καταστάσεων παράδοσης ως μηνύματα. Το συμβάν messages μεταφέρει επίσης τις καταστάσεις sent, delivered και read στο value.statuses, που δεν έχουν κείμενο και δημιουργούν κενές γραμμές.
  • Αποθήκευση URL web app του Apps Script ως Forward URL. Η ανακατεύθυνσή του μετράει ως αποτυχία, οπότε καθεμία από τις 7 προσπάθειες τρέχει ξανά το doPost και προσθέτει διπλή γραμμή.
Κάντε το με EasyCoexistence

Με ενεργά τα Automations, ένα Forward URL περνά τα αρχικά συμβάντα της Meta στη ροή σας, υπογεγραμμένα με ένα μυστικό που κατέχετε μόνο εσείς και επαναλαμβάνονται όταν το URL σας είναι εκτός λειτουργίας, και ένα βήμα Call my webhook στέλνει όσα χειρίστηκε ένας αυτοματισμός, μαζί με την απάντησή του. Και τα δύο περιλαμβάνονται στο πρόγραμμα. Από US$ 9 ανά συνδεδεμένο αριθμό τον μήνα, μειούμενο έως US$ 0,75 καθώς προσθέτετε αριθμούς, με τις πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Παίρνει το φύλλο και τα μηνύματα που πληκτρολογεί η ομάδα μου στο τηλέφωνο;

Ναι, μέσω του Forward URL. Οι απαντήσεις που γράφονται στην εφαρμογή WhatsApp Business φτάνουν ως συμβάντα smb_message_echoes, με τον αριθμό του πελάτη στο to. Οι απαντήσεις που στέλνουν οι αυτοματισμοί επιστρέφουν μόνο ως καταστάσεις παράδοσης, οπότε καταγράψτε το κείμενό τους από ένα βήμα Call my webhook που τοποθετείτε μετά την απάντηση.

Μπορώ να φορτώσω τις υπάρχουσες συνομιλίες μου στο φύλλο;

Όχι σε αριθμό τα μηνύματα του οποίου περνούν μέσα από το easyCoexistence. Η Meta στέλνει έως 6 μήνες συνομιλιών μεταξύ δύο μερών μόνο σε άμεσο προορισμό webhook που έχει αποθηκευτεί εντός 24 ωρών από τη σύνδεση, μία φορά ανά σύνδεση. Ένας αριθμός που δρομολογείται μέσω του easyCoexistence καταγράφει από τη στιγμή που αποθηκεύεται το Forward URL.

Κρατάει το easyCoexistence αντίγραφο των μηνυμάτων;

Εν μέρει. Σε αριθμό που περνά από το easyCoexistence με ενεργά τα Automations, το κείμενο των μηνυμάτων διατηρείται για το διάστημα που επιλέγετε, 30, 90 ή 365 ημέρες (90 από προεπιλογή), και εμφανίζεται στις Συνομιλίες· οι προωθημένες παραδόσεις κρατιούνται έως 7 ημέρες για επαναλήψεις, και τα αρχεία εκτέλεσης 30 ημέρες. Το φύλλο σας είναι το μόνιμο αντίγραφο.

Μπορεί η τεχνητή νοημοσύνη μου να διαβάζει το φύλλο για να απαντά στους πελάτες;

Όχι από ένα βήμα Reply with AI, που διαβάζει μόνο τις Instructions του και τη συνομιλία. Ένας πράκτορας AI μπορεί να κάνει αναζητήσεις μέσω ενός προσαρμοσμένου εργαλείου HTTP, και ένα βήμα Call my webhook ή Call an API μπορεί να στείλει την ερώτηση σε μια ροή εργασιών που αναζητά την απάντηση στο φύλλο και την επιστρέφει ως απάντηση.

Συνεχίστε την ανάγνωση

Αποστολή συνομιλιών WhatsApp στο CRM σας αυτόματαΚαταγράψτε συνομιλίες WhatsApp στο CRM από τον αριθμό σας: υπογεγραμμένα συμβάντα, αντιστοίχιση επαφών με τηλέφωνο ή BSUID, χωρίς διπλότυπα.Απαντήστε στους πελάτες WhatsApp με ζωντανά δεδομένα: τιμές, απόθεμα και διαθεσιμότητα από το σύστημά σαςΑπαντήστε με ζωντανά δεδομένα σε ερωτήσεις για τιμές, απόθεμα ή διαθέσιμες θέσεις: το webhook ρωτά το σύστημά σας, απάντηση σε 20 δευτερόλεπτα.Καταγραφή μηνυμάτων WhatsApp στο Google Sheets και αποστολή από φύλλοΚαταγράψτε κάθε μήνυμα WhatsApp ενός αριθμού Coexistence στο Google Sheets μέσω n8n και στείλτε εγκεκριμένα templates με Apps Script UrlFetchApp.Πώς φτάνουν τα μηνύματα WhatsApp στον διακομιστή σας: άμεσα ή διαχειριζόμενα, και επαλήθευση της υπογραφήςΆμεσα: η Meta στέλνει στον διακομιστή σας. Διαχειριζόμενα: αυτοματισμοί και υπογεγραμμένη προώθηση στο Forward URL. Payload, X-EC-Signature και επαναδοκιμές.Το webhook smb_message_echoesΠώς το λογισμικό βλέπει τι έστειλε άνθρωπος από την εφαρμογή WhatsApp Business. Υπάρχει μόνο σε αριθμούς Coexistence και η αγνόησή του φέρνει διπλές απαντήσεις.Συνδέστε το WhatsApp με το n8n στο επίσημο Cloud APIΔρομολογήστε μηνύματα WhatsApp σε ροή εργασίας n8n μέσω του επίσημου Cloud API της Meta, ενώ η επιχείρηση απαντά από το τηλέφωνο. Χωρίς συσκευή.

Έτοιμοι να ξεκινήσετε;

Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.

Ξεκινήστε δωρεάν δοκιμή

Επαληθεύτηκε στις