Guide de dépannage : symptôme, cause et solution
Retrouvez les principaux problèmes REDA Connect dans ces tableaux. Utilisez la recherche de la page (Ctrl+F ou Cmd+F), lisez la cause proposée et ouvrez le guide détaillé. Les erreurs en style code reprennent les libellés du package. Si votre cas n’apparaît pas, commencez par Un message ne s’envoie pas ou Un message entrant n’est pas arrivé.
Problèmes d’envoi
| Symptôme | Cause possible | Solution |
|---|---|---|
| Le message reste bloqué avec un statut vide | Le message créé directement n’a pas sa case Envoyer le message cochée | Un message ne s’envoie pas |
Le message échoue avec une erreur commençant par CONNECT_API -> | Le parcours Connect a remonté une exception ; lisez la cause incluse dans le texte, car le préfixe seul ne prouve pas où l’envoi s’est arrêté | Un message ne s’envoie pas |
L’erreur contient Mauvaise configuration du compte Connect. | Compte inactif, champs du canal incomplets ou canal absent de Canaux de messagerie | Un message ne s’envoie pas · Créer un compte Connect |
Erreur : Le destinataire a refusé de recevoir des messages SMS. ou son équivalent WhatsApp | La piste ou le contact porte le refus de messages pour ce canal | Champs de désinscription sur les enregistrements |
Erreur : La valeur du numéro de téléphone cible doit être fournie pour les messages sortants. | Le champ de téléphone est vide ou la configuration de l’objet utilise le mauvais champ | Un message ne s’envoie pas · Comment saisir les numéros de téléphone |
| Tout le lot échoue à cause du refus d’un destinataire | La validation du refus bloque la création indivisible des messages du lot | Suivre un envoi groupé |
| Un message planifié part dès l’enregistrement | Sa Date/heure de planification est passée, ce qui le rend immédiatement admissible à l’envoi | Planifier des messages |
Erreur d’un message planifié ou créé directement : 3. Requête incorrecte - Veuillez fournir le corps du message ou le modèle de connexion. | Le message n’a ni corps exploitable ni modèle ; le parcours de création directe documenté utilise un modèle Connect | Planifier des messages |
| Erreur du fournisseur liée à l’authentification ou à un jeton expiré | Les identifiants stockés sont invalides ou expirés | Mettre à jour les jetons API en toute sécurité |
Le client reçoit {{FirstName}} au lieu de son prénom | La case Champ(s) de fusion du modèle n’est pas cochée et son texte est envoyé tel quel | Champs de fusion |
Un SMS autre que du texte échoue : 4. Ce type de message n'est pas pris en charge pour les SMS. | Le canal SMS prend uniquement en charge le texte dans les deux sens | Ce que vous pouvez envoyer sur chaque canal |
Problèmes de réception
| Symptôme | Cause possible | Solution |
|---|---|---|
| Les messages des clients n’apparaissent pas dans Salesforce | Site public inactif, accès invité manquant aux classes de réception ou webhook incorrect chez Meta ou Twilio | Un message entrant n’est pas arrivé · Créer le site public |
| Les réponses apparaissent uniquement dans le fil global | Le format du numéro ou la configuration de l’objet empêche le rattachement à un enregistrement | Un message entrant n’est pas arrivé · Comment saisir les numéros de téléphone · Comment les messages entrants trouvent leur enregistrement |
Les messages restent Envoyé sans passer à Livré ou Lu | Vérifiez la réception des accusés via le site et les webhooks ; pour les SMS, contrôlez aussi le slash final de l’URL de rappel des statuts | Un message entrant n’est pas arrivé · Créer le site public · Configurer les webhooks Twilio |
| Les messages arrivent sur un autre enregistrement | Une autre correspondance ou règle d’enregistrement associé a été sélectionnée | Comment les messages entrants trouvent leur enregistrement · Envoyer des messages via les enregistrements associés |
| Les numéros inconnus ne créent pas d’enregistrement | Aucune configuration adaptée n’est définie par défaut pour les nouveaux enregistrements | Créer automatiquement des enregistrements à la réception |
Fichiers et médias
| Symptôme | Cause possible | Solution |
|---|---|---|
| Le texte WhatsApp arrive, mais la photo reste absente | Le site distant du serveur de fichiers Meta manque ou le média n’est plus disponible au téléchargement | Les fichiers et images ne sont pas reçus · Le paramètre de site distant nécessaire aux médias WhatsApp |
| Un fichier entrant sans extension ne s’ouvre pas correctement | Son type MIME n’a pas de correspondance d’extension | Les fichiers et images ne sont pas reçus · Catégories d’émojis et types de fichiers entrants |
| Le client envoie une image par SMS et rien d’exploitable n’arrive | REDA Connect ne traite pas les médias SMS entrants ; le message échoue avec Les messages multimédias entrants ne sont actuellement pas pris en charge par Twilio. | Les fichiers et images ne sont pas reçus |
| Qui peut ouvrir un fichier envoyé sur WhatsApp ? | Le fichier est transmis par un lien public accessible à toute personne qui le possède | Envoyer des fichiers, images et vidéos |
Consentement et refus de messages
| Symptôme | Cause possible | Solution |
|---|---|---|
| Le client a répondu STOP, mais reçoit encore des messages | Vérifiez le mot configuré, le canal et le rattachement à une piste ou un contact. Demandez au client d’envoyer le mot complet seul ; une phrase comme « please stop » n’est pas la réponse prévue | Fonctionnement du refus de messages |
| Le refus concerne une conversation liée uniquement à un autre objet | Le traitement automatique met à jour les pistes et contacts ; les autres objets nécessitent votre propre processus | Fonctionnement du refus de messages |
Modèles
| Symptôme | Cause possible | Solution |
|---|---|---|
Le modèle ne s’active pas : Le modèle doit être testé avant son activation. | Le modèle doit réussir un test avant son activation | Tester et activer les modèles |
Impossible de modifier le modèle : Seuls les modèles inactifs peuvent être modifiés. Veuillez utiliser le bouton « Désactiver le modèle » pour désactiver le modèle avant d'apporter des modifications. | Un modèle actif est protégé contre les modifications | Tester et activer les modèles |
| Un modèle fonctionnel devient inactif avec un test en attente | Un nouveau test en échec peut effacer sa validation et le désactiver | Tester et activer les modèles |
Erreur : 5. Erreur de modèle : Les paramètres d'entrée fournis sont invalides. | Le modèle à champs de fusion ne dispose pas d’un enregistrement valide de son objet | Champs de fusion |
Scripts de chat
| Symptôme | Cause possible | Solution |
|---|---|---|
Le script ne démarre pas : Configuration incorrecte du modèle de script de chat [Première étape manquante]. | La première étape du modèle de script n’est pas correctement définie | Construire un script de chat |
| Le script s’arrête après la première réponse | La fenêtre de session est terminée ou Session active (minutes) est vide sur le modèle, empêchant sa progression | Sessions des scripts de chat |
| Le script enregistre un code au lieu du texte du bouton choisi | Les réponses aux boutons et listes utilisent l’id de l’option ; choisissez des identifiants adaptés aux valeurs à enregistrer | Étapes des scripts de chat |
Fil, accès et surveillance
| Symptôme | Cause possible | Solution |
|---|---|---|
| Le fil affiche « Rien dans la plage de temps actuelle » | Le dernier message de la conversation est plus ancien que la période de chargement | Performances du fil |
| Une erreur d’accès insuffisant mentionne un objet ou un champ | Les autorisations nécessaires peuvent manquer ; vérifiez l’ensemble attribué et les droits d’accès | Donner accès à votre équipe |
| Aucun e-mail ne signale les erreurs des traitements en arrière-plan | Pour la version 1.93 documentée, configurez un suivi par vue de liste et rapport plutôt que de dépendre des e-mails automatiques du package | Recevoir des notifications d’erreur |
| Vous ne savez pas où chercher les erreurs | Les problèmes des traitements en arrière-plan sont consignés dans Journaux Connect | Consulter et traiter les Journaux Connect |
Questions fréquentes
Cherchez une cause dans Message d'erreur à l’aide de Un message ne s’envoie pas. Pour un traitement en arrière-plan, lisez Exception sur le Journal Connect. Recherchez les codes du fournisseur dans la documentation officielle Meta ou Twilio.
Copiez le texte exact de l’erreur, le numéro du message ou du journal, le canal, le nom du compte Connect et l’heure de l’incident. Ces informations facilitent le diagnostic. Le support est joignable à support@reda.one.
Organisez le suivi avec une vue épinglée des journaux non résolus et un abonnement à un rapport. Consultez Recevoir des notifications d’erreur.
Pour aller plus loin
- Un message ne s’envoie pas : diagnostic détaillé des envois.
- Un message entrant n’est pas arrivé : diagnostic détaillé de la réception.
- Consulter et traiter les Journaux Connect : comprendre les erreurs en arrière-plan.