---
title: "Webhook"
description: "Webhook 是平台在发生某个事件（如消息已送达、已读或失败，或客户回复到达）时，向您提供的 URL 发送的 HTTP 请求，让您的系统无需轮询就能立即得知该事件。"
canonical: "https://omnichannels.ai/zh/glossary/webhook/"
language: "zh"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Webhook

Canonical: https://omnichannels.ai/zh/glossary/webhook/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

**定义:** Webhook 是平台在发生某个事件（如消息已送达、已读或失败，或客户回复到达）时，向您提供的 URL 发送的 HTTP 请求，让您的系统无需轮询就能立即得知该事件。

您注册一个端点（例如 https://example.com/hooks/messaging）。事件发生时，平台会发送一个带 JSON 请求体的 POST 请求来描述该事件：消息 ID、状态、时间戳、渠道和错误详情。您的服务器应迅速返回 2xx 状态码，并异步处理该事件。

请针对真实的投递情况来构建：webhook 可能延迟、乱序或重复到达。使用消息 ID 和状态去重，绝不要让状态倒退（例如从 READ 退回 DELIVERED），并保持可安全重试的幂等处理程序。

安全方面：只接受 HTTPS，对每个请求校验签名或共享密钥，在验证通过之前不要信任负载内容。Standard Webhooks 规范等行业惯例描述了常见的签名和重试模式。

在消息领域，webhook 为送达报告、已读率、上行回复、退订以及渠道回退决策提供数据。

OmniChannels.ai 为送达状态（SUBMITTED、SENT、DELIVERED、READ、FAILED、REJECTED）发送 webhook，并在各渠道间统一为同一种格式。

## 示例

```
{"messageId":"msg_123","channel":"whatsapp","status":"DELIVERED","timestamp":"2026-10-10T09:15:02Z"}
```

## 资料来源

- [Standard Webhooks specification](https://www.standardwebhooks.com/)