Un message ne s’envoie pas
Chaque message sortant correspond à un enregistrement Message Connect. Son Statut indique l’étape atteinte et Message d'erreur explique un éventuel blocage. Trouvez votre symptôme ci-dessous, effectuez les vérifications et corrigez la cause. Les erreurs du package sont citées avec leurs libellés français ; le texte renvoyé par le fournisseur peut rester dans sa langue d’origine.
- Ouvrez le message depuis le fil en cliquant sur l’icône du canal près de l’heure, ou utilisez l’onglet Messages Connect (Lanceur d’application →
Messages Connect) et les vues All Outbound Messages ou Failed Messages. - Repérez Statut, Message d'erreur et Envoyer le message. S’ils sont absents, demandez à l’administrateur de vérifier les autorisations ; consultez Donner accès à votre équipe.
Symptôme 1 — Le statut reste vide et rien ne se passe
Un message dont le Statut est vide n’a pas encore de résultat d’envoi enregistré. Pour les messages créés directement comme enregistrements, la case Envoyer le message déclenche la tentative d’envoi sur le canal choisi. Le Fil Connect envoie directement sans passer par cette case ; vérifiez donc surtout les messages créés manuellement ou par une automatisation.
| Vérification | Constat | Solution |
|---|---|---|
| Envoyer le message est-il décoché ? | Le message a été enregistré sans instruction d’envoi | Cochez Envoyer le message pour déclencher le traitement, tant que le Statut est vide |
| Date/heure de planification est-elle dans le futur ? | Le message attend volontairement sa date planifiée | Attendez le traitement planifié. Consultez Planifier des messages |
| Envoyer le message est coché, mais le statut reste vide | Le traitement d’envoi peut avoir rencontré un problème système | Cherchez un journal à la même heure dans Journaux Connect |
Résultat attendu : après la tentative déclenchée par Envoyer le message, le Statut évolue vers Envoyé pour WhatsApp ou En file d'attente/Accepté pour les SMS, ou vers Échec avec un Message d'erreur. Le délai dépend du traitement.
Symptôme 2 — Statut Échec et erreur commençant par CONNECT_API ->
Une erreur Message d'erreur précédée de CONNECT_API -> signale une exception remontée par le parcours Connect. Elle peut notamment concerner la configuration ou le contenu. Le préfixe seul ne prouve pas qu’aucun appel au fournisseur n’a eu lieu : lisez la cause incluse dans le texte.
| Texte de l’erreur | Cause | Solution |
|---|---|---|
Mauvaise configuration du compte Connect. | Le compte ne peut pas envoyer sur ce canal : Actif est décoché, une donnée requise manque (endpoint, jeton ou numéro pour WhatsApp ; endpoint, numéro d’envoi ou identifiants pour les SMS), ou le canal est absent de Canaux de messagerie | Vérifiez Actif, les champs du canal et Canaux de messagerie sur le compte. Consultez Créer un compte Connect |
3. Requête incorrecte - Veuillez fournir le corps du message ou le modèle de connexion. | Le message ne contient ni corps exploitable ni modèle. Le parcours de création directe décrit dans ces guides utilise un Modèle Connect ; le fil construit le corps à partir de votre saisie | Ajoutez un modèle actif ou envoyez depuis le fil. Consultez Planifier des messages |
4. Mauvaise requête - Fichier introuvable. | Aucun lien de fichier exploitable n’a été trouvé pour cet envoi image ou document sans modèle | Joignez le fichier ou renvoyez le message depuis le fil avec sa pièce jointe. Consultez Envoyer des fichiers, images et vidéos |
4. Ce type de message n'est pas pris en charge pour les SMS. | Le type du message n’est pas Texte, seul format SMS pris en charge | Réglez Type de message sur Texte ou utilisez WhatsApp pour les médias. Consultez Ce que vous pouvez envoyer sur chaque canal |
5. Erreur de modèle : suivie de Les paramètres d'entrée fournis sont invalides. | Le modèle à champs de fusion ne dispose pas d’un enregistrement valide de l’objet attendu | Associez au message un enregistrement de Objet applicable du modèle. Consultez Champs de fusion |
Requête incorrecte - Impossible de générer le corps de la requête. | Le type de message ne permet pas de construire une requête d’envoi valide sur ce canal | Utilisez un type sortant pris en charge. Consultez Ce que vous pouvez envoyer sur chaque canal |
Symptôme 3 — Statut Échec et erreur sans CONNECT_API ->
Sans le préfixe CONNECT_API ->, le texte peut correspondre à une réponse reçue du fournisseur. Pour confirmer la cause du refus, lisez Message d'erreur et les détails de réponse disponibles ; le format du texte seul n’est pas une preuve suffisante du parcours de livraison.
| Indication dans l’erreur du fournisseur | Solution |
|---|---|
| Authentification, autorisation, jeton expiré ou identifiants invalides | Vérifiez les identifiants stockés et mettez-les à jour avec Mettre à jour les jetons API en toute sécurité |
| Numéro de destinataire invalide, non vérifié ou incompatible | Vérifiez le numéro et son format international en chiffres uniquement. Consultez Comment saisir les numéros de téléphone |
| Restriction WhatsApp liée au modèle, à la fenêtre de messagerie ou aux règles du fournisseur | Hors de la fenêtre de service de 24 heures, utilisez un modèle WhatsApp approuvé. Consultez Modèles WhatsApp et approbation Meta |
| Erreur que vous ne comprenez pas | Recherchez le code et le texte exacts dans la documentation officielle Meta ou Twilio, ou contactez le support REDA avec le numéro du message |
Le champ Corps de la réponse conserve la réponse brute du fournisseur lorsqu’elle est disponible. Il peut aider au diagnostic ; vérifiez son contenu avant de le partager.
Symptôme 4 — Salesforce refuse la création du message
Ces erreurs apparaissent à l’enregistrement ou pendant l’envoi lorsque la validation bloque la création du message :
| Texte exact de l’erreur | Cause | Solution |
|---|---|---|
Le destinataire a refusé de recevoir des messages SMS. | La piste ou le contact associé porte le refus de SMS | Respectez ce choix. Après un nouveau consentement du client, consultez Champs de désinscription sur les enregistrements |
Le destinataire a refusé de recevoir des messages WhatsApp. | Même cause pour WhatsApp | Appliquez la même démarche |
La valeur du numéro de téléphone cible doit être fournie pour les messages sortants. | Le numéro du destinataire manque, souvent parce que le champ de téléphone est vide ou mal configuré | Renseignez le numéro selon Comment saisir les numéros de téléphone et contrôlez le champ utilisé avec Présentation de la configuration des objets |
Pour un envoi groupé, le refus d’un destinataire peut bloquer tout le lot à la création. Consultez Suivre un envoi groupé.
Exemple
Un message porte le Statut Échec et le Message d'erreur CONNECT_API -> Mauvaise configuration du compte Connect. -> Line Number: …. Vous vérifiez le compte et découvrez que Actif a été décoché. Après correction, créez un nouveau message depuis le fil, car l’ancien possède déjà un statut. Vérifiez le nouveau Statut Envoyé puis sa progression.
Questions fréquentes
Le parcours d’envoi par enregistrement ne redistribue pas le même message après attribution d’un Statut. Corrigez la cause, puis créez un nouvel envoi depuis le fil ou un nouvel enregistrement avec Envoyer le message coché.
En file d'attente, Envoi, Accepté, Envoyé, Livré, Lu, Échec, Non livré, Réception et Reçu sont expliqués dans Comprendre les statuts de livraison.
Envoyé ne prouve pas la livraison. Si le message n’atteint pas Livré, vérifiez la disponibilité du destinataire et la réception des accusés de livraison. Pour les SMS, consultez le rappel concernant le slash final dans Créer le site public pour les messages entrants.
Utilisez Failed Messages dans Messages Connect, sous réserve de vos droits d’accès, ou créez un rapport. Consultez Rapports et tableaux de bord et Recevoir des notifications d’erreur.
Pour aller plus loin
- Guide de dépannage : toutes les solutions par symptôme.
- Un message entrant n’est pas arrivé : diagnostiquer la réception.
- Mettre à jour les jetons API en toute sécurité : corriger les identifiants avec les actions prévues.