Aller au contenu principal

Feishu / Lark

Le catalogue déclare des profils Feishu/Lark de connexion longue et de webhook. Les interfaces de configuration standard créent le compte Long connection par défaut, qui évite un webhook public. La présence d’une action webhook ou de basculement dans le catalogue ne signifie pas que l’interface standard propose un sélecteur de profil.

Profils de connexion et limites de configuration​

ProfilIdentifiants requisHTTPS public
Connexion longue par défaut (feishu.websocket.v1)App ID, App SecretNon
Webhook (feishu.webhook.v1)App ID, App Secret, Verification Token, Encrypt KeyOui

Consultez la présentation officielle pour la console actuelle de la plateforme.

Prérequis sur la plateforme​

Pour les deux profils :

  1. créez une application et activez la fonction bot ;
  2. accordez les autorisations requises de messagerie du bot ;
  3. abonnez-vous aux événements de message.

Faites correspondre la livraison côté plateforme au profil Anyy existant. La création standard d’un compte utilise la connexion longue.

Connexion​

Ouvrez Dashboard → Channel → Add, puis choisissez Feishu / Lark pour configurer la connexion longue par défaut. Saisissez App ID et App Secret. Les messages privés utilisent pairing par défaut ; les groupes, mention.

Exécutez anyy setup channel dans un terminal interactif et choisissez Feishu pour modifier les règles proposées par la CLI. Les interfaces standard CLI, TUI et Dashboard ne proposent actuellement aucun sélecteur ni geste de changement de profil de connexion. Ne considérez pas les descripteurs de basculement du catalogue comme une commande fonctionnelle de l’assistant.

Un compte webhook existant est mis à jour sous son profil actuel. Son formulaire CLI inclut les identifiants webhook ; Dashboard/TUI ne mettent à jour que les identifiants d’application qu’ils exposent.

Pour un compte webhook existant, activez l’écoute partagée et le proxy HTTPS décrits dans Plateformes de messagerie, puis exposez :

/channels/feishu/ACCOUNT_ID/webhook

L’identifiant de compte par défaut est work. Configurez les mêmes Verification Token et Encrypt Key dans Feishu/Lark et Anyy.

Règles d’accès​

Les messages privés acceptent pairing, open, allowlist et disabled. Les groupes acceptent mention, open, allowlist et disabled. Ces champs figurent dans l’assistant CLI, pas dans le formulaire d’identifiants Dashboard. La configuration actuelle ne comporte aucun éditeur des entrées de liste Feishu ; consultez les limites communes avant de choisir cette règle.

anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID

Vérifier la connexion​

anyy channel doctor feishu
anyy channel reload

Testez d’abord un message privé, puis une mention dans un groupe.

Dépannage​

ProblèmePoints à vérifier
La connexion longue ne devient jamais activeIdentifiants de l’application, fonction bot, abonnement aux événements, réseau sortant
Échec de vérification du webhookRoute HTTPS publique, Verification Token, Encrypt Key
Les événements arrivent mais les messages sont ignorésRègle des messages privés/groupes, association ou mention obligatoire
Réponse non autoriséeAutorisations de messagerie du bot et état de publication de l’application
Un autre profil de connexion est nécessaireLa configuration standard actuelle n’a pas de sélecteur ; ne devinez pas d’option ou d’action de profil