Comment fonctionnent les canaux

Un canal est toute destination en dehors de votre site WordPress vers laquelle Structura peut pousser un article fraîchement publié — LinkedIn, Slack, Discord, Telegram, IndexNow, un e-mail à vous, et ainsi de suite. Quand une campagne publie un article, Structura le distribue à chaque canal que vous avez connecté.

Pensez à votre site WordPress comme à la maison de l’article et aux canaux comme aux endroits où il est annoncé.

Les trois pièces en mouvement

Un canal a trois pièces qui travaillent ensemble :

Votre site WordPress. Fait tourner l’extension. Quand un article est publié, l’extension dit au cloud Structura « un article vient d’être mis en ligne » — avec le titre, l’URL, le résumé et l’image.

Le cloud Structura. Reçoit cet événement et le distribue à chaque canal que vous avez connecté pour ce site. Le cloud détient vos identifiants de canal (jetons OAuth, URLs de webhook, clés API) chiffrés et délimités par site.

Le canal lui-même. LinkedIn, Slack, Discord — la destination réelle. Le cloud appelle l’API du canal avec ce que le canal attend, en utilisant les identifiants que vous avez autorisés.

Pourquoi le cloud gère la distribution. Les API de canal exigent des secrets que nous devrions sinon stocker sur chaque site WordPress. Centraliser dans le cloud signifie (a) que vos jetons ne vivent pas sur votre serveur, (b) que le rafraîchissement de jeton se passe sans toucher à votre site, et (c) que nous pouvons corriger un bug de canal sans pousser une mise à jour d’extension.

Ce qui est envoyé à un canal

Chaque canal reçoit la même charge utile principale :

Titre de l’article.
URL de l’article sur votre site WordPress.
Résumé ou extrait — typiquement le premier paragraphe ou le champ extrait de l’article.
URL de l’image à la une — si l’article en a une.
Horodatage de publication.

Chaque canal met ensuite ces champs en forme pour sa propre surface. LinkedIn les transforme en un article avec aperçu de lien ; Slack en une carte Block Kit ; IndexNow envoie juste l’URL ; E-mail envoie une notification simple avec le premier paragraphe en ligne. Voir la page de chaque canal pour les spécificités.

Le Channels Store

Tous les canaux disponibles vivent dans le Channels Store, accessible depuis le portail principal à app.structurawp.com et reflété dans wp-admin. Vous parcourez ce qui est disponible, connectez ceux que vous voulez, et ils deviennent des destinations actives pour chaque site sur votre licence.

Voir Parcourir le Channels Store pour trouver des canaux, et Connecter un canal pour le flux général de connexion.

Types de connexion

Les canaux se connectent de l’une des trois façons, selon ce que le service de destination prend en charge :

OAuth. Vous cliquez sur Connecter, êtes redirigé vers la page de connexion du canal et approuvez l’accès. Utilisé par : LinkedIn. (D’autres canaux OAuth sont prévus.)

URL de webhook. Vous collez une URL vers laquelle Structura publie. Utilisé par : Slack, Discord.

Identifiants / clé. Vous saisissez une clé API ou un identifiant similaire. Utilisé par : IndexNow (le fichier de clé de votre site), Telegram (jeton du bot + ID de chat).

Aucune connexion nécessaire. Un petit nombre de canaux « autonomes » fonctionne sans rien à connecter. Utilisé par : E-mail au propriétaire (utilise votre e-mail d’administration WordPress).

Le type de connexion qui s’applique est clairement indiqué quand vous cliquez sur Connecter dans le store — vous verrez soit un bouton Connecter OAuth, soit une saisie d’URL de webhook, soit un formulaire de clé API.

Ce que vous contrôlez par site

Les connexions sont délimitées par activation — c’est-à- dire qu’elles sont liées à l’activation spécifique du site, pas à votre licence en général. Si vous activez Structura sur deux sites différents, vous gérez leurs connexions de canal indépendamment.

Cela vous permet, par exemple, d’avoir LinkedIn connecté sur le site de votre entreprise et Discord sur le site de votre projet annexe sans publication croisée.

Cycle de vie d’un canal

Un canal sur votre site passe par ces états :

Non installé. Dans le store, affichant Connecter.
Installé / connecté. Les diffusions partent quand des articles sont publiés.
Demande de l’attention. Une diffusion a échoué (mauvais identifiant, OAuth révoqué, panne de canal). L’interface fait remonter une erreur en ligne.
Déconnecté. Vous l’avez retiré explicitement. Les diffusions s’arrêtent.

Voir Activité et erreurs des canaux pour surveiller l’état, et Déconnecter ou reconnecter pour sortir des états 2 ou 3.

Quand les diffusions partent

Une diffusion est tentée une fois par canal par publication, au moment où l’article est mis en ligne. Il n’y a pas de file d’attente de réessais pour les diffusions échouées dans le MVP — si Slack est en panne au moment où votre article est publié, cet article n’arrive pas automatiquement à Slack.

Ce que vous pouvez faire :

Surveiller le détail d’exécution de chaque campagne — l’étape Channels liste une ligne par canal connecté avec son résultat de diffusion.
Corriger l’identifiant sous-jacent ou attendre que la panne du canal soit résolue.
Partager manuellement l’article manqué depuis le canal lui-même si nécessaire.

Voir Activité et erreurs des canaux.