飞书机器人如何分享消息到群组？

Question

**问题描述：** 在使用飞书机器人时，开发者常遇到如何将消息准确分享到指定群组的问题。常见疑问包括：如何配置机器人的群组权限、如何通过 Webhook 或 Open API 发送消息到特定群聊、以及如何处理鉴权和消息格式等技术细节。例如，调用消息接口时返回“群组不存在”或“权限不足”的错误，应该如何排查？此外，如何实现机器人在多个群组中自动同步消息？这些问题直接影响到飞书机器人在企业内部沟通与自动化流程中的应用效果。

Answer 1

一、飞书机器人消息推送基础概念

飞书机器人是企业内部自动化流程的重要组成部分，常用于消息通知、任务提醒、数据展示等场景。要实现消息准确推送到指定群组，首先需要理解飞书开放平台的基本架构和权限体系。

飞书机器人分为“群机器人”和“应用机器人”两种类型：

• 群机器人：绑定到具体群聊，通过 Webhook URL 发送消息，适用于单一群组的自动化场景。
• 应用机器人：作为企业应用的一部分，可通过 Open API 发送消息至多个群组，适用于复杂的企业级应用。

消息推送流程如下（mermaid 流程图）：

```mermaid
graph TD
    A[开发者配置机器人] --> B[获取 Webhook URL 或 App Token]
    B --> C{发送方式}
    C -->|Webhook| D[向指定群组发送消息]
    C -->|Open API| E[调用消息接口发送]
    D --> F[验证 Webhook 是否有效]
    E --> G[验证 App 权限和群组权限]
    F & G --> H{是否成功}
    H -->|是| I[消息成功发送]
    H -->|否| J[查看错误码并调试]
```

二、配置机器人权限与群组绑定

在使用飞书机器人前，开发者需要在飞书开放平台中完成机器人的创建与权限配置。

1. 进入 飞书开放平台，创建自定义机器人或企业自建应用。
2. 为机器人配置“群消息”权限，确保其具有向群组发送消息的权限。
3. 将机器人添加到目标群组中，确保其在群内可见。

权限类型	描述	应用场景
群消息权限	允许机器人向群组发送消息	适用于所有需要向群组推送消息的场景
用户权限	允许机器人读取用户信息	用于个性化消息推送或身份验证
日历权限	允许机器人访问日历事件	用于日程提醒、会议通知等

如果调用接口返回“权限不足”，请检查：

• 是否已为机器人分配“群消息”权限。
• 机器人是否已被添加到目标群组。
• 应用是否已通过企业管理员审核。

三、通过 Webhook 发送消息到指定群组

对于群机器人，开发者可直接通过 Webhook URL 发送消息。该方式适用于简单、快速的消息推送。

使用 Webhook 的步骤如下：

1. 在飞书群组中添加机器人，获取 Webhook URL。
2. 构造符合飞书消息格式的 JSON 数据。
3. 通过 HTTP POST 请求发送至 Webhook URL。

示例代码（Python）：

```python
import requests
import json

webhook_url = "https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-token"

message = {
    "msg_type": "text",
    "content": {
        "text": "这是一条测试消息！"
    }
}

response = requests.post(webhook_url, data=json.dumps(message))
print(response.text)
```

如果调用返回“群组不存在”，请检查：

• Webhook URL 是否正确。
• 机器人是否仍存在于目标群组中。
• 群组是否已被解散或重命名。

四、通过 Open API 发送消息到多个群组

对于需要向多个群组发送消息的场景，建议使用飞书 Open API。这种方式支持更复杂的权限管理和消息格式。

调用 Open API 的基本流程如下：

1. 获取 App Token 和 App Secret。
2. 调用 /open-apis/auth/v3/tenant_access_token/internal/ 接口获取访问令牌。
3. 调用 /open-apis/im/v1/messages 接口发送消息。

发送消息的示例请求（JSON）：

```json
POST /open-apis/im/v1/messages?receive_id_type=chat_id
Authorization: Bearer t-xxx
Content-Type: application/json

{
  "receive_id": "oc_xxx",
  "msg_type": "text",
  "content": "{ \"text\": \"这是一条测试消息！\" }"
}
```

如果返回“权限不足”，请检查：

• 应用是否已授权“消息发送”权限。
• 是否具有访问目标群组的权限。
• 是否使用了正确的 chat_id 或 open_id。

五、实现机器人在多个群组中自动同步消息

为了实现机器人在多个群组中自动同步消息，可以采用以下架构：

```mermaid
graph LR
    A[源群组消息] --> B[机器人监听消息]
    B --> C[解析消息内容]
    C --> D[查找目标群组列表]
    D --> E[并行调用 Open API 发送消息]
    E --> F[目标群组收到消息]
```

关键技术点包括：

• 监听源群组消息事件（如通过 Webhook 或事件订阅）。
• 维护目标群组 ID 列表，并确保机器人在这些群组中。
• 使用 Open API 并行发送消息以提高效率。
• 处理消息格式转换，确保不同群组接受的消息格式一致。

实现自动同步的注意事项：

注意事项	建议做法
消息重复	记录已发送消息 ID，避免重复推送
消息延迟	使用异步任务队列处理发送逻辑
错误重试	实现重试机制，如指数退避策略
权限变更	定期检查机器人是否仍在目标群组中