Webhook 的作用
Webhook 会在店铺中发生某个事件的那一刻，把该事件的详情发送到另一个地方。由你选择事件和发送目标：
- API：Storeep 把事件数据发送到一个网址（URL），可以是你的服务器、CRM、Zapier 或 Make 场景，或广告追踪工具。
- 电子邮件：Storeep 把事件数据发送到一个邮箱地址，例如让你每个新订单都收到一封邮件。
打开设置 > Webhook。你需要设置权限。
很多工具已经有现成的应用，用起来更简单：Google Sheets、快递网络和广告像素。请先查看应用市场。
创建 Webhook
点击添加新的网络钩子，填写表单，然后点击添加。
- 启用：默认勾选。勾选时，事件会立即发送。取消勾选可以保留 Webhook 但暂停它。
- 名称：列表中的标签，例如“CRM 新订单”。
- 类型：API 或电子邮件。
- 事件：
- 订单已创建：客户下了一个新订单。
- 订单已更新：订单的状态或详情发生变化。
- 会话已创建：有新访客来到你的店铺。仅限 API 类型。
- 格式：Json。
- 网址（API 类型）：发送的目标地址。
https://部分会自动加上，所以只需输入其余部分，例如api.example.com/orders。 - 电子邮件地址（电子邮件类型）：邮件发往的地址。
电子邮件 Webhook 只发送订单事件。如果你选择电子邮件类型并搭配会话已创建，不会发送任何内容。
在 URL 中放入订单数据
你可以用双花括号 {{field_name}} 把事件数据中的任意字段放进 URL。例如：
example.com/postback?cid={{fbclid}}&payout={{order_total}}
这样会把 Facebook 点击 ID 和订单总额发送到广告追踪或联盟平台，无需额外的服务器。不存在的字段会变为空值。要查看字段名称，请为同一事件创建一个电子邮件 Webhook，看看你收到的数据。
Webhook 列表
每一行显示名称、URL / 电子邮件、类型、事件、格式和状态（激活或停用）。点击某一行进行编辑。勾选若干行并选择删除网络钩子即可永久删除。每个店铺的 Webhook 数量有上限，达到上限时你会看到提示。
你可以为同一事件创建多个 Webhook，例如一个发到 CRM，一个发到广告追踪工具。
发送失败时
- 你的服务器应快速返回成功状态码（2xx）。响应太慢会被视为失败。
- 如果你的服务器宕机或繁忙（返回 5xx 或 429，或没有响应），Storeep 会在接下来几分钟内重试多次。只有失败的 Webhook 会被重试，所以其他 Webhook 不会收到重复数据。
- 如果你的服务器拒绝请求（返回 4xx，例如 404 或 403），Storeep 不会重试，因为地址或其安全设置有误。
- 当某个 Webhook 连续多次失败时，店铺所有者会收到一封邮件：“需要处理：您的 Storeep Webhook 投递失败”，其中包含 Webhook 名称、地址、事件和最后一次错误代码。Webhook 恢复正常后，以后再出问题时会再次发送警告。你可以在通知中关闭这封邮件。
- 电子邮件 Webhook 只发送一次，不会重试。
因欠款而暂停的 Webhook
如果你的店铺有未付的应付金额，而钱包余额不足以支付，Webhook 会等待。你充值并结清金额后，它们才会被发送。请参阅钱包和账单。
小贴士
- 如果你的服务器需要密码或密钥，把它放在 URL 查询参数中，例如
?key=yoursecret。 - 会话已创建会对每个访客触发，在流量大的店铺中可能数量很多。只有在你的服务器能承受时才使用。
- 如果想让某个工具随时读取你的订单和产品，请改用访问令牌。