Un canal affiche « failed »
Quand un canal affiche « Demande de l’attention » sur
la page Channels, ou qu’une entrée CHANNELS.PUBLISH
revient avec un niveau d’erreur, parcourez cette page
pour trouver la cause et la corriger.
Le message d’erreur sous-jacent est l’indice le plus rapide — commencez par le lire, puis cherchez à faire correspondre avec les sections ci-dessous.
Trouver le message d’erreur
Un échec de canal déclenche généralement un avis Connexion dans votre icône de cloche — ouvrez-le pour voir l’erreur sous-jacente et une action Reconnecter en un clic. Si la cloche n’a rien pour ce canal, ouvrez l’exécution la plus récente de la campagne depuis le tableau de bord et regardez l’étape Channels dans le détail de l’exécution ; chaque résultat par canal porte la raison sur sa propre ligne.
Si la ligne a un contexte supplémentaire (une vue développée montre une trace de pile ou une réponse brute du fournisseur), c’est l’indice le plus utile — c’est ce que l’API du canal nous a renvoyé.
Erreur : OAuth / autorisation
Messages comme : invalid_grant, Token expired,
Unauthorized, Access token revoked, 401.
S’applique à : LinkedIn (ou tout futur canal OAuth).
Pourquoi : vous avez changé votre mot de passe LinkedIn, révoqué Structura des applications autorisées de LinkedIn, ou le jeton a expiré naturellement.
Correctif :
- Ouvrez Structura → Channels.
- Cliquez sur la carte LinkedIn.
- Cliquez sur Reconnecter. Parcourez le flux OAuth.
Voir LinkedIn et Déconnecter ou reconnecter.
Erreur : URL de webhook invalide
Messages comme : 404, Webhook not found,
invalid_token (Slack).
S’applique à : Slack, Discord.
Pourquoi : le webhook a été supprimé dans Slack/Discord — soit le canal a été archivé, soit un admin a révoqué l’app, soit quelqu’un a régénéré le webhook.
Correctif :
- Dans Slack/Discord, créez un nouvel incoming webhook sur le canal de destination. Voir la page Slack ou Discord pour les étapes exactes.
- Copiez la nouvelle URL.
- Dans Structura, ouvrez le panneau d’installation du canal et cliquez sur Reconnecter. Collez la nouvelle URL.
Erreur : limité en débit
Messages comme : 429, rate limit exceeded,
Too many requests.
S’applique à : n’importe quel canal, mais le plus courant pour LinkedIn si vous publiez beaucoup d’articles dans une fenêtre courte.
Pourquoi : l’API du canal nous limite à cause du volume récent.
Correctif :
- Attendez — la plupart des limites de débit s’éclaircissent en quelques minutes à une heure.
- Si c’est persistant, vérifiez si vous avez une rafale inhabituelle (par ex. en publiant un backlog). Ralentissez la cadence.
- Les diffusions ne sont pas réessayées automatiquement, donc les articles manqués pendant la limitation ne rattraperont pas seuls ; partagez manuellement s’ils comptent.
Erreur : charge utile trop grande
Messages comme : Payload exceeds limit,
Image too large, 413.
S’applique à : les canaux qui envoient l’image à la une — Discord, Telegram, Slack (moins courant).
Pourquoi : l’image à la une de l’article dépasse la limite de taille de fichier ou de pixels du canal.
Correctif :
- Utilisez des images à la une plus petites. Les paramètres Visuals intégrés de Structura peuvent être réglés sur un ratio d’aspect plus petit, ou utilisez JPEG/WebP (plus petits que PNG) sous Structura → Paramètres → Visuals → Format Encoding.
- Si un article déjà publié n’a pas pu être diffusé pour cette raison, le texte du message est probablement passé — vérifiez le canal.
Erreur : spécifique à Telegram
Messages :
chat not found— ID de chat erroné, ou le bot n’est pas membre de ce chat/canal. Pour les canaux, le bot doit être un administrateur.Forbidden: bot can't initiate conversation with a user— pour les chats privés, vous devez d’abord envoyer un message au bot. Envoyez un message à votre bot dans Telegram, puis réessayez.Unauthorized— jeton du bot erroné.
Correctif : voir Telegram pour comment vérifier le jeton et l’ID de chat, et comment reconnecter avec des valeurs corrigées.
Erreur : spécifique à IndexNow
Messages :
Key file mismatch— le fichier<key>.txtà la racine de votre site ne correspond pas à la clé sous laquelle nous soumettons. Soit re-téléversez le bon fichier, soit régénérez la clé dans le panneau d’installation et téléversez un nouveau fichier.Key file not reachable— nous n’avons pas pu récupérer le fichier en HTTP. Vérifiez qu’il est à la racine web (pas dans/wp-content/), accessible sans auth, et renvoyant 200.
Voir IndexNow.
Erreur : l’e-mail n’a pas été envoyé
Messages : wp_mail failed, SMTP error.
S’applique à : E-mail au propriétaire.
Pourquoi : l’e-mail sortant de WordPress n’est pas correctement configuré sur ce site.
Correctif : voir la section « Assurez-vous que WordPress peut réellement envoyer des e-mails » de E-mail au propriétaire.
Erreur : tout le reste
Certains échecs de canal sont transitoires — une brève
panne au canal, un soubresaut réseau. Si le message
d’erreur est générique (500, Unknown error,
timeout) et isolé :
- Attendez une heure.
- Regardez si le prochain article planifié se diffuse avec succès.
- Si oui, c’était un problème transitoire — pas d’action requise au-delà de partager manuellement l’article manqué si vous voulez.
- Si les échecs persistent, traitez ça comme un problème d’identifiants et reconnectez.
Quand le canal fonctionne mais le message a l’air faux
Si la diffusion a réussi selon le détail de l’exécution mais que le message a l’air bizarre dans Slack/Discord/LinkedIn (titre tronqué, image cassée, pas d’aperçu de lien) :
- Les aperçus de lien sur LinkedIn viennent des balises
Open Graph de votre article. Si votre thème ou
extension SEO ne les émet pas, LinkedIn ne rendra pas
d’aperçu. Vérifiez avec un outil comme
https://www.opengraph.xyz. - Les embeds Slack/Discord peuvent être affectés par les spécificités du contenu de l’article. Si le problème est reproductible, envoyez-nous une URL d’exemple.
Si vous êtes bloqué
Contactez le support avec :
- Le nom du canal.
- Le texte d’erreur de l’avis (ou de l’étape Channels du détail de l’exécution).
- L’heure approximative de la diffusion échouée.