问题根源在于飞书回调地址配置不当。需确保HTTPS服务可公网访问、实现challenge验证、正确填写回调地址、订阅im.message.receive_v1等事件、申请并审批消息读写权限，最后通过@机器人测试全链路。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在飞书开放平台创建自建应用，并希望将 DeepSeek V4 模型能力接入飞书机器人，但无法正常接收用户消息或触发响应，则问题很可能出在回调地址配置环节。飞书要求所有事件订阅必须通过可公开访问、支持 HTTPS 且已正确鉴权的回调地址接收事件。以下是配置飞书自建机器人回调地址的具体操作步骤：
一、确认回调服务已就绪并满足前置条件
飞书仅接受合法、可验证的 HTTPS 回调地址，且该地址必须能响应飞书发起的 GET 请求以完成地址验证。DeepSeek V4 的飞书集成需依赖一个运行中的后端服务，该服务需部署在公网可访问服务器上，并具备签名验签、事件解析与模型调用转发能力。该服务不可使用 localhost、127.0.0.1 或内网 IP 地址。
1、确保您的 DeepSeek V4 接入服务已部署完毕，监听端口（如 8000）并绑定有效域名；
2、为该域名配置有效的 SSL 证书，启用 HTTPS（推荐使用 Let’s Encrypt 免费证书）；
3、在服务代码中实现飞书回调地址验证逻辑：当飞书向回调地址发起 GET 请求并携带 challenge 参数时，需原样返回 challenge 值作为响应体，状态码为 200；
4、确认服务防火墙已放行 443 端口，且反向代理（如 Nginx）已正确透传请求头（特别是 X-Feishu-Signature 和 X-Feishu-Timestamp）。
二、在飞书开放平台填写回调地址
回调地址是飞书向您的服务推送用户消息、交互事件等数据的唯一入口，必须与后端实际监听地址完全一致（含协议、路径），且不能包含查询参数。路径部分需与服务路由严格匹配，例如 /webhook 或 /feishu/event。
1、登录飞书开放平台：https://open.feishu.cn；
2、进入对应自建应用的「应用功能」→「机器人」页面；
3、在「事件订阅」区域，点击「启用事件订阅」开关；
4、在「回调地址」输入框中，填写您部署的 DeepSeek V4 接入服务的完整 HTTPS 地址，例如：https://ai.example.com/feishu/event；
5、点击「验证」按钮，飞书将立即发起 GET 请求进行校验；
6、若服务返回 challenge 成功，页面显示「验证成功」，否则提示失败并需检查日志。
三、配置事件订阅类型并保存
仅配置回调地址不足以接收消息，还需明确告知飞书您希望接收哪些事件。DeepSeek V4 机器人需至少订阅用户发送给机器人的消息事件，才能触发模型推理与响应流程。
1、在「事件订阅」页面下方，勾选以下必要事件类型：im.message.receive_v1（接收单聊/群聊消息）；
2、如需支持消息卡片交互，额外勾选：interactive.message.callback_v1；
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
3、如需响应用户添加机器人进群动作，勾选：chat.member.add_v1；
4、确认无误后，点击「保存」按钮；
5、保存后系统将再次尝试验证回调地址可用性，若失败则需重新检查服务连通性与响应逻辑。
四、配置飞书应用权限并提交审批（企业环境必需）
飞书对不同事件类型强制绑定对应权限，未开通权限将导致事件虽推送但被拒绝处理。DeepSeek V4 机器人需以应用身份读取消息并发送回复，因此必须显式申请并获得授权。
1、进入应用「权限管理」页面；
2、搜索并添加以下权限：im:message.p2p_msg:readonly（读取私聊消息）、im:message.group_msg:readonly（读取群消息）、im:message:send_as_bot（以机器人身份发消息）；
3、若为企业自建应用，点击「提交审批」，等待企业管理员在飞书客户端完成审批；
4、审批通过后，权限状态变为「已授权」，此时事件推送方可携带完整消息体内容；
5、若权限未获批，飞书回调中 message 字段将为空或被脱敏，导致 DeepSeek V4 无法获取原始输入。
五、验证回调地址是否生效并排查常见错误
配置完成后，需通过真实交互验证整个链路是否畅通。飞书不会主动推送测试事件，必须由用户主动触发（如@机器人发送消息），且服务端需记录完整请求日志以便定位异常。
1、在飞书客户端任意单聊窗口中，输入 @您的机器人名称 并发送一条文本（如“你好”）；
2、立即查看您的 DeepSeek V4 接入服务日志，确认是否收到 POST 请求及完整 JSON 负载；
3、若未收到请求，检查飞书后台「事件订阅」状态是否为「已启用」，以及回调地址右侧是否显示绿色对勾；
4、若收到请求但签名验证失败，检查服务是否正确提取 X-Feishu-Signature 头，并使用 App Secret 对时间戳+请求体进行 HMAC-SHA256 签名比对；
5、若请求体中 message.content 为空，确认「权限管理」中对应消息读取权限已获批且状态为「已授权」。
