Aller au contenu

CRM et API WhatsApp : la vie d'une commande en 8 messages

Votre cliente vous écrit « où est ma commande ? » sur WhatsApp, et votre CRM ne le sait même pas. Le plus étonnant : ce message ne vous coûte rien, c'est celui que vous lui enverrez trois jours plus tard qui se paie.

Mis à jour le 22 novembre 2026Lire en Markdown

Un CRM branché à l'API WhatsApp suit chaque commande dans la conversation où le client la vit : confirmation, livraison, question, avis, réachat. Il faut trois choses : relier chaque message à un contact et à une commande, respecter la fenêtre de 24 heures et le consentement, et laisser votre code décider de ce qui part.

Le test des 30 secondes

Avant de lire la suite, répondez par oui ou par non. Pour chaque « non », un chapitre plus bas vous concerne.

  • Quand un client écrit « où est ma commande ? », votre équipe trouve la commande sans lui demander son numéro de commande.
  • Votre CRM sait qui a accepté de recevoir vos messages WhatsApp, et depuis quand.
  • Un client qui répond STOP ne reçoit plus rien, même d'une autre équipe.
  • Vous savez quels messages Meta vous facture, et lesquels sont gratuits.
  • Si votre serveur reçoit deux fois le même événement, le client ne reçoit pas deux fois le même message.

Cinq oui : vous pouvez sauter au chapitre des pièges. Sinon, suivez Léa.

L'application WhatsApp Business ne suffit pas à un CRM

Beaucoup d'équipes commencent avec l'application WhatsApp Business sur un téléphone. Elle est faite pour une personne qui répond à la main. Un CRM a besoin d'autre chose : que chaque message arrive dans votre logiciel, et qu'il puisse en envoyer.

Besoin du CRMApplication WhatsApp BusinessAPI WhatsApp (officielle, de Meta)
Recevoir chaque message dans votre logicielNonOui, par webhook
Envoyer depuis votre logicielNonOui, par API
Plusieurs personnes sur le même numéroLimitéAutant que votre logiciel en gère
Messages automatiques (confirmation, livraison)NonOui, par modèles approuvés par Meta
Savoir si le message a été livré et luÀ l'œil, sur le téléphoneOui, par événement

Un mot sur les solutions « non officielles », qui branchent un CRM par QR code et une session WhatsApp Web. Elles marchent jusqu'au jour où Meta bloque le numéro. Pour un CRM qui porte les commandes de vos clients, ce risque n'en vaut pas la peine. Détails dans API WhatsApp officielle ou non officielle.

La vie d'une commande en 8 messages

Suivons Léa, cliente d'une boutique de baskets en ligne. L'exemple est inventé ; les règles de Meta qu'il illustre sont réelles.

#MomentQui écritType de messagePayant chez Meta ?Ce que votre CRM enregistre
1Léa coche « recevoir le suivi sur WhatsApp » au paiement———Le consentement, sa date, sa source
2Commande payéeVousModèle « utilité » : confirmationOuiMessage lié à la commande n° 1042
3Colis expédié, deux jours plus tardVousModèle « utilité » : expédition et lien de suiviOuiStatut livré, puis lu
4« Je peux changer l'adresse ? »LéaMessage reçuNonLa fenêtre de 24 heures s'ouvre
5« Oui, voici le lien pour la modifier »Votre équipeTexte libreNon, jusqu'à 1 000 réponses par numéro et par moisRéponse liée à la commande
6Colis livréVousTexte libre, la fenêtre est encore ouverteNon, dans la limite des 1 000Statut de la commande
7Dix jours plus tard : « Comment trouvez-vous vos baskets ? »VousModèle « marketing »OuiRéponse, ou silence
8Léa répond STOPLéaMessage reçuNonConsentement retiré : plus aucun envoi marketing

Trois choses se voient dans ce tableau.

  • Les messages 2, 3 et 7 sont des modèles. Hors de la fenêtre de 24 heures, vous ne pouvez écrire à Léa qu'avec un modèle approuvé par Meta. Explications dans la fenêtre de 24 heures.
  • Le message de Léa ouvre une fenêtre. Pendant 24 heures, vos réponses en texte libre sont gratuites, jusqu'à 1 000 par numéro et par mois depuis le 1er octobre 2026. Détails dans Les réponses WhatsApp ne sont plus gratuites.
  • Le STOP vaut pour tout le monde. La politique de Meta demande de respecter un refus, qu'il arrive dans WhatsApp ou ailleurs. Votre CRM doit le savoir avant toute campagne.

Ce que votre CRM doit retenir

Pas besoin d'un nouveau CRM. Il faut cinq informations, à leur bonne place.

InformationExemple pour LéaD'où elle vientPourquoi elle compte
Le contactLéa, +33 6 12 34 56 78Votre boutique, puis WhatsAppLe numéro au format international est la clé qui relie les deux
La commanden° 1042, expédiéeVotre boutique ou votre ERPElle reste la source de vérité du statut
La conversation6 messages, dernier hier à 18 hLes événements WhatsAppVotre équipe voit l'historique sans demander
Le consentementOui depuis le 3 novembre, retiré le 21Le paiement, puis le STOPIl décide qui peut recevoir un modèle marketing
La prochaine actionRembourser la taille 38Votre équipeElle survit au changement d'équipe

Une règle simple évite la moitié des erreurs : un contact importé n'est pas un contact consentant. Une liste de numéros de clients ne vous autorise pas à leur écrire sur WhatsApp. Le consentement se recueille, et se date.

Le branchement, en vrai

Voici le chemin d'un message, du téléphone de Léa à votre CRM, et retour.

Text

Léa (WhatsApp) │ « Je peux changer l'adresse ? » ▼Meta (API WhatsApp Cloud) ▼Nodium ── webhook signé ──► votre serveur ──► votre CRM │ (contact, commande, conversation) │ votre code décide ▼Nodium ◄── POST /v1/messages ── votre serveur ▼Léa reçoit la réponse

Votre serveur reçoit chaque message par webhook, vérifie qu'il vient bien de Nodium, puis le range dans le CRM :

Node.js

import { NodiumSignatureError, verifyWebhook } from '@nodium.io/whatsapp/server'export async function POST(request) { const rawBody = await request.text() // the signature is computed on the raw body try { const event = verifyWebhook(rawBody, request.headers, process.env.NODIUM_WEBHOOK_SECRET) const data = event.data if (event.event === 'message.received') { const contact = await crm.contacts.findByPhone(data.from) const order = contact && await crm.orders.lastOpen(contact.id) await crm.timeline.add({ contactId: contact?.id, orderId: order?.id, text: data.text, at: event.occurred_at }) } if (event.event === 'contact.opted_out') { await crm.contacts.setWhatsappConsent(data.contact_id, false) } return new Response(null, { status: 200 }) } catch (error) { if (error instanceof NodiumSignatureError) return new Response(null, { status: 400 }) throw error }}

Et quand le colis part, votre boutique envoie le modèle d'expédition :

Node.js

await nodium.messages.send({ channelId: process.env.NODIUM_CHANNEL_ID, to: '+33612345678', type: 'template', templateName: 'order_shipped', templateLanguage: 'fr', variables: { '1': 'Léa', '2': '1042', '3': 'https://exemple.com/suivi/1042' }, idempotencyKey: 'order-1042-shipped' // envoyé deux fois par erreur, il ne part qu'une fois})

La clé d'idempotence est le détail qui sauve. Si votre boutique rejoue l'événement « commande expédiée », Léa ne reçoit pas deux messages. Et si votre serveur était éteint, le journal d'événements (GET /v1/events) vous rend tout ce que vous avez manqué, depuis votre dernier curseur.

Les 6 pièges qui coûtent cher

  • Écrire à une liste importée. Sans consentement, c'est contraire à la politique de Meta, et vos clients signaleront le numéro.
  • Rater la fenêtre. Un texte libre envoyé hors des 24 heures est refusé. Votre code doit envoyer un modèle à la place.
  • Oublier que les réponses se paient. Au-delà de 1 000 réponses par numéro et par mois, Meta facture chaque réponse. Sans moyen de paiement chez Meta, elles sont refusées.
  • Choisir la mauvaise catégorie de modèle. Un message promotionnel déguisé en « utilité » peut être reclassé par Meta. Gardez l'utilité pour ce qui concerne une commande.
  • Envoyer deux fois. Les webhooks peuvent arriver deux fois. Sans clé d'idempotence, le client reçoit deux fois le même message.
  • Mal écrire les numéros. « 06 12 34 56 78 » dans la boutique et « 33612345678 » dans WhatsApp sont le même client. Enregistrez toujours le format international, sinon votre CRM crée deux contacts.

Et l'IA dans tout ça ?

Les CRM promettent tous un assistant intelligent. Il peut être utile pour résumer une conversation ou proposer une réponse. Mais ce qui part chez Léa doit rester une décision de votre logiciel, ou de votre équipe.

C'est notre choix chez Nodium : nous transportons les messages, nous ne les lisons pas et nous ne répondons jamais à votre place. Si vous voulez un agent, branchez le vôtre, par exemple avec notre modèle n8n.

Par où commencer cette semaine

  • Ajoutez une case « recevoir le suivi sur WhatsApp » au paiement, et enregistrez sa date.
  • Enregistrez les numéros au format international (+33…).
  • Écrivez deux modèles « utilité » : confirmation et expédition. Faites-les approuver par Meta.
  • Branchez un webhook qui range chaque message reçu sur la fiche du contact.
  • Testez le STOP de bout en bout avant votre première campagne.

Questions fréquentes

Faut-il changer de CRM pour utiliser WhatsApp ?

Non. Votre CRM garde les contacts et les commandes. L'API WhatsApp lui apporte les messages par webhook, et votre code envoie les réponses.

Combien coûte un message WhatsApp envoyé depuis un CRM ?

Les modèles (utilité, marketing, authentification) sont facturés par Meta, par message livré, selon le pays du destinataire. Les réponses en texte libre sont gratuites jusqu'à 1 000 par numéro et par mois. Les tarifs sont sur la page de prix de Meta.

Peut-on garder l'application WhatsApp Business sur le téléphone ?

Oui, avec la coexistence : le même numéro reste dans l'application et passe aussi par l'API. Ce que le téléphone envoie arrive dans votre logiciel comme un événement.

Sources

Essayez avec votre propre numéro.

Build est gratuit : 3 000 messages par mois, sans carte.

Parlez à l'équipe Nodium

Dites-nous ce que vous branchez. Nous revenons vers vous sous un jour ouvré, avec un tarif adapté à vos numéros WhatsApp et à votre volume.