Canaux

Les canaux connectent le Gateway résident aux messageries. Dashboard permet principalement d’ajouter des comptes, consulter leur santé, modifier leurs réglages, réauthentifier et retirer des connexions.

Pour les plateformes et comportements, consultez Plateformes de messagerie.

Sessions et connexions aux plateformes

Authentification des comptes, messages entrants et livraison sortante sont des intégrations Anyy. Une fois admis dans une session, messages de l’agent, files d’orientation/suivi, interruption et événements suivent le même cycle aligné Pi que les autres interfaces. Un adaptateur n’ajoute ni boucle d’agent ni règle de file différente.

Le dépôt principal Pi v1.2.0 figé n’a pas d’API native unifiée correspondante pour Feishu/Weixin/Slack ; son README dirige la conversation vers le projet séparé pi-chat. Ce projet et les extensions tierces ne sont pas la référence de ce portage. Réglages locaux et tests contrôlés de protocole ne prouvent pas la connexion d’un vrai compte externe ; vérifiez la santé observée.

Ouvrir la page Channel

Ouvrez Dashboard → Channel. Les filtres alternent entre :

• Configured — comptes enregistrés, même déconnectés ;
• Available — adaptateurs configurables.

Chaque compte a un ID stable et une incarnation identifiant la connexion actuelle. Les interfaces créent un compte seulement si la plateforme n’en a pas ; aucun parcours de second compte n’est proposé.

Configurer un compte

1. Choisissez une plateforme disponible.
2. Saisissez un ID de compte.
3. Remplissez les champs propres à la plateforme.
4. Complétez ceux de l’action Dashboard choisie.
5. Enregistrez.

L’enregistrement soumet directement l’action et retourne son reçu Operation. Réglages et liaisons protégées d’identifiants sont validés ensemble. Laisser un secret vide le conserve seulement si le champ le permet ; supprimez le compte pour nettoyer ses identifiants gérés.

Un reçu committed ou no_op décrit les réglages locaux sans confirmer la connexion externe. Un démarrage/nouvel essai ou une action d’état désiré inchangée demande toujours la réconciliation. Réessayer une demande appelante identique retourne le reçu d’origine. Vérifiez la santé observée pour le résultat réel.

Weixin utilise un QR : scannez avec le compte voulu, confirmez sur téléphone et attendez le résultat. L’interaction dure cinq minutes. Une confirmation acceptée avant expiration peut finir sa vérification locale après ; la santé observée du transport reste à vérifier. Annulez ou remplacez la tentative depuis la page.

Si un redémarrage Gateway perd la poignée active d’interrogation QR, la tentative se ferme comme inconnue/expirée. Aucun autre QR n’est récupéré silencieusement ; démarrez une tentative neuve selon l’instruction.

Si la réponse de connexion se perd, utilisez Retry ou rechargez. Dashboard garde la même demande ; réessayer ne crée pas d’authentification supplémentaire. Seule une actualisation explicite demande un nouveau QR. La récupération dure dix minutes par geste ; ensuite revenez aux paramètres. Cela ne prolonge pas les cinq minutes du QR.

La réauthentification doit correspondre au compte

Pour Weixin, scannez avec la même identité. Pour en changer, supprimez d’abord l’ancien compte puis créez-en un nouveau.

La plupart des formulaires Dashboard/TUI n’exposent pas les règles privées/groupes. Modifiez-les dans l’assistant interactif anyy setup channel. Weixin a un formulaire d’accès distinct après liaison. Feishu utilise la connexion longue par défaut sans sélecteur standard de changement de profil. Consultez son guide pour les comptes webhook existants.

Lire la santé du compte

Ouvrez un compte pour :

• états désiré et actuel ;
• statut sain, dégradé, malsain ou inconnu ;
• dernières activités entrante/sortante ;
• capacité déclarée d’accusé et preuves observées de tentatives/temporisation ;
• erreurs d’authentification/autorisations ;
• configuration masquée.

Un compte dégradé peut fonctionner partiellement. Suivez la remédiation avant des rechargements répétés.

La capacité d’accusé déclarée ne prouve pas la livraison d’un message donné. Preuves, diagnostics et heure de prochaine tentative décrivent la connexion observée.

Anyy garde une réponse finale en attente lorsqu’un nouvel essai est sûr avant envoi. Si une partie est acceptée ou le résultat distant incertain, il ne répète pas automatiquement. Consultez la conversation avant une autre copie. La progression d’un tour achevé ne suit pas sa réponse finale.

Règles d’accès

Les contrôles dépendent de la plateforme. Règles courantes :

• messages privés désactivés, associés, sur liste ou ouverts ;
• groupes limités aux mentions ou à une liste de salons existante ;
• approbation CLI des nouveaux expéditeurs si compatible.

Règles/listes dépendent de l’interface. Les listes publiques actuelles concernent Weixin et IRC ; les autres adaptateurs peuvent lire une liste existante mais leur configuration n’en modifie pas les entrées. Choisir allowlist n’en crée pas une. Utilisez la règle la plus étroite réellement configurable. Connecter un compte n’autorise pas tous les expéditeurs.

Pour Weixin déjà lié, ouvrez les paramètres pour règle privée et allow_from. L’enregistrement garde la connexion sans nouveau QR. Une liste vide retire toutes les entrées.

Recharger les canaux

Choisissez Reload pour réconcilier les comptes enregistrés. Leur enregistrement le demande normalement déjà ; Reload ne rejoue pas l’historique et ne démarre pas une écoute webhook désactivée.

Depuis la CLI :

anyy channel reload
anyy channel doctor telegram

doctor observe connectivité et diagnostics sans changer la configuration. Une écoute webhook modifiée exige redémarrage ; consultez Plateformes de messagerie.

Association depuis la CLI

La page Dashboard n’a pas de liste d’approbation. Pour les plateformes concernées :

anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
anyy channel pairing reject --request REQUEST_ID
anyy channel pairing revoke --grant GRANT_ID

Examinez plateforme, compte, identité masquée et accès demandé avant approbation.

Si la liste bornée ne trouve pas un ID connu, précisez son périmètre :

anyy channel pairing approve --request REQUEST_ID --channel telegram --account personal
anyy channel pairing revoke --grant GRANT_ID --channel telegram --account personal

Cela sélectionne le compte actuel pour la même action par ID sans contourner la propriété.

Supprimer un compte

Le détail propose une suppression. Elle retire configuration et identifiants gérés de ce compte, sans supprimer de messages sur la plateforme.

L’état local d’arrêt/suppression et le nettoyage des identifiants sont validés ensemble, puis le transport réel est réconcilié. Actualisez liste et connexion avant de reconfigurer l’identité. Le reçu local ne prouve pas une déconnexion sur la plateforme.

Configuration CLI

Lancez l’assistant interactif :

anyy setup channel

Ajouter une plateforme sélectionne la configuration non interactive, pas un assistant propre. Un compte Telegram existant peut par exemple modifier les règles en préservant les identifiants autorisés :

anyy setup channel telegram --set dm_policy=pairing --set group_policy=mention

Un nouveau compte exige aussi les identifiants déclarés.

Consultez anyy setup channel --help pour --set et les entrées sensibles non interactives.

Conseils de sécurité

• Écartez jetons de bot et secrets de signature des historiques/captures.
• Commencez par association ou liste avant une règle privée ouverte.
• Vérifiez points webhook et autorisations côté fournisseur.
• Retirez les identifiants en abandonnant un compte.
• Traitez messages externes et pièces comme non fiables.

Dépannage

Problème	Solution
Compte indisponible	Ouvrez son détail et suivez la remédiation
Connexion expirée	Réauthentifiez la même identité
Réception mais réponses échouées	Vérifiez autorisation sortante, livraison et quotas
Nouvel expéditeur refusé	Vérifiez règle privée et associations en attente
Configuration changée sans effet	Reload ou anyy channel reload

Consultez Cron pour livrer des résultats planifiés par un canal connecté.