Connect a DingTalk bot

Purpose#

Use a DingTalk Stream bot to send group messages to a Onevium assistant and return replies to the original conversation.

Before you start#

Prepare an enterprise application and test group in the DingTalk Open Platform. Confirm your Onevium model works. A group custom Webhook does not replace Stream application credentials. Basic connectivity does not require exposing the desktop management port.

First task#

1. Configure the application's bot. Follow the platform instructions to select Stream delivery and authorize message reception and replies.
2. Obtain the App Key and App Secret requested by Onevium, ensuring they belong to the same application.
3. Publish, configure the available audience, and add the bot to the test group.
4. Create a DingTalk connection in Onevium Channels. Validate credentials, select the project, model, and role, then start.
5. Mention the bot with “The test code is beta,” then ask for the code.

Verify text first. For AI cards, configure the capabilities required by your own application and template; do not copy another application's template identifier.

Confirm success#

Both DingTalk replies are readable and use the right context, with corresponding execution records in Onevium. Cards must show final text. Group history, members, and files require separate authorization and checks.

Common problems#

• Validation without messages: check the audience, membership, and mention behavior.
• Stalled after input: inspect model errors and pending approval.
• Blank or failed cards: retain the platform error, check the template and permissions, and avoid repeated submissions.

Next steps#

Set conversation scope in the channel overview. Send a test notification with automations and verify it from the receiving side.