飞书配 WorkBuddy 提示「无法检查链接」？官方说别重复填同一个地址

飞书后台填 Webhook 地址，点保存，弹出来「无法检查链接」。你以为是地址填错了，把同一个地址删掉重填一遍——还是这个提示。再填一遍，还是。

官方常见问题页对这个现象有专门的说明，而且指出的原因跟大多数人的第一反应正好相反：

现象：重复输入同一 Webhook 地址后可能出现该提示。 官方做法：重新创建或重新填写一次配置，避免重复输入同一地址；仍失败则保留提示信息反馈。

关键词是「避免重复输入同一地址」——你越是反复粘同一个地址重试，越可能一直卡在这儿。

本文依据 WorkBuddy 官方常见问题页 From-Beginner-to-Expert-Guide/FAQ 与官方飞书接入文档，核对日 2026-08-16。飞书侧的平台规则以飞书官方为准。我们没有安装客户端，本文不含实测数据。

一、正确的处理动作

官方给的是「重新创建或重新填写一次配置」。注意这句话里的「配置」指的是 WorkBuddy 侧的配置，不是飞书后台那个输入框。

执行顺序：

1. 回到 WorkBuddy 客户端的飞书集成配置处；
2. 重新创建或重新填写一次配置，让它生成一个新的地址；
3. 拿新生成的地址去飞书后台填；
4. 保存。

跟大多数人的做法差别在第 2 步：不是在飞书后台反复重填，而是回到 WorkBuddy 这边重来一次。

二、为什么反复重填同一个地址没用

从现象描述能看出这个提示跟「重复输入同一地址」这个动作有关联。所以在飞书后台把同一个地址删掉、再粘一遍、再删、再粘——这个循环本身可能就是触发条件，重复多少次都不会有不同结果。

跳出循环的办法是换一个地址，而地址是 WorkBuddy 侧生成的，所以要回那边重新配。

三、跟企业微信那条别搞混

同一份 FAQ 里，企业微信也有一条 Webhook 相关的，但做法方向正好相反：

	飞书	企业微信
现象	提示「无法检查链接」	提示「域名主体校验未通过」
官方指出的成因	重复输入同一地址后可能出现	企业微信侧会对地址做域名主体校验
官方做法	重新创建或重新填写配置，避免重复输入同一地址	核对地址是否完整、是否与当前配置要求一致
方向	换一个新地址	确保就是那个正确地址

一个让你换，一个让你核对。配多平台接入的时候按错了平台的思路走，会越弄越乱。

四、飞书接入的两个权限前提

在折腾 Webhook 之前，先确认这两条满足——不满足的话后面怎么配都是白搭。

官方飞书接入文档写明，需要：

• 企业账号；
• 创建应用的权限。

个人版飞书账号进不了开发者后台的应用创建流程；企业账号但没有创建应用权限的，得让管理员开权限或者由管理员来操作。

另外还需要拿到 App ID 与 App Secret，并配置相应的权限范围。这些的具体位置以官方飞书接入文档为准——它是一篇独立的指南，配置前完整读一遍比看零散教程稳妥。

五、能不能不填 Webhook

这是最值得先问的一个问题。

看官方钉钉接入文档里对两种模式的说明就明白了：

模式	官方描述的适用人群	要不要公网地址
WebSocket 长连接	个人 / 家庭 / 办公室用户（没有公网 IP）。配置更简单，不需要公网地址，开箱即用	不需要
URL 回调	有服务器、有公网 IP 的用户	需要，还要回平台后台配置

如果你没有公网 IP、也不打算维护服务器，优先选不需要公网地址的那种连接方式——Webhook 相关的这一整类问题就不会出现。

很多人是照着某篇教程一路走到回调这条路上的，其实自己的场景根本不需要。配之前先想清楚：你有没有一个稳定的、可对外访问的地址？

六、还是不行，提交时带这些

官方给的是「保留提示信息反馈」。整理成这样：

【接入平台】飞书
【提示原文】____（截图，截全）
【已试过】回 WorkBuddy 侧重新创建配置并用新地址填写，结果 ____
【地址检查】协议头 https ✓ ；无首尾空白 ✓ ；完整未截断 ✓ ；是新生成的地址（非旧地址）✓
【飞书侧】企业账号 ✓ ；有创建应用权限 ✓ ；App ID/Secret 已配置 ✓ ；权限范围已申请 ✓
【接入方式】WebSocket 长连接 / URL 回调
【官方条目】FAQ 已记录「重复输入同一地址后可能出现该提示」

「地址检查」那几项值得逐一打勾。首尾空白是最阴的一个——复制粘贴时带进去的空格或换行，肉眼完全看不出来。把地址先粘到纯文本编辑器里看一眼，比在两个网页输入框之间直接来回复制靠谱。

反馈入口：客户端右上角「帮助」下拉框，或右下角头像 → 设置 - 帮助与反馈 - 意见反馈，描述问题、上传截图并勾选「上传日志」提交。官方支持邮箱 workbuddy@tencent.com。

七、配通之后还不回复

那是另一条官方条目——「已完成接入但发送消息无响应」。官方做法：

1. 先确认当前连接状态是否仍在线；
2. 优先切换模型后再次测试（官方说明部分无响应问题可通过切换模型缓解）；
3. 微信场景若长时间无响应，建议断开后重新连接；
4. 若首次可用、后续失效，记录复现时间与平台类型便于进一步排查。

还有一个最容易被忘的前提：这条链路的终点是你自己电脑上正在运行的客户端。电脑关机、休眠、客户端退出了，机器人一定不回复——这跟飞书配置一点关系没有，在后台里怎么查都查不出来。

配完测试不通的时候，先看一眼电脑那头是不是活着。三秒钟的事，能省掉一小时。

小结

• 官方说明：重复输入同一 Webhook 地址后可能出现「无法检查链接」。
• 官方做法：回 WorkBuddy 侧重新创建或重新填写一次配置，用新生成的地址去飞书填；避免重复输入同一地址。
• 别在飞书后台反复重填同一个地址——那个循环本身可能就是触发条件。
• 跟企业微信那条方向相反：飞书是「换一个新地址」，企业微信是「核对是不是那个正确地址」。
• 飞书接入的前提：企业账号 + 创建应用权限，还要 App ID / App Secret 与权限范围。
• 没有公网 IP 就选不需要公网地址的连接方式，这一整类问题从根上不会出现。
• 配通后不回复是另一条：确认连接状态 → 优先切换模型 → 记录复现时间与平台类型。
• 链路终点是你那台开着机的电脑。

功能与文档表述以官方为准，飞书侧规则以飞书官方为准，核对日 2026-08-16。