Erreur WhatsApp 131048 : envois restreints, que faire ?
Erreur WhatsApp 131048 : Meta restreint les envois du numéro après des blocages ou signalements spam. Comment lire la note de qualité et la faire remonter.
L'erreur WhatsApp 131048 signifie que Meta limite les envois de votre numéro parce que trop de messages précédents ont été bloqués ou signalés comme spam par leurs destinataires. Ce n'est pas un problème de vitesse mais de qualité. Suspendez vos campagnes, vérifiez la note de qualité du numéro, puis reprenez avec des destinataires consentants.
Que signifie l'erreur 131048 ?
« Message failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam. » — Meta, codes d'erreur de la Cloud API
Meta renvoie vers trois choses : le statut de qualité dans le WhatsApp Manager, les limites d'envoi de templates, et la qualité des templates. Le point commun est la qualité des messages telle que Meta la mesure (Meta, Send messages) :
- elle porte sur la manière dont vos messages ont été reçus sur les 7 derniers jours, avec plus de poids pour les plus récents ;
- elle combine les signaux des utilisateurs : blocages, signalements, mises en sourdine, archivages, et les raisons données au moment de bloquer ;
- sur un numéro à fort trafic, elle peut changer en quelques minutes.
La note du numéro, son statut et sa limite d'envoi s'affichent dans le WhatsApp Manager, sous Account tools > Phone numbers.
Quand l'erreur 131048 apparaît-elle ?
- Après une campagne envoyée à une liste froide : contacts importés sans accord, anciens clients qui ne vous attendaient pas.
- Quand un même template accumule les retours négatifs : sa propre note baisse, puis celle du numéro qui l'envoie.
- Quand les messages se succèdent trop souvent vers les mêmes personnes. Meta cite « trop de messages par jour » parmi les pratiques à éviter.
Où la voir dans Genuka WA ?
| Canal | Ce que vous recevez |
|---|---|
Réponse de POST /api/v1/messages | 400, "error": "send_retryable", meta.code: 131048 |
Webhook message_status, si Meta signale l'échec après coup | data.status: "failed", data.errors[0].code: 131048 |
| Campagne | Quand Meta refuse dès l'appel, chaque destinataire touché est tenté jusqu'à trois fois, puis passe failed. Signalé par webhook, il passe failed sans nouvel essai |
GET /api/v1/numbers/{id}/health | qualityRating (GREEN, YELLOW, RED) lu en direct chez Meta, et des alerts quand il a changé |
Webhook phone_number_quality_update | Le changement de qualité ou de palier, poussé par Meta |
GET /api/v1/templates?sync=true | qualityScore.score (GREEN, YELLOW, RED, UNKNOWN) de chaque template créé via Genuka WA, pour trouver celui qui pose problème |
Genuka WA classe 131048 en retryable : la restriction finit par se lever, et un nouvel essai plus
tard peut passer. Notre conseil : meta.retryable: true veut dire ici « plus tard », pas
« maintenant ». Les trois tentatives automatiques d'une campagne s'enchaînent en moins de deux
secondes et échouent en général aussi : ne relancez rien sur ce numéro tant que sa note n'est pas
remontée.
Comment corriger l'erreur 131048 ?
Suspendez les envois marketing de ce numéro. Ne lancez aucune nouvelle campagne tant que la note n'est pas remontée : chaque message mal reçu pèse sur les 7 jours qui viennent.
Lisez la note du numéro avec GET /api/v1/numbers/{id}/health, ou dans le WhatsApp Manager.
Trouvez le template en cause : GET /api/v1/templates?sync=true renvoie
qualityScore.score pour chaque template créé via Genuka WA ; pour ceux créés dans le WhatsApp
Manager, lisez la note là-bas. Arrêtez ceux en RED ou YELLOW, et réécrivez-les avant de les
réutiliser.
Nettoyez votre audience : gardez les contacts qui ont donné leur accord et qui lisent, retirez les autres, et respectez chaque désinscription.
Reprenez progressivement, avec de petits envois vers vos clients les plus engagés, en surveillant la note à chaque étape.
curl https://wa.genuka.com/api/v1/numbers/con_1/health \
-H "Authorization: Bearer $GENUKA_WA_API_KEY"
# {
# "data": { "connectionId": "con_1", "qualityRating": "YELLOW", "messagesPerSecond": 80, ... },
# "alerts": [ { "kind": "quality_dropped", "severity": "warning", "from": "GREEN", "to": "YELLOW", "message": "..." } ]
# }Comment éviter l'erreur 131048 ?
Les recommandations de Meta pour des messages de qualité (Meta, Send messages) :
- respecter la politique de messagerie WhatsApp Business ;
- n'écrire qu'aux personnes qui ont accepté de recevoir vos messages ;
- envoyer des messages personnalisés et utiles ;
- éviter les messages de bienvenue ou de présentation sans objet précis ;
- éviter d'envoyer trop de messages par jour ;
- soigner le contenu et la longueur.
Côté intégration, branchez le webhook phone_number_quality_update et alertez dès qu'un numéro
passe en YELLOW : c'est le moment d'agir, avant le RED.
Quels codes sont liés ?
- 132015 : un template en particulier est mis en pause pour mauvaise qualité.
- 131049 : un destinataire précis a atteint sa limite de messages marketing ; votre numéro n'est pas en cause.
- 130429 : un simple dépassement de débit, sans lien avec la qualité.
FAQ
Combien de temps dure la restriction 131048 ?
Meta ne publie pas de durée. La qualité étant calculée sur les 7 derniers jours, comptez au moins plusieurs jours de messages bien reçus pour la voir remonter.
Puis-je contourner la restriction avec un autre numéro du même compte ?
Ce n'est pas une solution : les limites d'envoi sont calculées au niveau du portefeuille d'entreprise et partagées par tous ses numéros (Meta, Messaging limits), et la cause, des messages mal reçus, vous suivrait.
Les messages de service sont-ils touchés ?
Meta décrit une restriction sur le nombre de messages que le numéro peut envoyer, sans distinguer les catégories. Priorisez les réponses à vos clients et les messages transactionnels pendant la remontée.