This document outlines the mandatory steps to configure DingTalk application permissions for integrating DingTalk data sources with FastGPT datasets. Proper permission setup ensures FastGPT can access authorized DingTalk workspace, document, and user data as required for dataset synchronization.
Required Permissions Reference
The following table lists the exact permissions that must be enabled for successful DingTalk-FastGPT integration:
| Permission | Purpose |
|---|---|
qyapi_get_member | Get the operator ID from User ID. |
Wiki.Workspace.Read | List DingTalk workspaces accessible to the operator. |
Wiki.Node.Read | List folders and documents under a workspace. |
Storage.File.Read | Read DingTalk online document content. |
Step-by-Step Configuration
!Enable DingTalk app permissions configuration interface
Follow these steps to enable the required permissions:
- Open the Permissions tab on the DingTalk application's detail management page.
- Use the built-in search function to locate each permission listed in the reference table above.
- Toggle the activation switch for each required permission to enable it.
- After enabling all listed permissions, save your changes and publish the updated app configuration to apply the settings.
Troubleshooting Permission Issues
If you encounter an error that includes the exact string requiredScopes, enable the permissions explicitly listed in that error notification to resolve the permission mismatch.
Source: FastGPT official source
Applicability and version scope
Use this page for the documented Integrations scenario. Confirm the FastGPT, dependency, API, and deployment versions in the official source before applying a change.
Safety guardrails
Use [REDACTED_CREDENTIAL] for credentials and private data. Confirm the documented environment and version before review.
Rollback guidance
Restore the prior technical-content authority snapshot. Restore saved configuration and data snapshots, then repeat the smallest verification scenario.