呼叫中心 API 概览
蝉印呼叫中心 API 为开发者提供了完整的通话控制、坐席管理及详单查询能力。通过本接口，你可以将呼叫能力集成到 CRM、ERP 或其他业务系统中。
1. 架构说明
- 基础路径:
/api(呼叫中心后端服务) - 认证方式: Bearer Token (Laravel Sanctum)
- 核心协议:
- SIP/WebRTC: 用于浏览器端软电话直接通话。
- HTTP API: 用于触发双呼、管理坐席及查询数据。
2. 功能模块分类
呼叫中心 API 按照功能划分为以下模块：
| 模块 | 前缀 | 核心功能 |
|---|---|---|
| 基础缓存 | /cache | 获取 ACD、坐席组、线路组等基础配置数据的缓存版本。 |
| 坐席管理 | /agent | 坐席账号的 CRUD，关联分机与权限。 |
| 状态控制 | /agent-control | 控制坐席的实时状态：示忙、就绪、签出等。 |
| 呼叫控制 | /call | 发起单向外呼、双向外呼 ( Dual )、回呼等操作。 |
| 详单录音 | /cdr | 查询通话流水（详单）、获取录音下载地址及 ASR 转写。 |
| 外呼任务 | /call-task | 批量外呼营运任务的管理与导入。 |
3. 接入准备
在使用 API 之前，请确保：
- 已在后台创建 机构 (Organization) 并获取所需的接入凭证。
- 坐席已绑定有效的 SIP 分机 (Extension)。
- 双呼功能需提前配置好对应的 供应商网关 (Gateway)。
4. 实时推送
系统支持通过 WebSocket (Laravel Reverb) 推送实时通话事件（如：来电弹屏、通话状态变更）。开发者可使用 Laravel Echo 进行订阅。