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 are sent as Markdown card messages
  • Progress notification messages are sent during tool calls
  • The final reply is sent after all tools complete
  • Basic Markdown formatting is supported

​
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

​
FAQ

  • Verify the app has been published and approved
  • Verify the message receiving endpoint is correctly configured
  • In group chat, make sure you @mentioned the bot
  • Check the Profy server logs for incoming callbacks
DingTalk message callbacks have network latency, plus AI model inference time — total latency is typically 3–15 seconds. It may take longer when tools like search are used. This is expected behavior.
All conversations in a group chat are visible to every group member. Use one-on-one chat mode for private conversations.

Channels Overview

Learn about all supported IM platforms

Feishu Integration

Feishu channel setup guide