# 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.

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 CRM | Application WhatsApp Business | API WhatsApp (officielle, de Meta) |
| --- | --- | --- |
| Recevoir chaque message dans votre logiciel | Non | Oui, par webhook |
| Envoyer depuis votre logiciel | Non | Oui, par API |
| Plusieurs personnes sur le même numéro | Limité | Autant que votre logiciel en gère |
| Messages automatiques (confirmation, livraison) | Non | Oui, par modèles approuvés par Meta |
| Savoir si le message a été livré et lu | À l'œil, sur le téléphone | Oui, 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](https://nodium.io/fr/guides/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.

| # | Moment | Qui écrit | Type de message | Payant chez Meta ? | Ce que votre CRM enregistre |
| --- | --- | --- | --- | --- | --- |
| 1 | Léa coche « recevoir le suivi sur WhatsApp » au paiement | — | — | — | Le consentement, sa date, sa source |
| 2 | Commande payée | Vous | Modèle « utilité » : confirmation | Oui | Message lié à la commande n° 1042 |
| 3 | Colis expédié, deux jours plus tard | Vous | Modèle « utilité » : expédition et lien de suivi | Oui | Statut livré, puis lu |
| 4 | « Je peux changer l'adresse ? » | Léa | Message reçu | Non | La fenêtre de 24 heures s'ouvre |
| 5 | « Oui, voici le lien pour la modifier » | Votre équipe | Texte libre | Non, jusqu'à 1 000 réponses par numéro et par mois | Réponse liée à la commande |
| 6 | Colis livré | Vous | Texte libre, la fenêtre est encore ouverte | Non, dans la limite des 1 000 | Statut de la commande |
| 7 | Dix jours plus tard : « Comment trouvez-vous vos baskets ? » | Vous | Modèle « marketing » | Oui | Réponse, ou silence |
| 8 | Léa répond STOP | Léa | Message reçu | Non | Consentement 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](https://nodium.io/fr/guides/fenetre-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](https://nodium.io/fr/guides/reponses-whatsapp-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.

| Information | Exemple pour Léa | D'où elle vient | Pourquoi elle compte |
| --- | --- | --- | --- |
| Le contact | Léa, +33 6 12 34 56 78 | Votre boutique, puis WhatsApp | Le numéro au format international est la clé qui relie les deux |
| La commande | n° 1042, expédiée | Votre boutique ou votre ERP | Elle reste la source de vérité du statut |
| La conversation | 6 messages, dernier hier à 18 h | Les événements WhatsApp | Votre équipe voit l'historique sans demander |
| Le consentement | Oui depuis le 3 novembre, retiré le 21 | Le paiement, puis le STOP | Il décide qui peut recevoir un modèle marketing |
| La prochaine action | Rembourser la taille 38 | Votre équipe | Elle 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 :

```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 :

```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](https://github.com/Nodium-io).

## 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

- [Meta — WhatsApp Business Messaging Policy](https://business.whatsapp.com/policy)
- [Meta — WhatsApp Business Platform pricing](https://developers.facebook.com/docs/whatsapp/pricing)

Mis à jour le 2026-11-22 · https://nodium.io/fr/guides/crm-api-whatsapp
