nvoyez via WhatsApp lorsque le destinataire a donné son consentement pour être contacté sur ce canal et possède un compte WhatsApp actif ; dans tous les autres cas, envoyez par SMS ou basculez vers SMS. Sur l'API Cloud de WhatsApp, un message envoyé à un numéro incapable de le recevoir échoue avec l'erreur 131026, et vous n'en serez informé que via le webhook de statut, et non via la réponse d'envoi. La méthode fiable consiste à enregistrer le consentement du client pour chaque canal lors de l'opt-in, à vérifier ce que vous pouvez légalement faire avant l'envoi, et à laisser un statut WhatsApp en échec déclencher un SMS. BroadNet gère les deux canaux via une seule API Omnicanale avec des règles de basculement explicites.
Points clés à retenir
- L'erreur 131026 signifie que Meta n'a pas pu livrer le message. Meta énumère trois raisons possibles : le numéro n'est pas un numéro WhatsApp, le destinataire n'a pas accepté les dernières conditions, ou le destinataire utilise une ancienne version de WhatsApp.
- Une réponse API réussie signifie uniquement que la requête a été acceptée. La livraison est signalée plus tard par le webhook de statut : envoyé, livré, lu ou échoué, avec un tableau d'erreurs en cas d'échec.
- Posséder un compte WhatsApp ne donne pas la permission de contacter quelqu'un : la politique de Meta exige le numéro de la personne et son consentement pour recevoir vos messages.
- En dehors de la fenêtre de service client de 24 heures, WhatsApp n'accepte que les messages basés sur des modèles (erreur 131047 dans le cas contraire).
- Le type de ligne est le premier filtre : un SMS vers un numéro fixe ou un numéro vert échoue généralement et engendre tout de même des frais de message.
- Le basculement (fallback) fonctionne mieux lorsqu'il est configuré comme une règle dans la plateforme d'envoi : WhatsApp en priorité là où le client l'a choisi, puis SMS en cas de statut en échec ou d'absence de consentement WhatsApp.
Que signifie l'erreur WhatsApp 131026 ?
Dans la référence d'erreur API du Cloud de Meta, 131026 signifie « Impossible de livrer le message ». Meta indique trois raisons possibles : « Le numéro de téléphone du destinataire n'est pas un numéro WhatsApp », le destinataire « n'a pas accepté les nouvelles Conditions de service et la Politique de confidentialité », ou le destinataire « utilise une ancienne version de WhatsApp ». La solution suggérée par Meta est de demander à la personne, « via un mode de communication autre que WhatsApp », de confirmer qu'elle peut envoyer un message à votre numéro professionnel, d'accepter les dernières conditions ou de mettre à jour l'application.
En d'autres termes, 131026 est un signal de routage et non un bug dans votre code. Pour un mot de passe à usage unique, un avis de livraison ou un rappel de rendez-vous, le mode de communication non-WhatsApp Meta auquel il est fait référence est généralement SMS, et il devrait être envoyé automatiquement plutôt qu'après l'ouverture d'un ticket de support.
Pourquoi un ID de message ne signifie-t-il pas que le message a été livré ?
L'envoi est asynchrone. L'API accepte la requête et renvoie un ID de message ; la suite des événements est transmise via votre webhook. Le webhook de statut de message de Meta rapporte ces valeurs :
| Statut | Description de Meta | Action à entreprendre |
|---|---|---|
| envoyé | Le message a été envoyé avec succès depuis les serveurs de Meta | Attendre la distribution ou l'échec |
| distribué | Le message a été distribué avec succès sur l'appareil de l'utilisateur WhatsApp | Aucun basculement nécessaire |
| lu | Le message a été affiché dans une discussion ouverte sur l'appareil de l'utilisateur | Aucun basculement nécessaire |
| échoué | Échec de l'envoi ou de la distribution du message sur l'appareil de l'utilisateur | Lire errors[].code ; basculer vers SMS pour les messages urgents |
Un statut en échec contient un tableau d'erreurs comprenant un code numérique, un titre, un champ de détails et un lien vers la référence de l'erreur. Enregistrez le code avec le message : il vous indique s'il faut réessayer, changer de canal ou corriger un modèle. La même logique s'applique au SMS, où l'accusé de réception (DLR) de l'opérateur joue le rôle du webhook de statut.
Peut-on envoyer un message à quelqu'un sur WhatsApp simplement parce qu'il possède un compte ?
Non. La politique de messagerie de WhatsApp Business stipule que vous « ne pouvez contacter des personnes sur WhatsApp que si : (a) elles vous ont communiqué leur numéro de téléphone mobile ou leur nom d'utilisateur ; et (b) vous avez reçu le consentement de l'utilisateur confirmant qu'il souhaite recevoir des messages ou des appels ultérieurs de votre part. » Vous devez également respecter toute demande de désinscription, sur WhatsApp ou en dehors de celle-ci.
Le choix du canal commence donc dès le consentement, et non au moment de l'envoi. Demandez aux clients quels canaux ils acceptent, enregistrez ce choix avec un horodatage et envoyez des messages uniquement sur les canaux qu'ils ont approuvés. La législation locale ajoute ses propres règles : consultez notre guide sur la loi PDPL des Émirats arabes unis pour le marketing SMS et WhatsApp pour un exemple.
Qu'en est-il de la fenêtre de 24 heures et de l'erreur 131047 ?
Un message WhatsApp en texte libre n'est autorisé que dans les 24 heures suivant le dernier message du client vers vous. Au-delà, l'API Cloud renvoie 131047, « Plus de 24 heures se sont écoulées depuis la dernière réponse du destinataire au numéro de l'expéditeur », et la solution de Meta est d'« envoyer un message modèle au destinataire à la place ». Voir en quoi consiste la fenêtre de 24 heures de WhatsApp.
Pour la conception du repli (fallback), cela signifie deux types d'échecs différents : l'erreur 131047 se résout en passant à un modèle approuvé sur WhatsApp, tandis que l'erreur 131026 se résout en changeant de canal. Traitez-les différemment dans votre logique de nouvelle tentative.
Quel canal devriez-vous utiliser en premier ?
Il n'y a pas de réponse unique par marché ; cela dépend du message et de ce que chaque client a accepté. Un ensemble de règles par destinataire couvre la plupart des cas :
| Situation | Premier canal | Solution de secours |
|---|---|---|
| Le client a donné son consentement pour WhatsApp et vous a déjà contacté | WhatsApp (modèle hors fenêtre de 24 heures) | SMS en cas de statut d'échec |
| Le client a donné son consentement pour WhatsApp, aucun historique pour le moment | Modèle WhatsApp | SMS en cas de statut d'échec ou d'absence de statut dans le délai imparti |
| Aucun consentement WhatsApp enregistré | SMS | Appel vocal pour OTP lorsque disponible |
| Le précédent message WhatsApp a échoué avec 131026 | SMS | Demandez au client de confirmer son WhatsApp lors du prochain contact |
| Le numéro est une ligne fixe ou un numéro gratuit | Pas de SMS : cela échoue généralement | Appel vocal, ou demandez un numéro de mobile |
| Le client a donné son consentement pour RCS, Telegram ou Viber | Le canal sur lequel vous pouvez envoyer | SMS |
Pour une vue par marché (où WhatsApp, RCS ou SMS prédominent), consultez notre guide des canaux SMS vs WhatsApp vs RCS.
Que pouvez-vous vérifier avant l'envoi ?
La première vérification ne concerne pas les applications : il s'agit du type de ligne. Un SMS vers une ligne fixe ou un numéro gratuit échoue généralement tout en restant facturé. MobileValidate, une marque BroadNet en aperçu privé, indique le type de ligne, l'opérateur actuel et, pour un numéro porté, l'opérateur d'origine ; le HLR Lookup de BroadNet ajoute le statut réseau en direct, vous indiquant si la ligne est joignable actuellement.
Pour les clients ayant donné leur consentement pour d'autres canaux, MobileValidate peut également vérifier en temps réel si leur numéro est enregistré sur Telegram, Viber ou Zalo, et lors de traitements par lots sur Signal, iMessage, RCS, LINE ou Botim ; la vérification RCS indique la plateforme du terminal lorsque cela est possible. Sa politique d'utilisation acceptable limite ces vérifications à la prévention de la fraude et à la sélection de canaux pour les contacts ayant donné leur consentement. La liste complète des vérifications est disponible sur mobilevalidate.com. MobileValidate est un service indépendant, non affilié, approuvé ou sponsorisé par les plateformes qu'il vérifie ; leurs noms sont uniquement utilisés pour décrire l'objet d'une vérification.
Pour WhatsApp lui-même, les signaux fiables sont ceux que Meta vous fournit : le consentement propre du client, ses réponses, ainsi que le statut de réception ou d'échec de votre dernier message. Enregistrez le dernier résultat de WhatsApp par client et utilisez-le pour orienter le prochain envoi.
Comment BroadNet gère-t-il le basculement (fallback) ?
BroadNet est un fournisseur officiel de solutions Business Meta et gère WhatsApp Business API, SMS, RCS et la voix sur une seule plateforme. L' API Omnicanal traite une seule requête avec des règles de basculement explicites sur SMS, WhatsApp, RCS et la voix, et renvoie des accusés de réception unifiés, de sorte qu'un statut d'échec WhatsApp devienne un SMS sans code supplémentaire dans votre application.
- Pour les mots de passe à usage unique, l' API d'OTP envoie avec un basculement automatique via SMS, WhatsApp, la voix et Flash Call ; MyOTP.App couvre SMS, WhatsApp et Telegram à partir d'un seul compte.
- Définissez une limite de temps pour les messages urgents : si aucun statut de réception ou d'échec n'arrive à temps, déclenchez le basculement.
- Gardez des modèles approuvés pour chaque type de message dont vous pourriez avoir besoin en dehors de la fenêtre de 24 heures.
- Suspendez un canal pour un client après un code 131026 jusqu'à ce qu'il le confirme à nouveau, afin d'éviter de payer pour des échecs répétés.
Pour découvrir d'autres modèles, consultez notre stratégie de basculement multicanal.
À quoi ressemble une liste de contrôle de routage par destinataire ?
- Lors de l'opt-in, enregistrez les canaux acceptés par le client, ainsi que la date et la formulation approuvée.
- Vérifiez le type de ligne des nouveaux numéros et demandez un numéro de mobile s'il s'agit d'une ligne fixe ou d'un numéro gratuit.
- Choisissez le premier canal en fonction du consentement et de l'historique du client, et non uniquement selon un paramètre par défaut par pays.
- En dehors de la fenêtre de 24 heures, envoyez uniquement des modèles WhatsApp.
- Écoutez les webhooks de statut et les accusés de réception ; traitez les échecs et les délais d'attente comme des déclencheurs de basculement.
- Basculez vers SMS pour les messages urgents et enregistrez le code d'erreur WhatsApp avec le message.
- Analysez les échecs chaque semaine : une augmentation des 131026 dans un segment signifie généralement des numéros obsolètes ou un manque de consentement.
Foire aux questions
Que signifie l'erreur WhatsApp 131026 ?
« Impossible de livrer le message. » Meta énumère trois raisons possibles : le numéro n'est pas un numéro WhatsApp, le destinataire n'a pas accepté les dernières conditions d'utilisation et la politique de confidentialité, ou le destinataire utilise une ancienne version de WhatsApp.
Dois-je renvoyer un message qui a échoué avec 131026 ?
Pas directement sur WhatsApp. Envoyez plutôt les contenus urgents par SMS, et demandez au client via un autre canal de confirmer son numéro WhatsApp.
Une réponse 200 de l'API WhatsApp signifie-t-elle que le message a été livré ?
Non. Cela signifie que la requête a été acceptée. La livraison est signalée par le webhook de statut comme envoyée, livrée, lue ou échouée.
Puis-je envoyer un message à un client sur WhatsApp si je sais qu'il possède un compte ?
Non. La politique de Meta exige que la personne vous ait communiqué son numéro et ait donné son consentement pour recevoir des messages de votre entreprise sur WhatsApp.
Qu'est-ce que l'erreur 131047 ?
Plus de 24 heures se sont écoulées depuis la dernière réponse du client. Envoyez un message basé sur un modèle approuvé au lieu d'un message libre.
Quel canal doit servir de solution de secours pour WhatsApp ?
SMS dans la plupart des cas, car il atteint n'importe quel numéro de mobile. Pour les mots de passe à usage unique, la voix constitue une solution de secours supplémentaire lorsque la plateforme le permet.
Puis-je vérifier un numéro avant l'envoi ?
Oui, dans le respect de votre base juridique. Vérifiez d'abord le type de ligne ; pour les clients ayant donné leur consentement, MobileValidate peut vérifier l'enregistrement sur des applications telles que Telegram, Viber et RCS, et le BroadNet HLR Lookup fournit le statut réseau en temps réel.
Comment BroadNet envoie-t-il la solution de secours SMS ?
L'Omnichannel API applique vos règles de secours en une seule requête, et l'OTP API bascule automatiquement entre SMS, WhatsApp, la voix et Flash Call.
Nous avons consulté toutes les sources ci-dessous le 27 septembre 2026. Consultez nos normes éditoriales.
Sources
- Meta pour les développeurs — codes d'erreur WhatsApp Cloud API (131026, 131047), consultés le 27 septembre 2026 : developers.facebook.com.
- Meta pour les développeurs — référence du webhook de statut des messages, consultée le 27 septembre 2026 : developers.facebook.com.
- Politique de messagerie WhatsApp Business — exigences relatives au consentement (opt-in et opt-out), consultée le 27 septembre 2026 : whatsappbusiness.com/policy.
- MobileValidate — référence des services et recherche d'opérateur, dernière mise à jour le 25 septembre 2026 : mobilevalidate.com/docs/services, mobilevalidate.com/services/carrier-lookup.
- MobileValidate — politique d'utilisation acceptable, consultée le 27 septembre 2026 : mobilevalidate.com/legal/acceptable-use.