获取 ChatWoot 对话 是对 /chatwoot/v1/connections/{connection_id}/conversations/{conversation_id} 的 GET，属于 MakeHybrid ChatWoot API：你的组织已经在用它答复客户的那个 ChatWoot，部署在组织自己的服务器或自己的云账号上。每个请求都在 X-API-KEY 头里带上你自己的密钥 — 与 LinkedIn API 的密钥相同 — 只会触及你的组织连接的那个 ChatWoot。
这是你们自己的 ChatWoot，使用成员输入的地址，调用时用的是成员粘贴的令牌 — 所以 ChatWoot 会把一切都记在该用户名下，而项目房间使用的也是同一个连接。
请求
curl -X GET "https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
路径里放什么
- connection_id — 本系列中较早一次调用返回的 id。
- conversation_id — 本系列中较早一次调用返回的 id。
不成功时返回什么
- 401 — 密钥缺失、错误或已吊销。
- 402 — 套餐未付费。试用结束后 MakeHybrid API 会返回这个。
- 404 — 要么那东西不在，要么它不属于你的组织。两者故意给同样的答案，这样就无法用 id 去试探。
- 429 — 请求太多，或者平台要求我们放慢。稍等片刻再重试。
- 502 或 503 — 平台刚才没有回应。请稍后再试。
每个错误都是同一种形状的 JSON：{"type":"errors/<code>","status":<n>,"detail":"..."} — 所以一个处理函数就能全接住，而 detail 是写来直接给人看的。
改成让助手去做
这个操作同时也是一个 MCP 工具。把 https://makehybrid.com/chatwoot/mcp/<your API key> 粘进 Claude、ChatGPT 或任何会讲 MCP 的助手，然后用大白话说你要什么——助手会自己挑调用、填 id，再把结果念给你听。https://makehybrid.com/mcp/<your API key> 处的一体化智能体也有它，和 LinkedIn API 以及其他所有渠道放在一起。
在项目房间里
在项目房间里，给你自己的 AI 智能体在“可使用的服务器”下勾选这个 API 的智能体，它就会在对话需要时把 “获取 ChatWoot 对话” 当作工具来调用。房间里的每个人都能看到它问了什么、拿回了什么。用大白话提问就行；这里的智能体叫 @scout：
- @scout 列出我们 ChatWoot 里从昨天起仍处于开启状态的对话，并为每一条草拟答复，供我检查。
常见问题
AI 智能体能替我调用 “获取 ChatWoot 对话” 吗？
能。任何支持 MCP 的助手都可以，通过上面的地址；在勾选了这个 API 的智能体的项目房间里，你自己的 AI 智能体也可以。房间的内置智能体不行：它们只提建议，并不持有你的密钥。
不在房间里，用我自己的代码也行吗？
行。上面的请求，和 AI 智能体的工具调用的是同一个操作，答案相同，错误也相同。不论你从哪条路进来，你的密钥触及的都是同样的渠道。
在我自己品牌下的房间里也行吗？
行。在白标地址上，API、它的参考文档和它的 AI 智能体都会带上你的产品名称，并且在同样的规则下触及同样的渠道。
属于哪个套餐
包含在 MakeHybrid API 套餐中，与 LinkedIn API 使用同一个密钥：每个席位每月 9 美元，十个席位起 7 美元，一千个起 5 美元。你需要的席位数，等于 LinkedIn 账号、WhatsApp 号码、X 账号和收件箱账号这几种里你拥有最多的那一种的数量；30 天试用含一个席位。