DingTalk (Dingtalk)

Ce guide vous explique comment configurer un canal Qwen Code sur DingTalk (钉钉).

Prérequis

Un compte organisation DingTalk
Une application bot DingTalk avec AppKey et AppSecret (voir ci-dessous)

Création d’un bot

Accédez au portail développeur DingTalk
Créez une nouvelle application (ou utilisez une application existante)
Dans l’application, activez la fonctionnalité Robot
Dans les paramètres du robot, activez le Stream Mode (机器人协议 → Stream 模式)
Notez l’AppKey (Client ID) et l’AppSecret (Client Secret) depuis la page des identifiants de l’application

Stream Mode

Le Stream Mode de DingTalk utilise une connexion WebSocket sortante — aucune URL publique ni serveur n’est nécessaire. Le bot se connecte aux serveurs de DingTalk qui poussent les messages via le WebSocket. C’est le modèle de déploiement le plus simple.

Configuration

Ajoutez le canal dans ~/.qwen/settings.json :


{
  "channels": {
    "my-dingtalk": {
      "type": "dingtalk",
      "clientId": "$DINGTALK_CLIENT_ID",
      "clientSecret": "$DINGTALK_CLIENT_SECRET",
      "senderPolicy": "open",
      "sessionScope": "user",
      "cwd": "/path/to/your/project",
      "instructions": "You are a concise coding assistant responding via DingTalk.",
      "groupPolicy": "open",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

Définissez les identifiants comme variables d’environnement :


export DINGTALK_CLIENT_ID=<your-app-key>
export DINGTALK_CLIENT_SECRET=<your-app-secret>

Ou définissez-les dans la section env de settings.json :


{
  "env": {
    "DINGTALK_CLIENT_ID": "your-app-key",
    "DINGTALK_CLIENT_SECRET": "your-app-secret"
  }
}

Exécution


# Démarrer uniquement le canal DingTalk
qwen channel start my-dingtalk
 
# Ou démarrer tous les canaux configurés ensemble
qwen channel start

Ouvrez DingTalk et envoyez un message au bot. Vous devriez voir une réaction 👀 apparaître pendant que l’agent traite, suivie de la réponse.

Conversations de groupe

Les bots DingTalk fonctionnent à la fois en messages privés et en conversations de groupe. Pour activer le support des groupes :

Définissez groupPolicy sur "allowlist" ou "open" dans la configuration du canal
Ajoutez le bot à un groupe DingTalk
Mentionnez le bot avec @ dans le groupe pour déclencher une réponse

Par défaut, le bot exige une mention @ dans les conversations de groupe (requireMention: true). Définissez "requireMention": false pour un groupe spécifique afin qu’il réponde à tous les messages. Consultez Conversations de groupe pour plus de détails.

Trouver l’ID de conversation d’un groupe

DingTalk utilise conversationId pour identifier les groupes. Vous pouvez le trouver dans les logs du service du canal lorsqu’un message est envoyé dans le groupe — recherchez le champ conversationId dans la sortie des logs.

Images et fichiers

Vous pouvez envoyer des photos et des documents au bot, pas seulement du texte.

Photos : Envoyez une image (capture d’écran, diagramme, etc.) et l’agent l’analysera en utilisant ses capacités de vision. Cela nécessite un modèle multimodal — ajoutez "model": "qwen3.5-plus" (ou un autre modèle avec capacités visuelles) à la configuration de votre canal. DingTalk prend en charge l’envoi d’images directement ou dans le cadre de messages textes enrichis (texte + images mélangés).

Fichiers : Envoyez un PDF, un fichier de code ou tout autre document. Le bot le télécharge depuis les serveurs DingTalk et le sauvegarde localement afin que l’agent puisse le lire avec ses outils de fichiers. Les fichiers audio et vidéo sont également pris en charge. Cela fonctionne avec n’importe quel modèle.

Principales différences avec Telegram

Authentification : AppKey + AppSecret au lieu d’un jeton de bot statique. Le SDK gère automatiquement le rafraîchissement du jeton d’accès.
Connexion : Flux WebSocket au lieu de polling — aucune adresse IP publique ni URL de webhook nécessaire.
Formatage : Les réponses utilisent le dialecte markdown de DingTalk (un sous-ensemble limité). Les tableaux sont automatiquement convertis en texte brut car DingTalk ne les affiche pas. Les messages longs sont découpés en morceaux d’environ 3800 caractères.
Indicateur de traitement : Une réaction 👀 est ajoutée au message de l’utilisateur pendant le traitement, puis supprimée lorsque la réponse est envoyée.
Téléchargement de médias : Processus en deux étapes — un downloadCode provenant du message est échangé contre une URL de téléchargement temporaire via l’API DingTalk.
Groupes : DingTalk utilise isInAtList pour la détection des mentions @ au lieu d’analyser les entités du message.

Conseils

Utilisez des instructions adaptées au markdown DingTalk — DingTalk prend en charge un sous-ensemble limité de markdown (en-têtes, gras, liens, blocs de code, mais pas les tableaux). Ajouter des instructions comme “Utilise le markdown DingTalk. Évite les tableaux.” aide l’agent à formater correctement les réponses.
Restreignez l’accès — Dans un contexte organisationnel, senderPolicy: "open" peut être acceptable. Pour un contrôle plus strict, utilisez "allowlist" ou "pairing". Consultez Appairage DM pour plus de détails.
Messages cités — Citer (répondre à) un message utilisateur inclut le texte cité comme contexte pour l’agent. Citer les réponses du bot n’est pas encore pris en charge.

Dépannage

Le bot ne se connecte pas

Vérifiez que votre AppKey et AppSecret sont corrects
Vérifiez que les variables d’environnement sont définies avant d’exécuter qwen channel start
Assurez-vous que le Stream Mode est activé dans les paramètres du bot sur le portail développeur DingTalk
Consultez la sortie du terminal pour les erreurs de connexion

Le bot ne répond pas dans les groupes

Vérifiez que groupPolicy est défini sur "allowlist" ou "open" (la valeur par défaut est "disabled")
Assurez-vous de mentionner le bot avec @ dans le message du groupe
Vérifiez que le bot a été ajouté au groupe

”No sessionWebhook in message”

Cela signifie que DingTalk n’a pas inclus de point de terminaison de réponse dans le callback du message. Cela peut arriver si les permissions du bot sont mal configurées. Vérifiez les paramètres du bot dans le portail développeur.

”Sorry, something went wrong processing your message”

Cela signifie généralement que l’agent a rencontré une erreur. Consultez la sortie du terminal pour plus de détails.