Help Center/ ROMA Connect/ User Guide/ Composite Applications/ Configuring Connectors/ SaaS Connectors/ DingTalk
Updated on 2026-01-19 GMT+08:00
View PDF

DingTalk

The DingTalk connector allows you to use DingTalk functions in a workflow after a few configurations.

DingTalk is an enterprise-level intelligent mobile office platform developed by Alibaba. It features office collaboration and application development in the digital era.

Creating a DingTalk Connection

  1. Log in to the ROMA Connect console.
  1. In the navigation pane on the left, choose Connector. On the page displayed, click New Connection.
  2. Select the DingTalk connector.
  3. In the dialog box displayed, configure the connector and click OK.

    Parameter

    Description

    Name

    Enter the connector instance name.

    AppKey

    Client ID in "application development" > "internal applications" > "application details" > "application information" in DingTalk.

    AppSecret

    Client Secret in "application development" > "internal applications" > "application details" > "application information" in DingTalk.

    RobotCode

    RobotCode in "application development" > "internal applications" > "application details" > "robot and message push" in DingTalk. Mandatory for the chatbot function.

    Description

    Enter the description of the connector to identify it.

Action

  • Sending a link message by chatbot
  • Sending a Markdown message by chatbot
  • Sending an image message by chatbot
  • Sending a file message by chatbot
  • Sending an ActionCard message by chatbot
  • Sending a text message by chatbot

Configuration Parameters

Table 1 Sending a link message by chatbot

Parameter

Description

Group Chat ID

Obtain the value from the DingTalk API for creating an enterprise internal group or other groups. For an existing group, obtain the value by calling the JSAPI biz.chat.chooseConversationByCorpId.

Subject

Message subject.

Content

Message content.

Image URL

Link to the preview image.

Redirection URL

Redirection link opened after clicking the message.
Table 2 Sending a Markdown message by chatbot

Parameter

Description

Group Chat ID

Obtain the value from the DingTalk API for creating an enterprise internal group or other groups. For an existing group, obtain the value by calling the JSAPI biz.chat.chooseConversationByCorpId.

Subject

Message subject.

Content

Message content.
Table 3 Sending an image message by chatbot

Parameter

Description

Group Chat ID

Obtain the value from the DingTalk API for creating an enterprise internal group or other groups. For an existing group, obtain the value by calling the JSAPI biz.chat.chooseConversationByCorpId.

Image URL

Link to the preview image.
Table 4 Sending a file message by chatbot

Parameter

Description

Group Chat ID

Obtain the value from the DingTalk API for creating an enterprise internal group or other groups. For an existing group, obtain the value by calling the JSAPI biz.chat.chooseConversationByCorpId.

Media File ID

Value of media_id of the API for uploading media files.

File Name

Name of the file to be sent.

File Type

xlsx, pdf, zip, rar, doc and docx files are supported.
Table 5 Sending an ActionCard message by chatbot

Parameter

Description

Group Chat ID

Obtain the value from the DingTalk API for creating an enterprise internal group or other groups. For an existing group, obtain the value by calling the JSAPI biz.chat.chooseConversationByCorpId.

Subject

Message subject.

Content

Message content.

Redirect Button

Text displayed on the redirect button.

Redirection URL

Redirection link opened after clicking the message.
Table 6 Sending a text message by chatbot

Parameter

Description

Group Chat ID

Obtain the value from the DingTalk API for creating an enterprise internal group or other groups. For an existing group, obtain the value by calling the JSAPI biz.chat.chooseConversationByCorpId.

Content

Message content.
Parent topic: SaaS Connectors