帮助中心集成

为了: 管理员

设置信息流活动的 webhook

当动态消息、评论或附件被添加、更改或删除时,向您的系统发送消息。

在本文中8 个部分

一个WebhookWebhook 您提供给中心的地址,以便中心可以在信息流帖子或评论发生更改时向您的系统发送消息。可以在某个案例的动态内容饲料 案件相关帖子的时间线,公司会在这里分享新闻,案件中的每个人都可以发表评论。发生某些变化时,向该系统发送消息。这些消息都是经过加密处理的,因此接收消息的系统需要依赖开发者的代码才能解密这些消息。

  1. 打开 Webhooks

    前往集成›Web钩子页面,然后选择新的选项。

  2. 请输入地址

    在网址下方,输入您系统中接收这些消息的地址。例如:https://crm.example.com/hooks/caseactive。该地址必须以https://或http://开头,并且能够从互联网访问到。输入时请保持大写字母的形式。

    描述是可选的:可以添加一些提示信息给团队,比如将案例信息同步到我们的CRM系统中。

  3. 选择活动

    在活动之下,选择那些需要发送消息的条目,比如帖子已创建和帖子评论已创建。总共有十个这样的条目,分别涉及到帖子、帖子的评论,以及被添加或删除的文件。可以查看webhook事件和负载内容,从而了解每个条目会发送什么内容。

  4. 打开并保存

    选择积极的作为触发条件。保持此设置不变:当webhook处于非活动状态时,它将不会收到任何消息,而错过的信息也不会被发送出去。接下来选择节省。此时会显示“已添加webhook”的提示。

  5. 保守秘密

    秘密Webhook窗口显示了web钩子的密钥:这个私钥用于解密它发送的所有消息。该信息仅显示一次。可以选择下载为 .pem 文件将其保存为文件,或者选择复制到剪贴板将其全部复制下来,包括换行符在内。请务必通过密码管理器等方式将密钥安全地传递给您的开发人员。然后选择完成。

  6. 测试一下

    在那些实际上没有任何客户对象的案例中添加一些简短的帖子吧,比如你的团队最初使用的那两个示例案例。让开发人员确认消息已经送达,并且密钥能够成功读取该消息。

接下来会发生什么?

每当你的中心系统中某个案例发生选定的事件时,网络钩子都会向你的系统发送一条消息,这条消息中会包含做出该变更的人们的信息:可能是你的团队、客户、虚拟助手虚拟助手 一个自动化的团队成员,负责发布欢迎信息、签到信息和公司动态;其发布的帖子带有虚拟助理徽章。,也可能是通过导入方式获得的信息,或者某个API密钥。其他任何人都不会收到这样的通知。

如果连续两次触发事件都失败,那么Webhook将停止发送通知,同时每个管理员都会收到电子邮件通知。请参阅修复无法发送Webhook的问题部分。要更改Webhook的地址或触发事件的条件,请选择该Webhook行中的铅笔图标。编辑 webhook。不过,相关的密钥信息保持不变。

如果出了什么问题

  • "Webhook限制已到达上限。” 您的中心可以配置五个Webhook。如果您不再需要使用某个Webhook,请将其删除:在相关行中选择对应的图标,然后点击删除 webhook、删除即可。删除后该Webhook将立即失效,无法恢复使用。
  • 该链接提示“链接无效”。正确的格式应该是:https://example.com/hook请完整输入链接地址,以https://或http://开头。仅在你自己的电脑上能使用的链接是不被接受的。
  • 你丢失了那个秘密信息。无法再次显示它了。请创建一个新的Webhook,使用相同的地址和事件类型;将秘密密钥提供给你的开发者,然后删除旧的Webhook吧。

相关文章

查找 webhook 事件和有效载荷十个信息流事件分别发送什么内容,消息是如何加密的,以及如何使用你的密钥解密。集成修复停止发送的 webhook为什么 webhook 在两次投递失败后或处于非活动状态时会停止,以及如何通过再次保存来重新启用它。集成了解 API 的功能了解管理密钥和中心密钥各自的权限范围,为什么每个密钥都充当虚拟助手,以及完整的技术清单在哪里。集成