飞书手机号消息发送

解决什么问题

需要向飞书用户发送通知、提醒或自动化消息，但业务侧往往只拿到手机号，缺少稳定可用的 open_id、union_id。该技能把手机号到用户 ID 的解析和消息发送合并到同一个流程，适合在已有飞书应用凭证的场景中快速接入。

如何工作

• 先在配置中设置飞书应用的 APP_ID 和 APP_SECRET。
• 技能根据手机号查询对应用户 ID，减少手工处理身份标识的步骤。
• 再向目标用户发送消息，可用于通知、推送、自动化消息触达。

适用边界

• 目标用户需要属于飞书组织、已激活，且手机号可被应用查询。
• 应用需开通 contact:user.mobile:get、contact:user.id:get、im:message:send_as_bot 等权限；如需消息卡片，还要关注 im:message:send_interactive。
• 发送失败时，可优先检查凭证、权限、用户状态，以及 receive_id_type 是否与当前 ID 类型一致。
• 它主要覆盖“按手机号找人并发消息”的路径，不负责消息模板管理、回调配置或复杂会话编排。