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

Log in to the new ROMA Connect console.
In the navigation pane on the left, choose Connector. On the page displayed, click New Connection.
Select the DingTalk connector.

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.