Skip to main content
Connect your AI Expert to DingTalk, allowing team members to chat with your Expert directly in DingTalk messages. Supports both one-on-one and group chat scenarios. Messages are delivered in a multi-bubble format with real-time tool call notifications.

​
Integration Methods

Choose manual setup when you need fine-grained control:
1

Create a DingTalk Bot

Log in to the DingTalk Open Platform, go to App Development → Create App → Add the “Bot” capability.
2

Configure Message Receiving

In the bot configuration page, set up the message receiving endpoint (HTTP mode) and enter the callback URL provided by Profy.
3

Enter Credentials

Enter the DingTalk app’s App Key and App Secret in the Profy channel configuration panel.
4

Publish the App

Submit the app for publishing on the DingTalk Open Platform. It will be available once the review is approved.

​
Message Format

The DingTalk channel uses a “multi-bubble + tool notification” style: text replies arrive as Markdown cards, tool calls announce progress first, and the real reply follows once tools finish. When a message arrives, the bot first reacts with a “thinking” emoji as an acknowledgement — that reaction means the message was received, not that the reply is ready.

​
Use Cases

​
One-on-One Chat

Find the bot in your DingTalk contacts or search, then send a message to start a private conversation. Ideal for personal tasks and confidential discussions.

​
Group Chat

After adding the bot to a group, members can trigger replies by @mentioning the bot. Ideal for team collaboration and project discussions.
Add your Expert to a project group so team members can @Expert anytime for instant help without leaving their work context.

​
Detailed Setup Steps (Manual Mode)

If you choose manual configuration, here are the detailed steps:
1

Create an App

Create an “Internal Enterprise App” on the DingTalk Open Platform. Fill in the app name and description. The app name should ideally match your Expert’s name.
2

Add Bot Capability

Under the app’s “Capability Management,” add the “Bot” capability and set the bot’s avatar and description.
3

Configure Callback URL

In “Bot Configuration” → “Message Receiving Mode,” select HTTP mode and enter the Webhook URL provided by Profy.
4

Configure Permissions

Add the required permissions under “Permission Management”:
  • Send messages as enterprise bot
  • Send messages to conversations
  • Access group conversation info
5

Enter in Profy

Go back to the Profy Expert Studio channel configuration panel and enter the App Key and App Secret.
6

Test Connectivity

Send a test message to the bot in DingTalk and verify that you receive the correct response.

​
Important Notes

  • Creating and publishing DingTalk internal enterprise apps requires admin privileges
  • Published apps must pass review before they become available
  • Group bots need to be added by an admin

​
Key numbers

​
Failures and fixes

Channels Overview

Learn about all supported IM platforms

Feishu Integration

Feishu channel setup guide