DingTalk
Le canal DingTalk utilise une connexion Stream pour recevoir les événements du bot et envoyer les réponses. Le Gateway résident maintient cette connexion ; la configuration habituelle ne nécessite donc aucun webhook public entrant.
Prérequis
- une application DingTalk dotée de la fonction bot ;
- un abonnement aux messages du bot Stream activé ;
- le Client ID et le Client Secret ;
- éventuellement le Bot User ID, le Bot Staff ID ou le Robot Code, selon l’identité de l’application.
Consultez la documentation actuelle du SDK DingTalk Stream pendant la configuration de l’application.
Connexion dans Dashboard
- Ouvrez Dashboard → Channel → Add.
- Choisissez DingTalk ; l’entrée par défaut utilise Stream.
- Saisissez le Client ID et le Client Secret.
- Ajoutez les champs facultatifs d’identité du bot uniquement s’ils correspondent à l’application configurée.
- Enregistrez les identifiants ; utilisez l’assistant CLI pour les règles des messages privés et des groupes.
- Confirmez l’abonnement aux messages du bot Stream dans DingTalk.
L’identifiant de compte par défaut est work.
Règles d’accès
Les messages privés utilisent pairing par défaut ; les valeurs acceptées sont pairing, open, allowlist et disabled. Les groupes utilisent mention par défaut ; ils acceptent également open, allowlist ou disabled.
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
Modifiez ces règles avec anyy setup channel dans un terminal interactif, puis choisissez DingTalk. Dashboard ne propose pas ces champs, et la configuration actuelle ne comporte aucun éditeur des entrées de liste DingTalk. Consultez Plateformes de messagerie. Pour les groupes, commencez par un test mentionnant explicitement le bot.
Vérifier la connexion
anyy channel doctor dingtalk
anyy channel reload
Après le rechargement, envoyez un message privé et un message de groupe avec mention. Vérifiez chaque règle d’accès séparément.
La livraison Stream dépend de la connexion active du Gateway. Si les messages cessent après un redémarrage ou un changement de réseau, vérifiez l’état du Gateway avant de modifier l’application DingTalk.
Dépannage
| Problème | Points à vérifier |
|---|---|
| Stream ne se connecte jamais | Client ID/Secret, accès réseau sortant et abonnement Stream |
| Message privé ignoré | Règle des messages privés et association/liste d’autorisation |
| Message de groupe ignoré | Règle des groupes et mention explicite |
| Réception fonctionnelle, réponse impossible | Champs d’identité du bot et autorisations de l’application DingTalk |
| Déconnexions répétées | État du Gateway, stabilité du réseau, puis rechargement du canal |