Coze 中使用 Webhook 机制

在 Coze 中使用 Webhook 机制，主要涉及获取 Webhook 信息、配置外部系统和测试验证这几个关键步骤，以下为你详细介绍：

1. 获取 Webhook 信息

• 创建触发器：登录 Coze 平台，进入你要设置 Webhook 的 Bot 的设置页面，在 “Triggers”（触发器）区域，点击右上角 “+” 图标创建新触发器。选择触发类型时，挑选与 Webhook 相关的触发方式。
• 获取 URL 和 Bearer Token：创建好 Webhook 类型的触发器后，Coze 会提供对应的 URL 和 Bearer Token。URL 是外部系统发送请求的目标地址，Bearer Token 用于身份验证，确保请求的安全性。

2. 配置外部系统

• 构造 HTTP 请求：在外部系统中编写代码，构造一个 HTTP POST 请求。请求的目标地址就是 Coze 提供的 URL。
• 设置请求头：在 HTTP 请求的头部添加必要信息，包含Authorization字段，其值为Bearer <Bearer Token>，以此完成身份验证。同时，根据实际需求设置Content-Type，例如application/json。
• 设置请求体：根据 Coze 的要求，在请求体中添加所需的数据。数据格式要和Content-Type相匹配。比如Content-Type是application/json，请求体就应该是合法的 JSON 数据。

以下是一个 Python 示例代码，展示了如何使用requests库发送 Webhook 请求：

import requests

# 替换为Coze提供的URL和Bearer Token
url = "https://your-coze-webhook-url"
bearer_token = "your-bearer-token"

# 请求头
headers = {
    "Authorization": f"Bearer {bearer_token}",
    "Content-Type": "application/json"
}

# 请求体数据
data = {
    "key1": "value1",
    "key2": "value2"
}

# 发送POST请求
response = requests.post(url, headers=headers, json=data)

# 打印响应结果
print(response.text)

3. 测试验证

• 发送测试请求：在外部系统中运行代码，发送测试请求到 Coze 的 Webhook URL。
• 检查 Coze 响应：在 Coze 平台上查看是否成功接收到请求并触发了相应的工作流。同时，查看外部系统代码的响应结果，判断请求是否成功。若出现错误，根据错误信息进行排查和修正。
• 调试优化：如果测试未达到预期效果，仔细检查 HTTP 请求的各个部分，如 URL、请求头、请求体等，确保信息准确无误。也可以在 Coze 平台上检查触发器的设置是否正确。