Envoyer des Messages WhatsApp via l'API WhatChimp — Messages Texte vs Messages Modèle
L'erreur API la plus courante expliquée : quand utiliser les messages texte vs les messages modèle, comment fonctionne la fenêtre de 24 heures, et comment envoyer des messages modèle avec des variables.
Updated 5 February 2026
L'API WhatChimp vous permet d'envoyer deux types de messages WhatsApp : messages texte (messages de session) et messages modèle. Utiliser le mauvais type est la raison la plus courante pour laquelle les messages API échouent — ce guide explique la différence.
L'Erreur #1 : Envoyer des Notifications comme Messages Texte
La plupart des développeurs commencent avec l'endpoint Send Message, le font fonctionner en test, puis essaient de l'utiliser pour envoyer des notifications ou des suivis. Cela échouera.
WhatsApp impose une fenêtre de session de 24 heures. Vous ne pouvez envoyer des messages texte que dans les 24 heures suivant le dernier message du client. Après cela, l'API renvoie une erreur.
Si vous souhaitez envoyer des notifications, des rappels, des mises à jour de commande ou des OTP — vous devez utiliser un message modèle.
Messages Texte vs Messages Modèle
| Message Texte (Session) | Message Modèle | |
|---|---|---|
| Quand pouvez-vous l'envoyer ? | Seulement dans les 24 heures suivant le dernier message du client | À tout moment — aucune restriction de temps |
| Contenu | N'importe quel texte que vous voulez | Doit utiliser un modèle pré-approuvé |
| Cas d'usage | Répondre aux demandes des clients | Notifications, rappels, mises à jour, OTP |
| Approbation nécessaire ? | Non | Oui — les modèles doivent être approuvés par Meta |
| API endpoint | POST /api/v1/whatsapp/send | POST /api/v1/whatsapp/send (même endpoint, paramètres différents) |
| Coût | Partie de conversation initiée par le client | Conversation initiée par l'entreprise (niveau de tarification différent) |
Guide de Décision Rapide
Devez-vous envoyer un message ?
│
├── Le client discute-t-il actuellement avec vous (dans les 24 heures) ?
│ ├── OUI → Utilisez Message Texte (message de session)
│ └── NON → Utilisez Message Modèle
│
├── Envoyez-vous une notification, un rappel ou une mise à jour ?
│ └── Utilisez toujours Message Modèle
│
├── Envoyez-vous un OTP ou un code de vérification ?
│ └── Utilisez Message Modèle (type Authentication)
│
└── Vous n'êtes pas sûr ?
└── Utilisez Message Modèle (ça fonctionne toujours)Guides Détaillés
Video: https://www.youtube.com/watch?v=czd3S5cBHvY
Chaque type de message a son propre guide détaillé avec référence API complète, exemples de code et captures d'écran :
- Envoyer des Messages Texte de 24 Heures via l'API WhatChimp — Comment fonctionne la fenêtre de session, paramètres API, exemples curl et gestion des erreurs
- Envoyer des Messages Modèle via l'API WhatChimp — Comment créer des modèles, utiliser le Template Message Generator, envoyer avec des variables et résoudre les erreurs
Articles Connexes
- Démarrer avec l'API Developer de WhatChimp — Configuration API, authentification et démarrage rapide
- Créer un Message Template WhatsApp dans WhatChimp — Guide de création de modèle étape par étape
- WhatChimp Messaging API — Référence complète de l'API de messagerie (tous les endpoints)