当使用语雀平台维护文档时,文档发生变化时,希望能及时通知到组内协作人员。如果刚好团队内部使用钉钉沟通,就可以通过添加webhook来实现即时通知提醒。webhook是钉钉对外开放的web钩子,是一个接口地址,通过传参并调用接口,可以实现向钉钉群发送消息。
操作步骤主要如下:
- 钉钉内添加机器人,生成webhook地址
- 语雀内设置webook
第一步:钉钉内添加机器人
1. “个人设置”内,选择“机器人管理”。
2. 机器人管理弹窗内,添加机器人选择“自定义”选项。
3. 添加机器人弹窗内,信息补充完整。“安全设置”里自定义关键词需要填“语雀”。
4. 添加机器人弹窗点击“完成”,生成webhook地址。复制webhook地址。
以下方法可快速验证机器人是否工作:
curl 'https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx' \
-H 'Content-Type: application/json' \
-d '{"msgtype": "text","text": {"content": "文件监控测试-您修改了公共文件,请联系testest,并谨慎处理。"}}'
第二步:语雀内设置webook
1. 选择某一个“知识库”。
2. 知识库点击“设置”。
3. 添加webhook。
仅管理员才有开发者设置权限。
当勾选“仅主动推送更新触发”时,在文档发布和更新时,需要主动勾选下面的选项。