Enregistrer automatiquement les messages et contacts WhatsApp dans Google Sheets
Pour enregistrer automatiquement les messages WhatsApp Business dans Google Sheets, envoyez-les sous forme de POST HTTP signés vers un outil d'automatisation comme n8n, Make ou Zapier, et laissez son étape Google Sheets ajouter une ligne par message : heure, sens, numéro de téléphone, nom, texte et identifiant du message. Un second onglet indexé sur le numéro de téléphone conserve une ligne par contact, mise à jour à chaque nouveau message de sa part.
easyCoexistence connecte le numéro WhatsApp Business que vous gardez dans l'application à la Cloud API de Meta via Coexistence.
Les envois transférés sont relancés après environ 1, 5, 30, 120, 360 et 1 440 minutes lorsque votre URL échoue.
Délai pendant lequel un POST transféré attend une réponse 2xx avant que cet envoi soit relancé.
Requêtes d'écriture de l'API Google Sheets autorisées par minute, par utilisateur et par projet : 300 par projet.
La sortie d'une application web Apps Script est redirigée vers une URL à usage unique sur script.googleusercontent.com.
L'objet d'événement doPost d'Apps Script expose le corps et les paramètres, et non les en-têtes de la requête HTTP.
Quelle route doit alimenter la feuille ?
Deux routes existent sur un numéro dont les messages passent par easyCoexistence, et elles répondent à des besoins différents. L'URL de transfert, définie une fois par numéro, transmet les événements d'origine de Meta, qu'une automatisation réponde ou non : messages des clients, réponses tapées par votre équipe dans l'application WhatsApp Business et statuts de livraison. C'est la route pour un journal complet des messages. Une étape Call my webhook placée dans une automatisation ne se déclenche que pour les messages que cette automatisation retient, et transmet la conversation récente, y compris la réponse que l'automatisation vient d'envoyer. Elle convient à une feuille de prospects, de commandes ou de demandes gérée par une seule automatisation. Les deux sont signées, avec des secrets différents.
| 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 |
Quels champs arrivent, et quelles colonnes la feuille doit-elle avoir ?
Un POST transféré encapsule un changement Meta : id (l'envoi), event (le nom de champ Meta, comme messages ou smb_message_echoes), received_at, connection (l'identifiant de votre numéro, phone et phone_number_id) et value, exactement tel que Meta l'a envoyé. Dans value, messages contient ce que les clients ont écrit et message_echoes contient ce que votre équipe a tapé sur le téléphone. Les numéros arrivent sous forme de chiffres avec l'indicatif pays et sans signe plus ; enregistrez cette colonne en texte brut pour que Sheets ne la transforme pas en nombre. Un utilisateur disposant d'un nom d'utilisateur WhatsApp peut arriver avec un identifiant utilisateur propre à l'entreprise à côté du numéro, ou à sa place : prévoyez donc une colonne pour lui.
Comment construire le journal des messages dans n8n ?
Trois nœuds. Un nœud Webhook avec HTTP Method POST, Respond réglé sur Immediately, et son Production URL enregistrée comme URL de transfert du numéro. Un nœud Code qui vérifie X-EC-Signature avec le secret de transfert et transforme l'événement en lignes, en ignorant les statuts de livraison. Un nœud Google Sheets avec l'opération Append or Update Row, et Column to match on réglé sur l'identifiant du message, pour qu'une relance réécrive la même ligne au lieu d'en ajouter une.
Le secret de transfert n'apparaît qu'une fois, lors de l'enregistrement de l'URL de transfert ; s'il est perdu, cliquez sur New secret et collez le nouveau. n8n Cloud autorise le module crypto dans les nœuds Code ; n8n auto-hébergé nécessite 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 }));Comment garder une ligne par contact ?
Ajoutez un second nœud Google Sheets sur un onglet Contacts, également avec Append or Update Row, avec correspondance sur le téléphone. Associez le téléphone, le nom de profil, l'identifiant utilisateur, l'heure et le texte du dernier message. Le premier message d'un numéro crée sa ligne ; les suivants mettent à jour le nom et les colonnes du dernier contact, de sorte que l'onglet sert aussi de liste de qui a écrit et quand. Gardez les notes rédigées à la main dans un onglet séparé, recherchées par téléphone, pour que le workflow ne les écrase jamais.
Les contacts enregistrés dans le carnet d'adresses du téléphone n'arrivent pas de cette façon. Meta les envoie, avec jusqu'à 6 mois de conversations, uniquement vers une destination de webhook directe enregistrée dans les 24 heures suivant la connexion du numéro.
Apps Script peut-il recevoir directement les messages ?
Pas proprement, donc placez un outil de workflow devant la feuille. Google sert la réponse d'une application web Apps Script via une redirection vers une URL à usage unique script.googleusercontent.com, et easyCoexistence ne suit pas les redirections. Le 302 compte comme un envoi échoué : un transfert est relancé jusqu'à 7 fois, et chaque relance exécute à nouveau doPost et écrit une autre ligne, tandis qu'une étape Call my webhook échoue et vous envoie un e-mail. doPost ne peut pas non plus lire les en-têtes de requête, donc la vérification de X-EC-Signature y est impossible.
Apps Script reste adapté à l'autre sens, l'envoi de templates approuvés à partir des lignes d'une feuille, que la page d'intégration Google Sheets décrit avec du code.
Make ou Zapier peuvent-ils alimenter la feuille à la place ?
Oui. Dans Make, démarrez le scénario avec Webhooks > Custom webhook et ajoutez Google Sheets > Add a Row ; dans Zapier, utilisez Webhooks by Zapier avec Catch Raw Hook, qui conserve les en-têtes, puis Google Sheets > Create Spreadsheet Row. Les deux répondent immédiatement au POST par un 2xx, ce qu'exige un transfert dans ses 10 secondes. Associez les mêmes champs que ci-dessus à partir de value.messages, et filtrez les événements dont value contient statuses au lieu de messages.
Traitez l'URL du webhook comme un mot de passe, car quiconque la détient peut ajouter des lignes. Si votre offre inclut une étape de code, vérifiez-y X-EC-Signature avec la même recette HMAC que celle du nœud n8n.
Comment éviter les lignes en double ou manquantes ?
Les doublons viennent des relances. Un transfert qui n'a pas reçu de 2xx dans les 10 secondes est renvoyé avec le même en-tête X-EC-Delivery et le même id dans le corps, et les messages qu'il contient conservent leur wamid ; une correspondance sur l'identifiant du message rend donc une relance sans effet. Sur la route de l'étape webhook, les tests lancés depuis Try it arrivent avec dry_run à true : dirigez-les vers un onglet de test ou supprimez-les.
Les lignes manquantes viennent du quota d'écriture de Google. L'API Sheets autorise 60 requêtes d'écriture par minute et par utilisateur et par projet, et un identifiant n8n correspond à un seul utilisateur ; une rafale de réponses après une campagne de templates peut dépasser ce quota et renvoyer une erreur HTTP 429. Activez Retry On Fail dans les paramètres du nœud Google Sheets, ou regroupez les messages pendant quelques secondes pour les ajouter en une seule requête.
Comment le configurer
- 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.
Erreurs courantes
- Vérifier un transfert avec le secret de signature d'une automatisation, ou l'inverse. L'URL de transfert est signée avec le secret de transfert du numéro, et Call my webhook avec le secret propre à l'automatisation ; choisissez le secret selon l'en-tête X-EC-Event.
- Ajouter une ligne par POST sans clé. Un envoi relancé après une réponse lente écrit deux fois le même message ; utilisez Append or Update Row avec correspondance sur l'identifiant du message.
- Écrire les statuts de livraison comme des messages. L'événement messages transporte aussi les statuts sent, delivered et read dans value.statuses, qui n'ont pas de texte et créent des lignes vides.
- Enregistrer l'URL d'une application web Apps Script comme URL de transfert. Sa redirection compte comme un échec, donc chacune des 7 tentatives exécute doPost et ajoute une ligne en double.
Avec les automatisations activées, une URL de transfert transmet les événements d'origine de Meta à votre workflow, signés avec un secret que vous seul détenez et relancés lorsque votre URL est indisponible, et une étape Call my webhook transmet ce qu'une automatisation a traité, avec sa réponse. Les deux sont inclus dans l'offre. De US$ 9 à US$ 0,75 par numéro et par mois, le prix baissant à mesure que vous ajoutez des numéros, avec un essai gratuit de 3 jours.
Questions fréquemment posées
La feuille reçoit-elle les messages que mon équipe tape sur le téléphone ?
Oui, par l'URL de transfert. Les réponses tapées dans l'application WhatsApp Business arrivent sous forme d'événements smb_message_echoes, avec le numéro du client dans to. Les réponses envoyées par les automatisations ne reviennent que sous forme de statuts de livraison ; enregistrez donc leur texte grâce à une étape Call my webhook placée après la réponse.
Puis-je charger mes conversations existantes dans la feuille ?
Pas sur un numéro dont les messages passent par easyCoexistence. Meta n'envoie jusqu'à 6 mois de conversations individuelles que vers une destination de webhook directe enregistrée dans les 24 heures suivant la connexion, une seule fois par connexion. Un numéro acheminé par easyCoexistence enregistre à partir du moment où l'URL de transfert est sauvegardée.
easyCoexistence conserve-t-il une copie des messages ?
Partiellement. Sur un numéro acheminé par easyCoexistence avec les automatisations activées, le texte des messages est conservé pendant la durée que vous choisissez, 30, 90 ou 365 jours (90 par défaut), et affiché dans Conversations ; les livraisons transférées sont conservées jusqu'à 7 jours pour les relances, et les journaux d'exécution 30 jours. La feuille est votre copie permanente.
Mon IA peut-elle lire la feuille pour répondre aux clients ?
Pas depuis une étape Reply with AI, qui ne lit que ses Instructions et la conversation. Un agent IA peut faire des recherches via un outil HTTP personnalisé, et une étape Call my webhook ou Call an API peut envoyer la question à un workflow qui recherche la réponse dans la feuille et la renvoie comme réponse.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le