开放 API 对接指南

获取 API 密钥

客服中心 → API 密钥 → 生成新密钥。密钥与你的商户绑定，只能操作你自己站点的数据。请妥善保管，泄露后可随时禁用或删除。

接口一：查询会话列表

GET /api/conversations.php?api_key=你的密钥&status=open
返回：{ code:0, conversations:[{id,status,visitor_name,last_message,...}] }

status 可选：queued（排队）、open（进行中）、closed（已结束）。不传则返回全部。

接口二：向指定会话发消息

POST /api/message.php
参数：api_key, conversation_id, content, sender_name（可选）
返回：{ code:0 }

典型用途

• 把访客咨询同步到你自己的工单系统。
• 用你自己的 AI 机器人接管回复（通过 API 发送）。
• 定时拉取未处理会话，做超时告警。

安全建议

• 只在服务端调用 API，不要把密钥写在前端 JS 里。
• 定期轮换密钥，离职员工相关密钥及时删除。