当 LemonX 操作在 WordPress 内发生时触发外部工作流程。

现代 WordPress 工作流程不应等待手动检查。

AI 支持的网站会生成许多事件：新草稿、内容预览、SEO 分析、翻译任务、索引请求、MCP 操作、报告生成、使用更改和许可证更新。如果没有 webhook，外部系统必须反复询问 WordPress 是否有任何更改。

Webhook 逆转了这一流程。 LemonX 会在重要事件发生时告诉您的系统。

跨 LemonX Suite 的 Webhook 事件。

LemonX Webhooks 应遵循与 LemonX 生态系统相同的产品结构。每个产品都可以发出与其自身工作流程相关的事件，而共享系统事件则处理任务、报告、许可证、使用情况和安全性。

使用标头来验证和处理交付。

X-LemonX-Event: MCP.preview_applied
X-LemonX-Delivery: lx_delivery_123456
X-LemonX-Timestamp: 1783178400
X-LemonX-Signature: sha256=...
X-LemonX-Site: site_abc123
X-LemonX-Version: 1
User-Agent: LemonX-Webhooks/1.0

Webhook 签名验证示例。

确切的实现可能有所不同，但一般模式是相同的：结合时间戳和原始有效负载，使用共享密钥生成 HMAC 签名，然后将其与签名标头进行比较。

signed_payload = timestamp + "." + raw_body
expected_signature = HMAC_SHA256(webhook_secret, signed_payload)
compare expected_signature with X-LemonX-Signature

function verify_lemonx_webhook( $raw_body, $timestamp, $signature_header, $secret ) {
    if ( empty( $raw_body ) || empty( $timestamp ) || empty( $signature_header ) || empty( $secret ) ) {
        return false;
    }

    $tolerance = 300;
    if ( abs( time() - (int) $timestamp ) > $tolerance ) {
        return false;
    }

    $signed_payload = $timestamp . '.' . $raw_body;
    $expected = 'sha256=' . hash_hmac( 'sha256', $signed_payload, $secret );

    return hash_equals( $expected, $signature_header );
}

Webhook 传递应该处理临时故障。

Webhook 端点可能因多种原因而失败：网络问题、停机、速率限制、部署窗口或临时错误。 LemonX 应支持失败交付的重试行为。

以编程方式管理 Webhook。

开发人员可以使用 REST API 端点来注册和管理 Webhook。这些端点名称是示例，应与最终的 LemonX 实现相匹配。

GET    /wp-json/lemonx/v1/webhooks
POST   /wp-json/lemonx/v1/webhooks
GET    /wp-json/lemonx/v1/webhooks/{id}
PATCH  /wp-json/lemonx/v1/webhooks/{id}
DELETE /wp-json/lemonx/v1/webhooks/{id}
POST   /wp-json/lemonx/v1/webhooks/{id}/test
POST   /wp-json/lemonx/v1/webhooks/{id}/rotate-secret
GET    /wp-json/lemonx/v1/webhooks/{id}/deliveries
POST   /wp-json/lemonx/v1/webhooks/deliveries/{delivery_id}/resend

{
  "name": "Agency Dashboard",
  "url": "https://agency.example.com/lemonx/webhook",
  "events": [
    "content.updated",
    "aeo.analysis_completed",
    "verto.translation_completed",
    "MCP.preview_applied",
    "report.generated"
  ],
  "status": "active"
}

{
  "success": true,
  "data": {
    "id": "wh_123",
    "name": "Agency Dashboard",
    "url": "https://agency.example.com/lemonx/webhook",
    "status": "active",
    "events": [
      "content.updated",
      "aeo.analysis_completed",
      "verto.translation_completed",
      "MCP.preview_applied",
      "report.generated"
    ],
    "secret_preview": "whsec_****abcd"
  }
}

仅订阅您的系统需要的事件。

繁忙的 WordPress 站点可以举办许多活动。开发人员应避免将所有可能的事件发送到每个端点。相反，创建集中的 Webhook 订阅。

将 LemonX 与 Make、n8n、Zapier 风格的工作流程和内部系统连接起来。

Webhook 使将 LemonX 工作流程与自动化平台连接起来成为可能。当 LemonX 事件发生时，自动化平台可以接收有效负载并触发下一步。

使用 webhooks 做出反应。使用 REST API 来请求。

摘要：REST API 是基于请求的。 Webhook 是基于事件的。最重要的集成应该同时使用两者。

建议的事件命名约定。

product.resource_action

content.draft_created
content.updated
aeo.analysis_completed
verto.translation_completed
MCP.preview_applied
report.generated
license.status_changed
usage.quota_warning
security.api_key_revoked

仅发送集成所需的事件数据。

Webhook 有效负载应包含足够的数据来识别和处理事件，但应避免发送不必要的敏感信息。