Erreurs SMS et messageries

Cette page répertorie les erreurs qu’un envoi SMS ou de messagerie peut afficher dans l’onglet Erreurs de Statistiques du message, et ce qu’il faut faire pour chacune. Les erreurs que toutes les plateformes peuvent afficher, comme Phone Number Not Found ou Skip Push, sont décrites dans Comment lire l’onglet Erreurs.

Comment les erreurs SMS et de messagerie apparaissent dans l’onglet Erreurs

L’onglet Erreurs regroupe les envois échoués par plateforme. Chaque ligne affiche le nom d’une erreur avec son code entre parenthèses, par exemple Invalid To Phone Number (1001).

Rechercher une erreur

Recherchez une erreur à l’aide de son nom et de son code ensemble. Un même numéro peut correspondre à des erreurs différentes, car Pushwoosh vérifie un message à plusieurs étapes. Par exemple, Skip Push (1011) et Send Quota Exceeded (1011) sont deux erreurs différentes.

La plupart des erreurs proviennent de votre fournisseur SMS ou de la messagerie. Pushwoosh les classe dans la catégorie Erreur du fournisseur, quelle que soit leur cause. Consultez Catégories d’erreurs pour connaître la signification de chaque catégorie.

Ce que l’onglet Erreurs n’affiche pas

L’onglet ne répertorie que les erreurs renvoyées au moment où Pushwoosh envoie le message. Les cas suivants ne sont pas répertoriés :

Échecs survenus après l’acceptation du message par le fournisseur ou la messagerie. Par exemple, un échec chez l’opérateur mobile. L’envoi est compté comme accepté.
Certains échecs temporaires. Ils incluent la plupart des erreurs réseau. Pushwoosh fait de nouvelles tentatives. Sur WhatsApp, une erreur réseau ne fait pas l’objet d’une nouvelle tentative et s’affiche comme Internal Service Error (10006).
Abonnés ignorés sans consentement marketing. Pushwoosh les exclut de l’audience avant l’envoi : ce ne sont donc pas des erreurs.

Erreurs SMS

Ces erreurs proviennent de votre fournisseur SMS ou des paramètres SMS de votre projet. Les erreurs que vous voyez dépendent du fournisseur. Par exemple, Twilio signale un désabonnement, un numéro invalide et un expéditeur non autorisé pour le pays sous la forme Bad Request (1006), et non sous la forme des erreurs plus précises ci-dessous.

Problèmes de numéro de téléphone

Ces erreurs sont causées par le numéro de téléphone du destinataire, et non par la configuration de votre fournisseur.

Erreur	Description	Que faire
Invalid To Phone Number (1001)	Le numéro de téléphone est illisible ou n’a pas d’indicatif de pays. Pushwoosh désabonne le numéro des SMS.	Enregistrez les numéros de téléphone au format international avec l’indicatif de pays, par exemple `+14155550100`, puis enregistrez à nouveau le numéro.
Unsubscribed Recipient (1002)	La personne s’est désabonnée de vos messages auprès de son opérateur mobile, ou le numéro figure sur la liste de blocage de votre fournisseur. Après un désabonnement auprès de l’opérateur, Pushwoosh désabonne le numéro des SMS et enregistre le désabonnement.	N’envoyez pas de messages marketing à ce numéro. Consultez Désabonnements que Pushwoosh enregistre automatiquement. Si la personne ne s’est pas désabonnée, vérifiez la liste de blocage dans le tableau de bord de votre fournisseur.

Compte et configuration du fournisseur

Ces erreurs signifient que votre fournisseur SMS a rejeté la requête à cause du compte, des identifiants, de l’expéditeur ou du message.

Erreur	Description	Que faire
Bad Request (1006)	Le fournisseur a rejeté la requête. Sur Twilio, cela couvre aussi une personne qui s’est désabonnée auprès de son opérateur mobile, un numéro invalide ou non mobile, et un expéditeur non autorisé pour le pays du destinataire.	Vérifiez le numéro du destinataire et l’expéditeur pour ce pays dans le tableau de bord de votre fournisseur. Si la personne s’est désabonnée, cessez de lui envoyer des messages.
No Permission For Region (1003)	Le pays du destinataire n’est pas autorisé pour ce projet ou ce fournisseur, ou les identifiants du fournisseur ou l’expéditeur ne sont pas configurés dans la configuration SMS.	Vérifiez les identifiants du fournisseur et le numéro d’expéditeur dans la configuration SMS. S’ils sont corrects, contactez le Support Pushwoosh pour vérifier vers quels pays le projet peut envoyer des SMS.
Invalid To From Combination (1012)	Votre ID d’expéditeur n’est pas autorisé à envoyer vers le pays du destinataire, ou aucun ID d’expéditeur n’est défini dans la configuration SMS.	Vérifiez dans le tableau de bord de votre fournisseur quel expéditeur utiliser pour ce pays.
Permission Denied (1015)	Le fournisseur n’a pas accepté vos identifiants.	Comparez les identifiants de la configuration SMS avec ceux du tableau de bord de votre fournisseur.
Forbidden (1007)	Le fournisseur a refusé la requête ou la connexion, par exemple à cause d’identifiants erronés, ou la connexion SMS n’est pas configurée.	Comparez les identifiants de la configuration SMS avec ceux du tableau de bord de votre fournisseur.
Account Is Inactive (1014)	Votre compte auprès du fournisseur SMS est suspendu.	Rétablissez le compte auprès de votre fournisseur.
Not Found (1008)	Le fournisseur n’a pas trouvé le compte ou l’expéditeur indiqué dans la requête.	Vérifiez les paramètres du compte et de l’expéditeur dans le tableau de bord de votre fournisseur.
Invalid MMS Attachment (1016)	Le fournisseur a rejeté le fichier joint à cause de son format ou de sa taille.	Joignez un fichier plus petit dans un format pris en charge par votre fournisseur.
Internal Service Error (10006)	Pour les SMS, cette erreur peut aussi signifier que l’envoi de SMS n’est pas activé pour votre compte.	Contactez le Support Pushwoosh.

Limites d’envoi

Cette erreur signifie que l’envoi a atteint une limite sur le nombre de SMS, et non qu’il y a un problème avec le message.

Erreur	Description	Que faire
Send Quota Exceeded (1011)	Le projet a atteint sa limite quotidienne de SMS, ou le fournisseur a limité l’envoi. Pushwoosh définit la limite quotidienne de SMS lorsque vous configurez les SMS pour le projet.	Contactez le Support Pushwoosh au sujet de la limite quotidienne de SMS. Répartissez les envois volumineux sur plusieurs jours.

Défaillances du fournisseur

Ces erreurs signifient que le fournisseur n’a pas réussi à traiter le message ou a renvoyé une réponse que Pushwoosh n’a pas pu lire.

Erreur	Description	Que faire
Unknown Error (1000), Converting Error (1004), Provider Unknown Error (1009), Provider Internal Error (1010)	Le fournisseur a renvoyé une erreur que Pushwoosh ne reconnaît pas, ou a échoué de son côté. Converting Error peut aussi signifier que les paramètres du fournisseur dans la configuration SMS sont incomplets.	Comparez le nombre de ces erreurs avec celui d’envois antérieurs de taille similaire. S’il augmente ou si elles se répètent à chaque envoi, contactez le Support Pushwoosh.

Erreurs Viber

En plus des erreurs que toutes les plateformes peuvent afficher, les envois Viber peuvent afficher ces deux erreurs. Pushwoosh envoie les messages Viber via MStat, en utilisant les identifiants MStat de votre configuration SMS.

Si un abonné n’a aucun contact Viber dans le projet, l’envoi échoue avec Push Token Not Found (1007), l’une des erreurs que toutes les plateformes peuvent afficher.

Erreur	Description	Que faire
No Device For Push Token (10002)	Le contact Viber de l’abonné est enregistré sans numéro de téléphone.	Enregistrez à nouveau le numéro de l’abonné pour Viber. Consultez Enregistrer des contacts Viber.
Internal Service Error (10006)	Les identifiants MStat ou l’ID de compte sont manquants, le contenu du message est invalide, ou MStat a rejeté le message. L’onglet Erreurs n’indique pas laquelle de ces causes s’applique.	Vérifiez que MStat est configuré avec des identifiants valides dans la configuration SMS, et vérifiez le contenu du message. Si les deux sont corrects, contactez le Support Pushwoosh.

Erreurs WhatsApp

La plupart des erreurs WhatsApp proviennent de Meta. Meta accepte souvent un message dans un premier temps et le rejette plus tard, par exemple lorsque le numéro n’est pas sur WhatsApp ou que Meta limite les messages marketing envoyés à cette personne. Un tel envoi est compté comme Acceptés par la passerelle dans l’entonnoir, ne reçoit pas de confirmation de livraison et n’est pas répertorié dans l’onglet Erreurs.

Messages hors de la fenêtre de 24 heures

Un message libre, c’est-à-dire envoyé sans modèle approuvé, n’atteint une personne que dans les 24 heures suivant son dernier message à votre numéro professionnel. En dehors de cette fenêtre, l’envoi échoue avec l’une de ces erreurs.

Erreur	Description	Que faire
Re Engagement Message (1030)	La personne n’a pas écrit à votre numéro professionnel au cours des dernières 24 heures.	Envoyez un modèle approuvé au lieu d’un texte libre.
Processing Error (1035)	Pushwoosh a ignoré un message libre parce que la fenêtre de 24 heures était déjà fermée.	Envoyez un modèle approuvé au lieu d’un texte libre.

Erreurs liées au destinataire

Ces erreurs sont causées par le destinataire ou par la fréquence à laquelle vous lui envoyez des messages.

Erreur	Description	Que faire
Recipient Invalid Phone Number (1011)	Le numéro du destinataire est identique à votre numéro professionnel.	Retirez votre propre numéro professionnel de l’audience.
Accounts Pair Rate Limit Hit (1059)	Vous avez envoyé trop de messages à la même personne en peu de temps.	Espacez les messages envoyés à la même personne.

Erreurs de modèle et de contenu

Ces erreurs signifient que Meta a rejeté le modèle ou le contenu du message.

Erreur	Description	Que faire
Template Does Not Exist (1037)	Le modèle n’existe pas dans la langue sélectionnée, ou il n’est pas encore approuvé.	Vérifiez le modèle et ses langues dans WhatsApp Manager, puis choisissez un modèle approuvé dans le preset.
Template Param Count Mismatch (1036)	Le nombre de valeurs de variables ne correspond pas au nombre de variables du modèle.	Renseignez toutes les variables du modèle dans le preset.
Template Parameter Format Mismatch (1040)	Une valeur de variable a un format incorrect.	Comparez les valeurs des variables avec le modèle dans WhatsApp Manager.
Template Hydrated Text Too Long (1038)	Le texte est trop long une fois les variables renseignées.	Raccourcissez les valeurs des variables ou le texte du modèle.
Template Format Character Policy Violated (1039)	Le contenu du modèle enfreint une règle de WhatsApp.	Modifiez le modèle dans WhatsApp Manager et soumettez-le à nouveau pour approbation.
Template Is Paused (1041)	Meta a mis le modèle en pause en raison de sa faible qualité. À ne pas confondre avec Silent Hours (1041), voir Comment lire l’onglet Errors.	Utilisez un autre modèle approuvé, ou améliorez celui-ci dans WhatsApp Manager.
Template Is Disabled (1042)	Meta a mis le modèle en pause trop de fois et l’a désactivé définitivement.	Créez un nouveau modèle et utilisez-le dans le preset.
Request Invalid Parameter (1010), Request Missing Required Parameter (1009), Parameter Value Is Not Valid (1020), Generic User Error (1053)	Une valeur du message est manquante ou invalide.	Vérifiez le preset : modèle, variables, boutons et pièce jointe.
Unsupported Message Type (1032)	WhatsApp ne prend pas en charge ce type de message.	Modifiez le type de contenu dans le preset.
Media Upload Error (1034)	Meta n’a pas pu charger le média joint.	Utilisez un fichier accessible via une URL `https` publique, dans un format pris en charge par WhatsApp.

Erreurs de compte et de qualité

Ces erreurs signifient que Meta a restreint votre compte WhatsApp Business ou votre numéro professionnel. Résolvez-les dans WhatsApp Manager, comme décrit dans Comment corriger un expéditeur bloqué ou limité.

Erreur	Description	Que faire
Temporarily Blocked For Policies Violations (1005)	Meta a bloqué le compte pour violation de ses règles.	Vérifiez le statut du compte dans WhatsApp Manager.
Account Has Been Locked (1017)	Meta a verrouillé le compte pour une violation de ses règles, ou n’a pas pu vérifier des données de la requête.	Vérifiez le statut du compte dans WhatsApp Manager.
Account Is Restricted From Messaging In This Country (1016)	Le compte ne peut pas envoyer de messages aux utilisateurs de ce pays.	Vérifiez les restrictions du compte dans WhatsApp Manager.
Spam Rate Limit Hit (1008)	Meta limite le nombre de messages que ce numéro peut envoyer, car de nombreux messages précédents ont été bloqués ou signalés comme spam.	Examinez le contenu et l’audience des messages récents, puis réduisez le volume.
Business Eligibility Payment Issue (1028)	Il y a un problème avec le moyen de paiement du compte.	Vérifiez le moyen de paiement dans WhatsApp Manager.
Provided Number Needs Display Name Approval (1027)	Le nom d’affichage de votre numéro professionnel n’est pas encore approuvé.	Attendez l’approbation ou modifiez le nom d’affichage dans WhatsApp Manager.
Business Phone Number Is Deleted (1024)	Votre numéro professionnel a été supprimé.	Connectez un numéro actif dans la configuration WhatsApp.
Account In Maintenance Mode (1035)	Le compte est en mode maintenance. Il s’agit d’une erreur différente de Processing Error (1035) dans Messages hors de la fenêtre de 24 heures.	Réessayez plus tard.

Erreurs de configuration et d’autorisation

Ces erreurs signifient que la connexion entre Pushwoosh et votre compte WhatsApp Business ne fonctionne pas. Reconnectez votre compte WhatsApp Business dans Settings > Configure Platforms > WhatsApp, comme décrit dans Configuration WhatsApp.

Erreur	Description	Que faire
Access Token Expired (1003)	Le jeton d’accès de la connexion a expiré.	Reconnectez le compte.
Authentication Failed (1002), Permission Denied (1013), API Permission (1014), API Method (1015), Access Denied (1023)	Meta n’a pas accepté la connexion, ou une autorisation manque.	Reconnectez le compte et accordez toutes les autorisations demandées.
Incorrect Certificate (1029)	Le numéro professionnel n’est pas enregistré correctement.	Vérifiez le numéro professionnel dans WhatsApp Manager, puis reconnectez le compte.
Internal Service Error (10006)	Le numéro professionnel ou le jeton d’accès est absent de la configuration WhatsApp, ou Pushwoosh n’a pas pu joindre Meta ou lire sa réponse.	Vérifiez la configuration WhatsApp et reconnectez le compte si nécessaire. Si l’erreur se répète, contactez le Support Pushwoosh.

Limites de débit

Ces erreurs signifient que vous avez envoyé plus rapidement que Meta ne l’autorise pour votre application ou votre compte.

Erreur	Description	Que faire
Rate Limit Hit (1058)	Le débit de messages de votre numéro a été atteint.	Réduisez la vitesse d’envoi ou divisez l’envoi en lots plus petits.
API Too Many Calls (1056), Rate Limit Issues (1057)	L’application ou le compte a atteint sa limite de requêtes.	Réduisez la vitesse d’envoi ou divisez l’envoi en lots plus petits.

Erreurs temporaires de Meta

Ces erreurs signifient que Meta a échoué de son côté ou a renvoyé une réponse que Pushwoosh ne reconnaît pas.

Erreur	Description	Que faire
API Unknown (1018), API Service (1019), Something Went Wrong (1022), Service Unavailable (1025), Server Temporary Unavailable (1046)	Une erreur temporaire du côté de Meta.	Renvoyez le message plus tard. Si l’erreur se répète, contactez le Support Pushwoosh en indiquant la date du message et le Code du message.
Unknown Error (1000), Cannot Process Sending (1012)	Meta a renvoyé une erreur que Pushwoosh ne reconnaît pas, ou une réponse que Pushwoosh n’a pas pu lire.	Si l’erreur se répète, contactez le Support Pushwoosh en indiquant la date du message et le Code du message.

Erreurs Telegram

Les envois Telegram affichent deux erreurs qui leur sont propres.

Erreur	Description	Que faire
Chat Unavailable (410007)	La personne a bloqué ou supprimé le bot, le chat est introuvable, ou le compte Telegram a été désactivé. Pushwoosh désabonne la personne de Telegram.	Rien à corriger. La personne ne peut pas recevoir de messages du bot.
Invalid Authentication Info (401002)	Le jeton du bot est manquant ou invalide. Cette erreur apparaît aussi lorsque l’ID de chat Telegram d’un abonné n’est pas valide (Pushwoosh désabonne alors cet abonné), ou lorsque Pushwoosh n’a pas pu joindre Telegram pour vérifier le jeton.	Vérifiez le jeton du bot dans la configuration Telegram.

Erreurs Facebook Messenger

Ces erreurs proviennent de Meta lorsque Pushwoosh envoie un message depuis votre page Facebook.

Erreur	Description	Que faire
Outside Allowed Window (403004)	La personne n’a pas écrit à votre page au cours des dernières 24 heures, et le message n’a pas de balise de message. Pushwoosh n’exclut pas ces personnes de l’audience, donc chacun de ces envois échoue avec cette erreur.	En dehors de la fenêtre de 24 heures, envoyez avec une balise de message. Consultez Utiliser une balise de message en dehors de la fenêtre de 24 heures.
Recipient Unavailable (410005)	La personne ne peut pas recevoir de messages de votre page. Pushwoosh désabonne la personne de Facebook Messenger.	Rien à corriger.
Invalid Authentication Info (401002)	Le Page ID ou le Page Access Token est manquant, ou Meta n’a pas accepté le jeton.	Saisissez un Page ID et un Page Access Token valides dans la configuration Facebook Messenger.
No Permission (403003)	Votre Meta App ne dispose pas de l’autorisation nécessaire à cet envoi.	Vérifiez les autorisations Messenger de votre Meta App dans le tableau de bord Meta App.
Invalid Request Parameter (400001)	Le message est vide ou contient une valeur invalide.	Vérifiez le contenu du message.
Internal Server Error (5009999)	Meta a renvoyé une erreur que Pushwoosh ne reconnaît pas.	Si l’erreur se répète, contactez le Support Pushwoosh en indiquant la date du message et le Code du message.

Erreurs Kakao

La plupart des erreurs Kakao proviennent du service de messagerie KakaoTalk. Pushwoosh affiche chacune sous son propre nom ; elles sont regroupées ci-dessous selon ce qu’il faut vérifier.

Erreur	Description	Que faire
Missing User Code (4001200), Missing Secret Key (4001201)	Les identifiants KakaoTalk ne sont pas renseignés.	Saisissez le USER CODE et la SECRET KEY dans la configuration Kakao.
Invalid Authentication Info (401002), Invalid Token (401005), Token Expired (401006), Missing Authorization Header (401004), No Permission (403003), Unregistered Account (4001100)	Le service n’a pas accepté le jeton d’accès ou votre compte.	Vérifiez le USER CODE et la SECRET KEY dans la configuration Kakao. S’ils sont corrects, contactez le Support Pushwoosh.
Unauthorized IP Address (4031101)	Le service n’accepte pas les requêtes provenant de l’adresse depuis laquelle Pushwoosh envoie.	Contactez le Support Pushwoosh.
Insufficient Balance (4001102)	Votre compte de messagerie KakaoTalk n’a plus de solde.	Rechargez le solde de votre compte de messagerie KakaoTalk.
Unit Price Not Found (5001103)	Le service n’a pas de prix unitaire pour ce message sur votre compte.	Contactez le Support Pushwoosh.
Unauthorized Sender Key (4001104), Missing Sender Key (4001301), Missing Sender Number (4001208), Invalid Sender Number Not Registered (400667), Invalid Sender Number Policy Violation (400668)	Le profil d’expéditeur ou le numéro d’expéditeur n’est pas enregistré ou n’est pas autorisé.	Vérifiez le profil d’expéditeur et le numéro d’expéditeur dans votre compte de messagerie KakaoTalk.
Template Code Not Found (4001105), Missing Template Code (4001303)	Le code du modèle dans le message est manquant ou ne correspond à aucun modèle enregistré.	Vérifiez que le message utilise un modèle Kakao approuvé.
Recipient Opted Out (400090)	La personne s’est désabonnée de vos messages KakaoTalk.	N’envoyez pas de messages marketing à cette personne.
Missing Recipient Number (4001202), Invalid Recipient Number Format (4001204), Recipient Number Too Long (4001203), Missing Country Code (4001210), Invalid Country Code Format (4001212)	Le numéro de téléphone du destinataire est manquant ou a un format incorrect.	Enregistrez les numéros de téléphone au format international avec l’indicatif de pays, puis enregistrez à nouveau le numéro.
Missing Message Body (4001206), Message Body Too Long (4001207), Title Too Long (4001205), Header Too Long (4001306), Invalid Request Parameter (400001) et les autres erreurs nommées … Too Long ou Invalid …	Une partie du message est manquante, trop longue ou contient une valeur invalide.	Corrigez le champ indiqué par l’erreur dans le preset KakaoTalk ou dans le message.
Internal Server Error (5009999)	Le service a échoué de son côté ou a renvoyé une erreur que Pushwoosh ne reconnaît pas.	Si l’erreur se répète, contactez le Support Pushwoosh en indiquant la date du message et le Code du message.

Erreurs LINE

La plupart des erreurs LINE correspondent au statut HTTP renvoyé par la LINE Messaging API.

Erreur	Description	Que faire
Unable To Get Channel ID (1011), Unable To Get Channel Secret (1012)	Le Channel ID ou le Channel secret n’est pas renseigné.	Saisissez les deux dans la configuration LINE.
Authentication Failed (1003)	LINE n’a pas accepté le jeton d’accès du canal, par exemple parce que le channel secret a été modifié.	Comparez le Channel ID et le Channel secret avec ceux de la LINE Developers Console.
Duplicate Post (1006)	LINE a refusé la requête, soit comme doublon, soit parce que le canal n’est pas autorisé à utiliser cette partie de la Messaging API.	Vérifiez l’offre et les autorisations de votre LINE Official Account. Si elles sont correctes, contactez le Support Pushwoosh.
Profile Not Found (1005), Access Not Available (1007)	Le destinataire ou la ressource demandée n’est plus disponible sur LINE.	Rien à corriger pour ce destinataire.
Bad Request (1002)	LINE a rejeté la requête.	Vérifiez le contenu du message et le preset LINE.
Payload Too Large (1008)	Le message dépasse la taille autorisée par LINE.	Réduisez la taille du message ou de ses médias.
Unsupported Media Type (1009)	LINE ne prend pas en charge le type du fichier joint.	Joignez le fichier dans un format pris en charge par LINE.
Too Many Requests (1010)	Le canal a atteint la limite de débit des requêtes LINE ou sa limite mensuelle de messages.	Réduisez la vitesse d’envoi, ou vérifiez la limite de messages de l’offre de votre LINE Official Account.
Internal Server Error (1001), Unknown Error (1000)	LINE a échoué de son côté ou a renvoyé une erreur que Pushwoosh ne reconnaît pas.	Renvoyez le message plus tard. Si l’erreur se répète, contactez le Support Pushwoosh.