Webhook推送消息

html

一、什么是webhook?

简单地说,webhook 是一个 API 端点,当事件发生时外部服务调用它。 也是应用给其它应用提供实时信息的一种方式。信息一产生,webhook 就会及时将信息推送过去,这就意味着你能实时得到数据。

目前企业微信、钉钉、飞书 均支持添加webhook机器人。

利用这个功能,我们可以实现某些场景下的需求:

  1. 作为社区的管理员,不可能时刻盯着后台去刷新是否有内容需要审核,是否有用户申请加入版块等。 因此,如果一旦有用户发起这些请求,社区管理员能及时收到提醒就好了。
  2. 作为社区的运营,总是在苦恼如何让社区更加活跃,社区有好的内容,新的内容发布时,如果能及时推送给社区的用户,不仅能吸引用户的注意,增加日活,也能及时召回用户。(这个可能有所受限,企业微信群外部群无法实现)
  3. 作为社区的资深用户,我不想错过社区每一个内容的更新。

基于第1种使用场景,我们可以配置管理类消息推送,

基于第2种,第3种使用场景,我们可以配置用户端的消息推送。

管理类消息支持短信推送和webhook机器人推送,2种方式。

二、管理类推送消息

位置:后台运营-消息管理-管理类消息

开启需要推送的消息模板,推送可选择webhook推送,或短信通知推送。

(一) 短信通知

短信接收:填写接受管理类消息的手机号(管理类消息是针对社区管理员的推送,一般推荐推送给后台管理员、版主、超级版主)等 您需要让他及时收到管理消息的用户。

输入手机号+备注,备注方便后期查看此手机号隶属于谁。

添加完成后如遇到此手机号机主离职,可删除此手机号。

(二) webhook配置

目前支持钉钉,企微,飞书的webhook机器人添加配置。

以企业微信为例:

在群信息中添加群机器人。

PC端企业微信如下图:

选择添加机器人,新创建一个机器人

可为机器人配置专属头像和名称。

添加完机器人,将获得机器人的webhook地址,复制地址,填入短说后台对应位置并点击“添加”:

此外需要注意的是:请阅读配置说明,保护好机器人的webhook地址噢~

出于更安全的情况下考虑,也可为推送机器人配置ip白名单:

注:仅配置的IP列表可调用webhook地址以发送消息(不配置则任何IP都可调用)

手机端企业微信如下图:流程和PC端企业微信操作相似。获取webhook地址配置在短说后台即可。

管理类消息推送实例效果,当用户提交的内容触发审核时:

如配置了短信推送的效果(需购买短说云短信服务套餐)联系客户经理购买:

三、用户端消息推送

(一) 权限配置

权限配置,即哪些用户可在用户端自行配置用户端的消息推送,可在后台配置对应的用户组,或此功能如不想开放给普通用户,只开放给公司运营部分人员,也可指定用户。

拥有此权限的用户,在用户端的个人中心会出现配置入口。

此处使用帮助,是指: 如您开放给您的平台用户此功能,即您需要站在用户的角度上,为他们写一份使用教程,教会他们如何使用webhook。

(二) 如何配置用户端消息推送

拥有权限的用户,在个人中心找到“消息推送”入口,进入可添加webhook机器人。

名称为机器人的名称,推送指的是推送到“企业微信”“钉钉”或者:飞书“群里,需要将哪个内容更新推送到群里。

目前我们支持版块中有新的内容产生时,推送该内容的标题摘要至群内,用户点击后可直接跳转至该内容详情,也支持频道中有新的内容产生时,推送该内容的标题摘要至群内,用户点击是进入该频道的列表(注意,因频道内容刷新有刷新频率的时差,可能10分钟刷新一次,此时,会推送该频道内这10分钟内所有的新的内容至群内,因此用户点击跳转是直接进入频道的列表页面,而非内容详情页。)

需要将内容更新推送至哪个群,则去该群内添加机器人,获取webhook的地址。具体参考上文管理类推送消息中第二部分“webhook”配置的内容。

客户实际案例效果如下:

四、补充说明之钉钉机器人配置

在需要推送消息的群内找到设置项,进入设置页面

找到机器人,添加机器人

点击添加机器人

选择自定义机器人,并点击添加

钉钉对机器人的安全要求较高,必须选择至少一种安全配置选项:

可以选择加签或者加IP地址,如果选择加IP地址,则只有该IP下才能处理请求。

可根据自身需要配置安全选项,然后点击阅读同意条款后点击完成。

此时可以看到机器人的webhook地址:

复制webhook地址,如果有配置签名的话,需一起配置至短说后台。

加签的安全签名如果一开始没复制,可在群内点击机器人头像,选择机器人设置,可以再次看到签名和webhook地址。

配置完成后,在短说后台点击添加即可完成后台的机器人推送配置。

推送效果实例(以管理类消息为例):

五、补充说明之飞书机器人配置

在需要推送消息的群内找到找到机器人添加入口,添加机器人

选择自定义机器人:

设置机器人名称和描述,机器人名称会对应出现在机器人的昵称处,请注意设置:

配置方式和钉钉/企业微信类似,添加完成后可获取到webhook的地址。

安全设置类似钉钉,可选择使用ip白名单或签名校验等方式,如设置了签名,也需要将签名填写至短说后台。

推送示例参考:

客服微信二维码
咨询客服小番茄
公众号二维码
扫码关注公众号