小樱桃 XSwitch Agora SIP-PSTN Gateway 测试中心

选择一项测试场景，验证 Agora RTC 与 PSTN/SIP 的互通能力。

📞 呼入测试

模拟 PSTN/SIP 号码呼入 Agora 频道。网页端作为 App 加入频道，XSwitch 收到来电后通过回调接口获取频道信息并加入。

进入呼入测试

📤 呼出测试

模拟 Agora 网页端拨打指定座机 / 手机号码。网页端先加入频道，再调用后端接口请求 XSwitch 发起外呼。

进入呼出测试

🔔 呼入回调接口说明

当 PSTN/SIP 电话呼入 XSwitch 时，XSwitch 会向业务方提供的回调地址发送请求，业务方需返回 Agora 频道信息。

回调地址： POST /api/agora-call-in

XSwitch 请求参数

字段必填说明
ver必填协议版本号，固定 1.0
uuid必填当前通话唯一 ID
cidName必填主叫名称
cidNumber必填主叫号码
destNumber必填被叫号码
domain必填当前租户域名，如 cherry.xswitch.cn
remoteAddr必填远端 IP 地址
cookie可选鉴权字符串

业务方响应参数

字段必填说明
token必填Agora Token 或 App ID（未开证书时）
channel必填Agora 频道名
uid可选Agora UID，未指定时自动选择
cidName可选覆盖主叫名称
cidNumber可选覆盖主叫号码

cURL 测试示例

curl -X POST http://localhost:8088/api/agora-call-in \
  -H "Content-Type: application/json" \
  -d '{
    "ver": "1.0",
    "uuid": "fbb53115-f52d-625xxxxx",
    "cidName": "test",
    "cidNumber": "10010",
    "destNumber": "777",
    "domain": "cherry.xswitch.cn",
    "remoteAddr": "192.168.1.7"
  }'