-
Notifications
You must be signed in to change notification settings - Fork 1.5k
en usage platforms dingtalk
Deploy LangBot to DingTalk.
LangBot supports one-click DingTalk app creation with automatic credential filling — no manual copy-paste needed.
- Open LangBot WebUI, go to Bots > Create Bot
- Enter a bot name, select
DingTalkas the platform/adapter - In the One-Click Create App section that appears, click the Start button

- Scan the QR code with the DingTalk app. On your phone, select the organization to create the bot in

- Choose to create a new bot or select an existing one

- After authorization, the phone will show "Configuration Successful", and Client ID / Client Secret will be auto-filled in the LangBot WebUI

- Manually fill in the bot name (must match the DingTalk bot name), and the Robot Code (required for image/file features — get it from DingTalk Developer Console > Bot Configuration)

- Click Submit to complete
Warning
After one-click setup, normal text chat works immediately. However:
- Image/File support: Requires the Robot Code (RobotCode) to be filled in. If not filled during one-click setup, get it from DingTalk Developer Console > Bot Configuration
- Streaming replies: Requires manually configuring a card template ID — see the Card Template section below
Enter the DingTalk Developer Backend, log in and enter the organization. After successful login, enter the open platform, which looks like this:

Click Application Development at the top, then click the blue button Create Application on the right, fill in the basic information of the bot, and click save.
Enter the bot's backend, for example, if we have a bot named langbot2, its management page looks like this:

Click Add Application Capability, Other Application Capabilities, Configure in Robot, click configure and fill in the information, as shown below:

Click Publish at the bottom of the page, after successful publication, click Version Management and Publishing at the bottom left of the bot page, as shown:

If this is the first time creating a bot, the right side is empty, you need to click Create New Version, set information in it, then set Application Visibility Range, and click save.
Click Event Subscription, change the push method to Stream Mode Push.
If card streaming is needed, you must apply for card permissions in the permission management, as shown:


Additionally, for card messages you mainly need to create a card template and record the template ID to fill in the configuration, the process is as follows:
The card content template ID can be obtained by logging into the developer backend > Card Platform
Fill in information when creating a new template, as shown:

Select a preset template (just choose the first one and modify the template content later), as shown:
Click Use
Create

After clicking Create you'll be redirected to edit the template. As shown, you can freely edit your desired card message:

For the main content, keep the default 'content' unchanged:

Widescreen configuration parameters, you need to add . in the template variables. See DingTalk Widescreen Configuration

After editing and confirming everything is correct, save it and copy the template ID to fill in the configuration file:


Click Credentials and Basic Information, record Client ID and Client Secret,
Click Application Capabilities, Robot, record the RobotCode and Robot Name.
markdown_card is whether to enable Markdown form replies. When this configuration item is disabled, the @Sender configuration switch will not take effect.
Record the above configuration items and fill them in the LangBot bot configuration form
Click Card Platform, copy the corresponding bound template ID from the template list, and fill it into the card template ID field.

Streaming related:

Start LangBot.
This article uses DingTalk Windows desktop version as an example, click Search at the top, Features, then enter the name of the bot you just created, as shown:

Click on the bot to chat with it.
If you want to add it to a group, click Group Management, Robots, Add Robot in the DingTalk group, then search for the bot name to use it in the group.
Automatically synchronized from langbot-app/langbot-wiki.
简体中文
指南
开发者
- 插件开发
- 插件 SDK API
- 核心开发
API 参考
- Service API
English
Guides
Developers
-
Plugin Development
- Plugin Development Tutorial
- Completing Plugin Configuration Information
- Plugin Directory Structure
- Component Development
- Code Style Guide
- Migration Guide
- Publish Plugin
- Plugin SDK API
- Core Development
API Reference
- Service API