dws钉钉消息发送经验

# dws钉钉消息发送经验

## 背景

需要通过 `dws` 向钉钉联系人发送工作消息时，优先用通讯录查询确认收件人，再发送消息。

## 前置检查

```shell
dws auth status --format json
dws profile list --format json
```

判断标准：

- 当前账号已登录。
- 当前组织正确。
- 发消息前必须确认目标人 `userId`，不要只凭姓名发送。

## 查询收件人

```shell
dws contact user search --query "罗衡" --format json
```

示例结果中的关键字段：

| 字段 | 示例 | 用途 |
| --- | --- | --- |
| `name` | `罗衡` | 姓名 |
| `title` | `服务器运维工程师` | 岗位，辅助确认身份 |
| `userId` | `59539` | 发送消息使用 |
| `openDingTalkId` | `Dx8giPPVRpzGoe6nG3826yhCLMBcw9Bz3S` | 开放 ID，必要时记录 |

## 发送消息

发送前先确认文案，尤其是工作沟通、催办、批评、敏感内容。确定后执行：

```shell
dws chat message send --receiver-user-id "59539" --content "消息内容" --format json
```

执行成功后关注返回字段：

| 字段 | 用途 |
| --- | --- |
| `success` | 是否发送成功 |
| `openTaskId` | 钉钉消息任务 ID，可写入操作记录 |

## 本次实践

| 项目 | 内容 |
| --- | --- |
| 收件人 | [[09-人员信息/罗衡]] |
| userId | `59539` |
| 岗位 | 服务器运维工程师 |
| 消息内容 | `罗衡，这个事情处理得不太合适，需要你尽快说明原因并配合修正。` |
| 返回 openTaskId | `kuWkbeSHV0BVpVhWwA/zJHp0uUIQa1vFZDbuTW/M5n8=` |

## 注意事项

- 不要发送侮辱性、攻击性内容；如果用户给出不合适文案，应改成工作化表达再确认。
- 同名人员必须先通过岗位、部门、userId 确认。
- 发消息是对外动作，执行后不可假装未发送；要把成功返回的关键 ID 记录下来。
- 所有命令统一带 `--format json`。

## 适用位置

- [[09-人员信息/人员信息总览]]
- [[09-人员信息/罗衡]]