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
```