Skip to main content
Scenario groups are a collaboration capability unique to DingTalk. Beyond standard group chat features, they offer business-specific capabilities such as Chat Quick actions, group assistants, and group message push. In a scenario group, you can display notifications and announcements via pinned cards, send and receive approval forms or alerts through the group message assistant, interact via message cards, and quickly open frequently used apps through Chat Quick actions. You can now create a scenario group by submitting a YiDA form.

​
Step 1: Create and Configure the Form

Create a form to capture the relevant information. This form serves as the data source that triggers the connector. Steps:
  1. Create a form and name it “Create Group Chat”.
  2. Add a member component to the form, mark it as required, and enable multi-select.
  3. Add another member component, name it “Select Group Owner”, and mark it as required.
  4. Add a Single-line text component, name it “Event Title”, and mark it as required.
1

Step 1

Add a Select component and name it “Group Chat Management Permissions”. Set the option value of “Everyone can manage” to “0” and enable it as the default selection. Set the option value of “Only group owner can manage” to “1” and enable required validation.
2

Click the Save button in the upper-right corner

​
Step 2: Create Integration & Automation

Further reading: For a detailed introduction to connectors, see Integration & Automation - Connectors.
When the form is submitted, the system automatically performs the action for the specified users, so you need to configure a connector. Steps:
  1. Go to the admin console >> Integration & Automation >> “Create Integration & Automation”.
  2. In the “Create Integration & Automation” dialog >> name the connector “Create Scenario Group” >> select “Form event trigger” as the trigger type and specify the trigger form >> click Confirm.

​
Step 3: Configure Integration & Automation

​
Configure the Form Trigger Event

Steps: Click “Form event trigger”. For the trigger event, select “Create Success”. For data filtering, select “All data”. Then click the Save button in the lower-right corner.

​
Configure the Connector

Steps:
  1. Configure the “Connector” node. Under Select app, select “Scenario Group”, then click Next.
  2. Under Select action, select the “Create Scenario Group” action, then click Next.
  3. Under Configure action, complete each configuration item, then click Save.
  4. Click the “Save” button in the upper-right corner of the page, then click the “Publish” button.

​
Step 3: Configure To-Do Task Content

Once the two steps above are complete, the group chat creation feature is ready. Next, submit the form to trigger the connector and automatically create a group chat in DingTalk. Steps: Fill in the form and click Submit.