Connect DingTalk
Connect a DingTalk (钉钉) robot to a Buda agent over Stream Mode — scan to auto-register an app, or enter a Client ID and Secret manually.
Bring your agent into DingTalk so colleagues can chat with it in DMs and groups. Buda connects over DingTalk's Stream Mode — a persistent outbound WebSocket — so there's no public URL to host.
Connect the bot
Buda offers two ways to connect: scan a QR code and let DingTalk create the app for you, or enter credentials from an app you've already created.
Open Add Channel
In Buda, open Settings → Channels, click Add Channel, and select DingTalk.
Scan to connect (recommended)
On the Scan to connect tab, click Start scan. Buda shows a QR code — open DingTalk, scan it, and confirm the authorization in the app. DingTalk registers an app in your organization and returns its credentials directly to Buda, so you never have to open the DingTalk Developer Portal yourself.
Or enter credentials manually
Switch to the Enter manually tab if you already have an app. Create (or reuse) an internal app in the DingTalk Developer Portal with bot/robot capability and Stream Mode enabled, then copy its:
- Client ID (AppKey)
- Client Secret (AppSecret)
Paste both into Buda, optionally set a label and target agent, then click Connect.
Test it
Find the bot in DingTalk and send it a direct message, e.g. Hi. In a group, @mention the bot to get a reply.
Use it in a group
Add the bot to a DingTalk group and @mention it to trigger a reply — group messages that don't mention the bot are ignored. Direct messages don't need a mention.
Only text messages are handled today — DingTalk messages of other types (images, files, cards, etc.) are ignored.
Troubleshooting
| Symptom | Fix |
|---|---|
| Bot not responding | Confirm the channel shows Active; re-check the Client ID / Client Secret if you connected manually |
| No reply in a group | You must @mention the bot in group chats |
| QR code expired | Start the scan again from Add Channel |
| Credentials compromised | Reset the AppSecret in the DingTalk Developer Portal, then update it in Buda's channel settings |
Related
- Channels overview — how channels route messages to agents
- DingTalk Developer Portal