Webhook 仅适用于高级计划及以上版本。

连接各种系统和服务，如电子邮件营销平台、CRM 工具、电子商务平台和项目管理软件，以在 respond.io 上接收实时平台更新。通过将您的 webhook URL（REST 端点）与平台连接，您可以将相关事件与您的 CRM 和数据库同步，确保所有系统中的信息准确且最新。

配置

步骤 1：在您的工作区设置中，导航至 集成 > Webhook > 单击连接

步骤 2：单击 添加 Webhook 按钮以添加 端点 URL 并选择 Webhook 事件

需要特定的 URL 端点来接收和处理请求。

Webhook 事件

以下是 webhook 事件的一些常见用例：

会话已关闭 - 每当会话关闭时，自动更新联系人信息或将会话详情保存到第三方应用/系统以便存档，并跟踪已关闭会话的数量以进行分析.
新增联系人 - 每次添加新联系人时，自动将其加入CRM、发送欢迎信息，并通知相关团队成员.
新外发消息 - 每当发送新的外发消息时，自动为每条消息发送通知，在CRM中记录消息详情，并根据消息内容分配标签或潜在客户评分.
新入站消息 - 每当收到新的入站消息时，自动为每条消息发送通知，在CRM中记录消息详情，并根据消息内容分配标签或潜在客户评分.
联系人已更新 - 每当联系人信息更新时，自动在CRM中同步更新并向相关团队成员发送变更通知.
会话已开启 - 每当会话开启时，自动实时通知团队成员并打开会话详情.
联系人负责人已更新 - 每当联系人的负责人变更时，自动在成员被分配到新联系人时通知他们，并管理后续任务或提醒.
联系人标签已更新 - 每当联系人标签更新时，自动更新潜在客户评分，管理电子邮件营销列表，并根据联系人标签发送定向营销活动.
新评论 - 每当添加新评论时，自动通知团队成员并在respond.io与其他系统之间同步评论.
通话结束（语音） – 每当语音通话结束（无论已接通或未接听），会自动将通话相关数据发送到您的外部系统，例如 CRM、分析工具或内部报表平台。这些信息可能包括通话状态、通话时长、坐席或语音 AI 坐席的详细信息；如果已启用，还会包括通话录音、转写和通话摘要。

在我们的 Webhooks API 文档中了解通过这些 Webhook 事件可以传递的更多信息.

常见问题与故障排查

为什么我的Webhook会自动禁用，我该如何重新激活它？

如果失败尝试数在30分钟内超过30次，您的Webhook可能会自动禁用。请注意，此错误配额在所有Webhook之间共享。如果发生这种情况，您将收到一封关于该失败的电子邮件通知。为了避免被禁用，请定期监控您的端点日志以查看失败的Webhook事件。

此外，您的端点必须在5秒内返回200 OK 响应。未能做到这一点将计入您的错误配额，并可能导致自动禁用。

要重新激活您的Webhook，请按照以下步骤操作：

导航到您的 工作区设置
导航到集成 > Webhooks
找到您的Webhook并在操作列中单击启用

要查看 Webhook 事件日志，您可以为该功能请求投票.

为什么我从 respond.io 接收的 Webhooks 会延迟？

如果您的端点未在5秒内响应，则会发生延迟，这会导致我们的Webhook系统重试并将事件排入队列。我们的运行方式如下：

我们按端点对事件进行分组，以防止任何单个端点使系统过载。
事件按顺序处理，如果您的端点响应时间过长，重试将在30、60和90秒后进行，最长可达3分钟，然后事件将被丢弃。

为避免延迟，我们建议您优化系统处理传入 Webhook 的方式。这将有助于确保事件及时交付。

为什么我在 Webhook 有效负载中看不到通话录音、转录或摘要？

Webhook 事件中的通话相关数据取决于您的工作区设置。如果通话录音、转录或通话摘要被禁用，相应字段将在有效负载中返回为 null 或被省略。未接来电不包含录音、转录或摘要。