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

# DingTalk plugin

> Connect DingTalk login, enterprise member verification, and knowledge-base document writing in superun.

# DingTalk plugin

The DingTalk plugin connects DingTalk accounts, org collaboration, and knowledge-base documents to your superun product. It fits internal systems that need unified enterprise login, member checks, and team document workflows.

***

## Capabilities

| Capability                                                         | Best for                               | Notes                                                   |
| ------------------------------------------------------------------ | -------------------------------------- | ------------------------------------------------------- |
| DingTalk login                                                     | Internal systems, employee portals     | Users sign in with DingTalk                             |
| Enterprise member verification                                     | Allowlists, internal access control    | Restrict which DingTalk org members can use the product |
| [DingTalk document write](/superun/integrations/dingtalk-document) | Reports, meeting notes, knowledge base | Create, write, or update docs in DingTalk Wiki          |

***

## Before you start

* Admin access to the [DingTalk Open Platform](https://open.dingtalk.com/).
* An internal enterprise app with **Client ID** and **Client Secret**.
* A published superun project domain for login callback URLs.
* Open the permissions you need on the open platform and publish the app.

***

## Recommended permission scope

After creating an internal app on the [DingTalk Open Platform](https://open.dingtalk.com/), enable permissions by goal — you do not need everything at once.

| Goal                | Suggested scope                              | Permissions / config                                                                        | Notes                                                                                                          |
| ------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| DingTalk login      | Internal app, login & share, callback domain | `Contact.User.Read`; `Contact.User.mobile` if you need phone                                | Basic profile for signed-in users; add mobile permission when required                                         |
| Member verification | Login + member info                          | `Contact.User.Read`; org read permissions as needed                                         | Verify org, department, or access scope                                                                        |
| Document write      | Wiki and documents                           | `Wiki.Workspace.Read`, `Document.WorkspaceDocument.Write`; `Wiki.Workspace.Write` if needed | Pick wiki, create docs, write content — see [DingTalk document write](/superun/integrations/dingtalk-document) |

### App visibility

* **Debug**: Limit visibility to the dev team or test dept to avoid org-wide impact.
* **Production**: Set to departments, members, or all employees who will use the product.
* **Document write**: Visibility must cover the authorizing user; target wikis need view/edit for that user.

<Note>
  DingTalk permissions often need admin approval and a published app on the open platform. Saving permissions without publishing can still show insufficient permission in superun.
</Note>

***

## Enable in superun

<Steps>
  <Step title="Create an internal enterprise app">
    Open the [DingTalk Open Platform](https://open.dingtalk.com/), go to internal development, create an app, and complete basic info.
  </Step>

  <Step title="Enable the DingTalk plugin">
    In **Build → Skill Library**, enable the DingTalk plugin and enter Client ID, Client Secret, and other credentials.
  </Step>

  <Step title="Choose capabilities">
    For login only, finish callback and member checks first; for wiki docs, also enable DingTalk document write.
  </Step>

  <Step title="Publish and test">
    Publish the app on the open platform, then test login, enterprise checks, or document write in your product.
  </Step>
</Steps>

***

## Related capabilities

<CardGroup cols={2}>
  <Card title="DingTalk document write" icon="file-lines" href="/superun/integrations/dingtalk-document">
    Create wiki documents, write content, update docs, and archive collaboratively.
  </Card>
</CardGroup>