> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profy.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# DingTalk

> Connect and use Expert in DingTalk

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

<AccordionGroup>
  <Accordion title="QR Code Quick Setup (Recommended)">
    The simplest way to get started:

    1. Go to "Channel Integration" in Expert Studio and select DingTalk
    2. Click "Scan to Connect"
    3. Scan the QR code with a DingTalk admin account
    4. Confirm authorization — configuration completes automatically
    5. Search for the bot name in DingTalk to start testing

    The QR code method automatically handles bot creation and callback configuration.
  </Accordion>

  <Accordion title="Manual Configuration">
    Choose manual setup when you need fine-grained control:

    <Steps>
      <Step title="Create a DingTalk Bot">
        Log in to the [DingTalk Open Platform](https://open-dev.dingtalk.com), go to App Development → Create App → Add the "Bot" capability.
      </Step>

      <Step title="Configure Message Receiving">
        In the bot configuration page, set up the message receiving endpoint (HTTP mode) and enter the callback URL provided by Profy.
      </Step>

      <Step title="Enter Credentials">
        Enter the DingTalk app's App Key and App Secret in the Profy channel configuration panel.
      </Step>

      <Step title="Publish the App">
        Submit the app for publishing on the DingTalk Open Platform. It will be available once the review is approved.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## 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.

<Tip>
  Add your Expert to a project group so team members can @Expert anytime for instant help without leaving their work context.
</Tip>

## Detailed Setup Steps (Manual Mode)

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="Add Bot Capability">
    Under the app's "Capability Management," add the "Bot" capability and set the bot's avatar and description.
  </Step>

  <Step title="Configure Callback URL">
    In "Bot Configuration" → "Message Receiving Mode," select HTTP mode and enter the Webhook URL provided by Profy.
  </Step>

  <Step title="Configure Permissions">
    Add the required permissions under "Permission Management":

    * Send messages as enterprise bot
    * Send messages to conversations
    * Access group conversation info
  </Step>

  <Step title="Enter in Profy">
    Go back to the Profy Expert Studio channel configuration panel and enter the App Key and App Secret.
  </Step>

  <Step title="Test Connectivity">
    Send a test message to the bot in DingTalk and verify that you receive the correct response.
  </Step>
</Steps>

## Important Notes

<Warning>
  * 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
</Warning>

## FAQ

<AccordionGroup>
  <Accordion title="Bot not responding">
    * 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
  </Accordion>

  <Accordion title="High message latency">
    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.
  </Accordion>

  <Accordion title="Can other group members see the conversation?">
    All conversations in a group chat are visible to every group member. Use one-on-one chat mode for private conversations.
  </Accordion>
</AccordionGroup>

## Related Pages

<CardGroup cols={2}>
  <Card title="Channels Overview" icon="layer-group" href="/en/documentation/channels/overview">
    Learn about all supported IM platforms
  </Card>

  <Card title="Feishu Integration" icon="message" href="/en/documentation/channels/feishu">
    Feishu channel setup guide
  </Card>
</CardGroup>