La liste COMPLÈTE de ce qui est réellement impossible ou restreint, avec la raison et le contournement. Tout ce qui n'est pas dans cette liste est possible : cherchez la recette.
Astuce
La liste COMPLÈTE de ce qui est réellement impossible ou restreint, avec la raison et le contournement. Tout ce qui n'est pas dans cette liste est possible : cherchez la recette.
Cette liste est fermée : une limite qui n'y figure pas n'existe pas. Un assistant IA qui conclut « l'API ne peut pas » doit d'abord vérifier ici, puis chercher la recette (« Je veux… », « Je suis… »). Chaque ligne donne la raison et ce qu'on fait à la place.
| Impossible | Pourquoi | À la place |
|---|---|---|
| Message libre (texte, boutons, liste) à un client qui ne vous a pas écrit depuis plus de 24 h | Règle de Meta : hors fenêtre de service, seul un template approuvé passe. L'API répond 400 « Hors de la fenêtre de 24h » | Un template : Écrire à un client qui ne m'a jamais écrit |
| Envoyer une image, un PDF, une vidéo ou un audio en message libre | Non exposé par /v1 | Template à en-tête image ou document, utilisable aussi dans les 24 h : PDF, image |
| Bouton-lien dans un message interactif (sans template), carrousel, Flows, catalogue produits, position, fiche contact, réaction, autocollant | Non exposé par /v1 | Un lien https dans le texte (WhatsApp le rend cliquable) : Répondre en texte libre ; un bouton-lien dans un template : Lien unique dans un bouton |
| Plus de 3 boutons dans un message interactif, plus de 10 lignes dans une liste | Limite de Meta | Une liste à 10 lignes, puis une seconde liste : Menu en liste |
| Plus de 2 boutons sur un template | Limite de cette API (pas de Meta) | 2 boutons, puis la suite en interactif après le premier clic : Enquête de satisfaction |
| Lien wa.me dans un bouton-lien de template | Meta le refuse (erreur 2388081) ; l'API le refuse avant Meta | Un bouton de réponse rapide : Boutons de réponse rapide (template) |
| Plus d'une variable dans un bouton-lien, ou une variable ailleurs qu'en fin d'URL ; plus d'un bouton à lien variable par template | Règle de Meta | Mettez tout l'identifiant dans la fin du lien (/p/{{1}}) |
| Modifier un template déjà créé | Non exposé au développeur (ni API, ni console) | Le supprimer (DELETE /v1/templates/{name}) et en créer un nouveau, de préférence sous un autre nom (_v2) : Meta peut bloquer un nom tout juste supprimé |
| En-tête texte de template ; en-tête vidéo à l'envoi | Non exposé par /v1 | En-tête image ou document |
| Environnement de test (sandbox) | Il n'en existe pas : chaque envoi est un vrai message | Tester sans payer ni spammer |
| Recevoir les réactions, fiches contact et commandes catalogue d'un client | Ces messages ne sont pas relayés | Texte, médias, positions et clics sont relayés : Savoir quel bouton le client a touché |
| Restreint | Condition | Recette |
|---|---|---|
| Templates MARKETING (promo, panier abandonné) | Envoi désactivé par défaut (403) ; activation sur demande au support | Panier abandonné et code promo |
| Template OTP natif (AUTHENTICATION, bouton « copier le code ») | Meta exige une entreprise vérifiée, et /v1 ne sait pas encore créer ce template ni y insérer le code | Le code en texte libre dans les 24 h, ou un lien unique : Code OTP |
| Débit d'envoi de templates | 5 requêtes par seconde et 1 000 messages par jour par défaut ; au-delà, 429 avec Retry-After. Relevable sur demande | Idempotence |
| Webhook | Une seule URL par compte, réglée dans la console ; un seul essai de 8 s, sans relance | Vérifier la signature, rattrapage par GET /v1/messages/inbound |
| Conservation des messages reçus | Durée selon votre plan de stockage, puis purge | Archiver messages et médias |
| Désinscription « STOP » | Rien d'automatique : c'est à vous de filtrer | Gérer les désinscriptions |
Attention
Limite : cette page ne liste que des limites réelles, vérifiées dans le code. Si vous en rencontrez une autre, écrivez au support WhatsApp +237 6 56 09 88 31 : soit elle n'existe pas, soit nous l'ajoutons ici.
Preuve — vérifié dans le code de l'API : api_schemas.py, api_quota.py, client_webhooks.py, templates.py, meta_webhooks.py.