跳到主要内容

在 Voxsig 中配置 Webhooks

Webhooks 是在每个帐户中定义的 HTTP 回调。当 Voxsig 中发生像消息创建这样的操作时,将触发这些事件。您可以为一个帐户创建多个 Webhooks。

步骤 1 点击设置侧边栏中的集成链接。接下来,点击 "配置" 按钮。

集成

步骤 2。您将看到您已经添加到帐户的 Webhooks 列表。

配置

步骤 3。点击 "添加新 Webhook",它将显示一个模态对话框,您可以在其中输入应该发送 POST 请求的 URL。接下来,您需要选择要订阅的事件。此选项将允许您仅收听 Voxsig 中的相关事件。

添加 Webhook

Voxsig 将向已配置的 URL 发送包含以下内容的 POST 请求,以通知您帐户中发生的各种更新。

一个示例的 Webhook 数据

{

"event": "message_created", // 事件名称
"id": "1", // 消息 ID
"content": "Hi", // 消息内容
"created_at": "2020-03-03 13:05:57 UTC", // 发送消息的时间
"message_type": "incoming", // 这将具有类型 incoming、outgoing 或 template。小部件的用户发送传入消息,而客服代理向用户发送传出消息。
"content_type": "enum", // 这是一个枚举,它可以是 input_select、cards、form 或 text。如果 content_type 是其中之一,消息类型将是 template。默认值是 text。
"content_attributes": {} // 这将是一个对象,下面定义了不同的值
"source_id": "", // 如果渠道是 Twitter 或 Facebook 集成,则这将是外部 ID。
"sender": { // 提供发送此消息的客服代理的详细信息
"id": "1",
"name": "Agent",
"email": "[email protected]"
},
"contact": { // 提供发送此消息的用户的详细信息
"id": "1",
"name": "contact-name"
},
"conversation": { // 提供对话的详细信息
"display_id": "1", // 这是您在仪表板中看到的对话 ID。
"additional_attributes": {
"browser": {
"device_name": "Macbook",
"browser_name": "Chrome",
"platform_name": "Macintosh",
"browser_version": "80.0.3987.122",
"platform_version": "10.15.2"
},
"referer": "http://www.voxsig.com",
"initiated_at": "Tue Mar 03 2020 18:37:38 GMT-0700 (Mountain Standard Time)"
}
},
"account": { // 提供帐户的详细信息
"id": "1",
"name": "Voxsig",
}
}

此处找到 Webhooks 支持的事件的完整列表。