dingtalk-cli

# DingTalk CLI Skill Index **Before doing anything**, you MUST load the `dws` skill first. It contains the full product reference, command syntax, intent routing decision tree, dangerous operation rules, and error handling guide. Do not proceed without reading it. ``` read_skills(skill_names=["dws"]) ``` --- ## Product Overview | Product | Use for | CLI entry | |---------|---------|-----------| | `aiapp` | AI apps: create, query, update | `dws aiapp` | | `aisearch` | AI search: find people by name, employee number, phone, department, responsibility, reporting lines | `dws aisearch` | | `aitable` | AI tables: bases, tables, fields, records, views, charts, dashboards, import/export | `dws aitable` | | `attendance` | Attendance: punch records, shift schedules, statistics | `dws attendance` | | `calendar` | Calendar: events, attendees, meeting rooms, availability | `dws calendar` | | `chat` | Conversations, group chats, bot messaging, single chat, Webhook, message history, direct/group message list, sender filters, unread conversations, keyword and advanced message search, read/send status, send/reply/forward/recall | `dws chat` | | `contact` | Contacts: user lookup, department structure | `dws contact` | | `devdoc` | DingTalk open platform developer documentation search | `dws devdoc` | | `ding` | DING alerts: send/recall (in-app / SMS / phone) | `dws ding` | | `doc` | DingTalk docs: search, read, write, block edit, comments, copy/move | `dws doc` | | `drive` | Cloud drive: file list, upload, download, folders | `dws drive` | | `live` | Live sessions: list and info | `dws live` | | `mail` | Mail: search, view, send | `dws mail` | | `minutes` | AI meeting minutes: list, summary, transcript, todos, mindmap | `dws minutes` | | `oa` | OA approvals: pending, submitted, approve, reject, revoke | `dws oa` | | `pat` | Behavior authorization management | `dws pat` | | `report` | Logs/reports: create by template, inbox, sent, statistics | `dws report` | | `sheet` | DingTalk spreadsheets: worksheets, cells, formulas, images, find/replace | `dws sheet` | | `todo` | Todos: create, query, update, complete, delete | `dws todo` | | `wiki` | DingTalk wiki spaces and knowledge-base nodes | `dws wiki` | --- ## Authentication Before any DingTalk operation, verify auth status first: ```bash dws auth status --format json ``` If `authenticated` is `false`, start the login flow. This environment has no browser (Docker/SSH), so always use the device flow: ```bash dws auth login --device ``` The command outputs an authorization URL, then waits with the prompt `Waiting for user authorization`. At this point: 1. Show the authorization URL to the user 2. Ask the user to open the URL in a browser or DingTalk mobile app to complete authorization 3. The command will automatically detect the authorization and proceed To force re-login (e.g. token expired): ```bash dws auth login --device --force ``` --- ## When Unsure About a Command Always check `--help` before guessing parameters. ```bash dws --help dws <product> --help dws <product> <command> --help ``` Examples: ```bash dws chat --help dws calendar event list --help dws aitable record --help ```