飞书机器人实战：5分钟搞定图片消息发送（含常见报错解决方案）

飞书机器人实战：5分钟搞定图片消息发送（含常见报错解决方案）

你是否遇到过这样的场景：服务器监控系统捕捉到一个异常峰值，你希望它能自动将一张清晰的图表截图，直接推送到团队的飞书群里，而不是一封冰冷的邮件；或者，你的自动化日报系统生成了精美的数据可视化图片，你希望它能无缝地出现在每日的晨会通知中。对于许多开发者和运维工程师来说，将图片消息集成到自动化流程中，是一个能极大提升信息传达效率和体验的“刚需”。

飞书机器人提供了强大的消息推送能力，但初次接触其图片消息发送功能时，你可能会发现它比预想的要“曲折”一些——它不像发送文本那样直接丢一个图片链接就行，而是需要经过一个“上传-获取密钥-发送”的流程。这个过程里，权限配置、tenant_access_token获取、图片上传格式、image_key的使用，每一步都可能藏着一个小坑。别担心，这篇文章就是为你准备的“避坑指南”。我们将抛开官方文档那略显冰冷的步骤罗列，从一个实战者的角度，带你用大约5分钟的时间，彻底打通从零到一发送飞书图片消息的全链路，并重点剖析那些你可能马上就会遇到的报错及其根因解决方案。我们的目标是：让你看完就能用，用了就能成。

1. 权限配置：一切开始前的“钥匙”

在写第一行代码之前，正确的权限配置是成功的一半。很多开发者卡在第一步，就是因为忽略了飞书开放平台对机器人能力精细化的权限控制。这不仅仅是“开启机器人”那么简单。

1.1 创建应用与启用机器人

首先，你需要一个承载机器人的“应用”。登录飞书开放平台，进入“开发者后台”。

1. 创建企业自建应用：点击“创建应用”，选择“企业自建应用”。给应用起一个清晰的名字，比如“服务器监控报警机器人”，这有助于后续管理。

获取凭证：创建成功后，在应用的“凭证与基础信息”页面，你会看到至关重要的 App ID 和 App Secret。请妥善保管，它们相当于你应用的“账号密码”。

App ID: cli_a1e085a957bxxxxx App Secret: bkr0P5k4qVAKO4IhfohMub0lLxxxxx 

注意：App Secret 只显示一次，务必立即复制保存。如果丢失，需要重置并生成新的。

1.2 开启关键权限：机器人与图片

创建应用后，它默认没有任何能力。我们需要像给新员工开通门禁和系统账号一样，为它开通必要的权限。

1. 启用机器人能力：
   • 进入应用详情页，在左侧菜单找到“权限管理”。
   • 在搜索框中输入“机器人”，你会找到“获取机器人信息”与“以应用身份在群聊中与用户互动”这两个权限。
   • 将它们的状态切换为“已开通”。这一步相当于告诉飞书：“我这个应用里有个机器人，它需要在群里说话。”
2. 开通图片上传下载权限：这是发送图片消息的核心权限，也是最容易被遗漏的一步。
   • 继续在“权限管理”页面搜索“图片”。
   • 找到“获取与上传图片或文件资源”这个权限项，将其开通。
   • 开通后，务必点击“申请线上发布”或“版本管理与发布”（即使应用仅用于内部测试）。在飞书的机制中，部分敏感权限（如图片上传）需要经过一次“发布”流程（哪怕是开发版本）才能真正生效。很多开发者卡在后续上传图片返回 No permission to access 错误，根源就在于此。

为了更清晰地对比这两个核心权限，我们来看下表：

1.3 将机器人加入群聊

权限配置好后，你的应用机器人还是个“光杆司令”，需要把它拉到具体的“战场”——群聊中。

1. 在飞书桌面端，进入你希望接收图片消息的群组。
2. 点击群设置 -> 群机器人 -> 添加机器人。
3. 在“自定义机器人”选项卡下，找到你刚创建的应用名称，点击添加。

添加成功后，在群机器人列表里找到它，点击“设置”，复制其 Webhook 地址。这个地址是独一无二的，格式类似：

https://open.feishu.cn/open-apis/bot/v2/hook/404d53f8-088b-4358-9ae6-0b80f65c3xxx 

提示：每个群、每个机器人对应的Webhook地址都不同。如果你需要在多个群发送，就需要分别添加并