DingTalk AI Table Writer

Problem

Syncing local data or task output to DingTalk AI Table (Notable) often requires juggling DingTalk open-platform credentials, access tokens, baseId, sheetIdOrName, records shape, and exact column-name matching. This skill packages that write path into a repeatable workflow: provide the target sheet and records, then bulk-write them and receive the document link.

Workflow and limits

• Credentials: includes default appKey, appSecret, and operatorId; custom values can be passed via --app-key, --app-secret, and --operator-id.
• Required parameters: baseId, sheetIdOrName, and records. records is a JSON array, and each record's keys must exactly match the DingTalk sheet column names.
• Key steps: fetch an access token from the accessToken API, then call the Notable records API, and finally return a document link such as https://alidocs.dingtalk.com/i/nodes/{baseId}.
• Caveats: missing columns, type mismatches, insufficient operatorId permission, or network failures can affect the result; the skill handles token refresh and retry logic, but it does not replace correct permission setup.