---
url: /zh/integrations/channels/dingtalk.md
---
# 钉钉

把 Memoh Bot 接入钉钉,支持企业内私聊与群聊:入站消息经由钉钉 Stream 模式送达,回复与媒体走钉钉官方 API。

::: warning 使用限制

* 回复按完整消息送达,不做逐 token 流式输出。
  :::

## 前提条件

* 能进入组织对应的钉钉开放平台,并有创建应用的权限。
* 不需要公网回调地址:Memoh 自动维护与钉钉的 Stream 长连接来接收消息。

## 步骤

### 1. 在钉钉开放平台创建应用

在组织对应的钉钉开放平台:

1. 创建或选用一个应用作为 Bot。
2. 为该应用开启 Bot/消息能力。
3. 复制 **App Key** 和 **App Secret**。
4. 为应用授予消息权限,并在组织内发布,让使用者能够访问。

### 2. 在 Memoh 里添加渠道

在 Memoh:

1. 打开 Bot 的 **平台** 标签页。
2. 点 **Add Channel**,选择 **DingTalk**。
3. 填入 **App Key** 和 **App Secret**。
4. 点 **Save and Enable**。

Memoh 会自动维护钉钉 Stream 长连接,不需要粘贴 webhook 回调地址。

## 凭据

| 字段 | 必填 | 说明 |
|------|------|------|
| **App Key** | 是 | 钉钉应用的 Key,在钉钉开放平台的应用凭据处复制。 |
| **App Secret** | 是 | 钉钉应用的 Secret,与 App Key 在同一处复制。 |

## 验证

私聊给 Bot 发送 `/help`,或在群聊中 @Bot 并发送 `/help`。Bot 回复命令列表,说明渠道已接通。

## 群聊

Bot 支持钉钉群聊:在支持的群里 @Bot 即可触发回复。

## 停用与更换凭据

随时可在 Bot 的 **平台** 标签页停用或移除该渠道。更换凭据时,在同一面板更新 **App Key** / **App Secret** 并保存即可。
