飞书webhook如何精准@指定人员或部门而不打扰其他人？

Question

在使用飞书Webhook时，如何精准@指定人员或部门而不打扰其他人？ 常见问题：通过飞书Webhook发送消息时，如果需要@特定用户或部门，但避免全体通知干扰无关人员，应如何设置？目前飞书Webhook支持通过`at`字段指定用户（UserID、邮箱或手机号）或部门ID。只需在消息JSON中正确配置`at`参数，例如`"at": {"user_ids": ["user1", "user2"]}`或`"at": {"department_ids": [123]}`，即可仅通知目标对象。同时，确保消息内容中不包含`@all`，否则会覆盖精准通知设置。此外，若需测试，可利用飞书提供的沙盒环境验证配置效果。

Answer 1

使用飞书Webhook精准@指定人员或部门的详细指南

在企业协作场景中，通过飞书Webhook发送消息时，如何确保通知到目标用户或部门而不打扰其他人？以下是针对该问题的逐步解析与解决方案。

1. 基础概念：飞书Webhook的工作原理

飞书Webhook是一种通过HTTP POST请求向飞书机器人发送消息的方式。开发者可以自定义消息内容和格式，同时支持精准通知特定用户或部门。

• Webhook消息通常以JSON格式传递。
• `at`字段用于指定需要通知的对象。
• 避免使用`@all`，否则会覆盖精准通知设置。

2. 配置方法：如何精准@指定人员或部门

以下是一个具体的配置示例：

{
  "msg_type": "text",
  "content": {
    "text": "请相关负责人尽快处理任务！"
  },
  "at": {
    "user_ids": ["user1", "user2"],
    "department_ids": [123]
  }
}

上述代码中，`user_ids`指定了两个用户（`user1`和`user2`），`department_ids`指定了一个部门（ID为123）。这些对象将收到通知，而其他用户不会被打扰。

3. 注意事项：避免常见错误

问题	原因	解决方法
所有人均被通知	消息内容中包含`@all`	检查并移除`@all`关键字
指定用户未收到通知	`user_ids`或`department_ids`填写错误	确认用户ID或部门ID是否正确
消息未发送成功	Webhook URL无效或权限不足	验证URL有效性，并确保机器人有权限

4. 测试与验证：利用沙盒环境

为了确保配置无误，建议使用飞书提供的沙盒环境进行测试。以下是测试步骤：

1. 登录飞书开发者后台，创建一个测试机器人。
2. 获取机器人Webhook URL，并将其用于发送测试消息。
3. 根据实际需求调整`at`字段的值，观察通知效果。

通过沙盒环境，可以快速定位并修复配置问题。

5. 实际案例分析：多场景应用

以下是几种常见的应用场景及其对应的配置：

场景一：通知项目组成员

假设项目组包含用户`project_user1`和`project_user2`，可以通过以下配置实现：

"at": {"user_ids": ["project_user1", "project_user2"]}

场景二：通知整个部门

若需通知部门ID为200的所有成员，可使用：

"at": {"department_ids": [200]}

流程图：消息发送与通知机制

sequenceDiagram
        participant User as 用户
        participant Webhook as 飞书Webhook
        participant Feishu as 飞书服务器
        User->>Webhook: 发送JSON消息
        Webhook->>Feishu: 转发消息至飞书
        Feishu->>User: 根据`at`字段通知目标对象