> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeus.agentspro.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 飞书 Webhook

> 飞书事件订阅 Webhook — URL 验证与消息接收

飞书开放平台的事件订阅回调端点。此接口**不需要认证**，由飞书服务器直接调用。

### 处理的事件类型

| 事件类型                    | 说明                |
| ----------------------- | ----------------- |
| `url_verification`      | URL 验证（首次配置时飞书发送） |
| `im.message.receive_v1` | 接收用户消息            |

### 流程

1. 飞书发送 `url_verification` → 返回 `{ challenge }` 完成验证
2. 用户在飞书发送消息 → `im.message.receive_v1` 事件
3. 去重检查（`event_id`）→ 后台异步处理 → 快速返回 `{ code: 0 }` 给飞书

<RequestExample>
  ```bash URL Verification theme={null}
  curl --request POST \
    --url https://zeus-api.agentspro.cn/channels/feishu/webhook \
    --header 'Content-Type: application/json' \
    --data '{
      "type": "url_verification",
      "challenge": "abc123",
      "token": "xxx"
    }'
  ```

  ```bash Message Event theme={null}
  curl --request POST \
    --url https://zeus-api.agentspro.cn/channels/feishu/webhook \
    --header 'Content-Type: application/json' \
    --data '{
      "header": {
        "event_id": "evt_001",
        "event_type": "im.message.receive_v1"
      },
      "event": {
        "message": {
          "content": "{\"text\":\"帮我查一下今天的日程\"}"
        }
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json URL Verification theme={null}
  {
    "challenge": "abc123"
  }
  ```

  ```json Message Event theme={null}
  {
    "code": 0,
    "msg": "success"
  }
  ```
</ResponseExample>