Ressources
Limites et quotas
Les valeurs limites de l'API : tailles, pagination, délais, reprises, et limites du plan.
Mis à jour le 12 novembre 2026Voir en Markdown
Requêtes et champs#
| Élément | Limite |
|---|---|
| Texte d'un message | 1 à 4 096 caractères |
| Numéro du destinataire | Format international avec « + », 8 à 15 chiffres |
| Média (image, vidéo, audio, document) | link en https://, ou id Meta ; jamais les deux |
| Nom de template | Minuscules, chiffres et _, jusqu'à 512 caractères |
Idempotency-Key | Jusqu'à 200 caractères |
| Nom de compte, d'entreprise | 2 à 120 caractères |
| Nom d'application, de clé | 2 à 80 caractères |
externalRef | Jusqu'à 120 caractères, unique par environnement |
| Mot de passe | 10 à 200 caractères |
| URL de webhook | https:// public, jusqu'à 2 000 caractères |
Pagination#
| Liste | Taille par défaut | Maximum |
|---|---|---|
| Messages, livraisons de webhooks | 25 | 100 |
| Journal des appels | 50 | 200 |
Envoi#
| Élément | Valeur |
|---|---|
| Tentatives d'envoi en cas de panne passagère | 6, attente croissante |
| Débit par numéro | 50 messages par seconde par défaut (réglé par la plateforme) |
Reprise d'un message resté queued | Après 5 minutes |
Webhooks#
| Élément | Valeur |
|---|---|
| Délai de réponse de votre serveur | 10 secondes |
| Tentatives par livraison | 8 au total, attente doublée (environ une heure) |
| Désactivation automatique d'une destination | Après 15 livraisons définitivement échouées d'affilée |
| Extrait de la réponse conservé | 1 Ko |
| Tolérance de signature conseillée | 5 minutes |
Sessions et clés#
| Élément | Valeur |
|---|---|
| Durée d'une session de console | 30 jours |
| Durée d'une clé API | Jusqu'à révocation |
Plans#
| Starter | Pro | Business | |
|---|---|---|---|
| Prix par mois | 5 000 FCFA | 10 000 FCFA | 30 000 FCFA |
| Numéros inclus dans le prix | 2 | 3 | 5 |
| Chaque numéro supplémentaire, au-delà de ceux inclus | 2 000 FCFA / mois | 1 500 FCFA / mois | 1 200 FCFA / mois |
| Plafond de numéros WhatsApp, en production | 5 | 15 | 100 |
| Messages inclus par mois et par numéro, en production | 1 000 | 10 000 | 35 000 |
| Frais de plateforme au-delà du quota inclus (en plus du tarif de Meta) | 1 FCFA par message | 0,5 FCFA par message | 0,25 FCFA par message |
| Conservation des journaux et de l'historique des livraisons | 7 jours | 30 jours | 90 jours |
| Entreprises connectées (vos clients) | Illimitées | Illimitées | Illimitées |
| Sandbox | Illimité, jamais facturé | idem | idem |
Le numéro est l'unité de prix. Le prix du plan comprend plusieurs numéros (2 en Starter, 3 en Pro, 5 en Business) ; chaque numéro au-delà s'ajoute à ce prix, jusqu'au plafond du palier. Le quota de messages du compte est le quota par numéro multiplié par le nombre de numéros facturés : avec 3 numéros en Starter, 3 × 1 000 = 3 000 messages par mois. Les numéros inclus comptent même s'ils ne sont pas encore tous connectés : en Starter, le quota minimal est 2 × 1 000 = 2 000. Les entreprises (vos clients) ne sont pas limitées : un numéro compte de la même façon quelle que soit l'entreprise à laquelle il est rattaché.
Un nouveau compte a 7 jours d'essai gratuit avec les limites de Starter (voir Usage et facturation). Pendant l'essai, le quota est un plafond, sans frais de dépassement.
Au-delà du quota inclus, l'envoi n'est jamais interrompu : un petit frais de plateforme par message s'applique (1, 0,5 ou 0,25 FCFA selon le plan), sur sa propre ligne. Ce n'est pas le prix du message : Meta facture la livraison séparément, au propriétaire du compte WhatsApp. Un compte qui dépasse paie donc un peu plus, sans voir ses envois refusés. Les prix sont présentés sur la page des tarifs. Une limite atteinte donne 402 plan_limit_reached (nombre de numéros) ou 402 quota_exceeded (envoi, pour un plan avec plafond dur). Un compte sans abonnement reste sur un plan par défaut très limité (une entreprise, un numéro, 100 messages par mois). Un plan Enterprise (numéros illimités, volume et journaux négociés) est proposé sur devis.
Les limites de Meta (paliers de messages par numéro, qualité du numéro, règles de contenu) s'appliquent en plus : elles dépendent de votre compte WhatsApp et sont décidées par Meta.