Skip to content

en usage platforms dingtalk

langbot-wiki-sync[bot] edited this page Jul 29, 2026 · 1 revision

DingTalk

Deploy LangBot to DingTalk.

One-Click Setup (Recommended)

LangBot supports one-click DingTalk app creation with automatic credential filling — no manual copy-paste needed.

  1. Open LangBot WebUI, go to Bots > Create Bot
  2. Enter a bot name, select DingTalk as the platform/adapter
  3. In the One-Click Create App section that appears, click the Start button

One-Click Create App

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

Select Organization

  1. Choose to create a new bot or select an existing one

Create or Select Bot

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

Config Success

  1. 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)

Fill Name and Code

  1. 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

Manual Configuration

Create Bot

Enter the DingTalk Developer Backend, log in and enter the organization. After successful login, enter the open platform, which looks like this: DingTalk Open Platform

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: Bot Page

Configure Bot

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

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: Version Management and Publishing

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: Before applying for card permissions

After applying for card permissions

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: Fill in information for new template

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

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

For the main content, keep the default 'content' unchanged: Don't modify

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

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

Fill in Configuration Information

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.

Connect to LangBot

Streaming related: img.png

Start LangBot.

Add Bot

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: robot_png

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.

LangBot Documentation

Home

简体中文
指南
开发者
API 参考
Other pages
English
Guides
Developers
API Reference
Other pages
日本語
ガイド
開発者
API リファレンス
Other pages

Clone this wiki locally