php怎么调用飞书开放平台_api_php如何接入飞书机器人发送消息-php教程-PHP中文网

飞书webhook发消息无需access_token，直接用含uuid的webhook url即可；需严格遵循json格式、content-type头及msg_type/content结构，优先用curl验证链路，并确认机器人已入群且权限正常。

php怎么调用飞书开放平台_api_php如何接入飞书机器人发送消息

直接用 Webhook 最快，但别硬塞 access_token

飞书机器人发消息，最简单的方式就是 Webhook，根本不需要调用 auth/v3/tenant_access_token/internal 拿 access_token。你看到的那些带 Authorization: Bearer xxx 的示例，其实是误用了「自建应用」的调用方式——Webhook 机器人压根不走鉴权头，它靠的是 URL 里的密钥。

Webhook 地址形如 https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx，后半段 UUID 就是凭证，泄露等于机器人失控
如果在代码里写死 Authorization 头并填了错误的 token，会返回 400 Bad Request 或 401 Unauthorized，但错误信息里不会明说“你用错鉴权方式了”
PHP 用 curl 或 GuzzleHttp\Client 都行，关键要确保 Content-Type: application/json，且请求体是合法 JSON（注意中文编码、引号转义）

msg_type 和 content 结构必须严格匹配文档

飞书对消息格式非常敏感，msg_type 写成 "text" 却把内容塞进 text 字段外的键里，或者漏掉 content 这层包装，都会导致 400 并返回模糊提示 "invalid parameter"。

纯文本：必须是 {"msg_type":"text","content":{"text":"hello"}}，不是 {"text":"hello"}
富文本（如加粗、链接）要用 post 类型，结构完全不同：{"msg_type":"post","content":{"post":{"zh_cn":{"title":"告警","content":[[{"tag":"text","text":"CPU > 95%"}]]}}}}
PHP 中用 json_encode() 时务必加 JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES，否则中文变 \uXXXX，飞书可能渲染为空或报错

本地调试 curl 成功率比 PHP 脚本高，先验证再集成

很多问题其实和 PHP 无关，而是网络、URL、JSON 格式导致的。别急着改代码，先用命令行确认基础链路通不通。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

终端执行：curl -X POST "https://open.feishu.cn/open-apis/bot/v2/hook/你的webhook-id" -H "Content-Type: application/json" -d '{"msg_type":"text","content":{"text":"test from curl"}}'
如果返回 {"status_code":0,"status_msg":"success"}，说明 URL 和格式没问题；如果返回空、超时或 HTML 页面，大概率是 URL 错、被防火墙拦截、或本地没开代理（企业内网常见）
PHP 里用 curl_error($ch) 或 Guzzle 的 $response->getBody()->getContents() 打印原始响应，比只看状态码更有用