> ## 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.

# Feishu Webhook

> Feishu event subscription webhook — URL verification and message receiving

The event subscription callback endpoint for the Feishu Open Platform. This endpoint **does not require authentication** and is called directly by Feishu servers.

### Supported Event Types

| Event Type              | Description                                                    |
| ----------------------- | -------------------------------------------------------------- |
| `url_verification`      | URL verification (sent by Feishu during initial configuration) |
| `im.message.receive_v1` | Receive user messages                                          |

### Flow

1. Feishu sends `url_verification` → returns `{ challenge }` to complete verification
2. User sends a message in Feishu → triggers `im.message.receive_v1` event
3. Deduplication check (`event_id`) → asynchronous background processing → quickly returns `{ code: 0 }` to Feishu

<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\":\"Help me check today'\''s schedule\"}"
        }
      }
    }'
  ```
</RequestExample>

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

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