将第三方添加到通话中

本文档介绍了如何使用应用 API 的 /calls/add/CALL_ID/dial 端点拨打第三方电话,然后将对方添加到正在进行的通话中。当您向此端点发出请求时,系统会自动拨打第三方的手机号码,并且客服人员的通话适配器会显示正在通话界面。无论通话适配器是在客服人员桌面、CRM 中还是在 CCAI 平台门户中运行,都可以通过这种方式将第三方添加到通话中。只有当客服人员正在进行有效通话时,此端点才能正常运行。

调用端点

如需将第三方添加到通话中,请向以下端点发出 POST 请求:

https://YOUR_CCAAS_HOST/apps/api/v1/calls/CALL_ID/dial

CALL_ID 替换为通话 ID。

请求正文

以下是请求正文的示例:

{
  "agent_email": "AGENT_EMAIL",
  "outbound_number": "OUTBOUND_NUMBER",
  "phone_number": "PHONE_NUMBER"
}

替换以下内容:

  • AGENT_EMAIL:通话中客服人员的电子邮件地址。
  • OUTBOUND_NUMBER:拨出的手机号码。
  • PHONE_NUMBER:要添加到通话中的第三方的手机号码。

响应

输出类似于以下内容:

{
    "message": "Third party dialing initiated",
    "participant": {
        "id": 54321,
        "type": "third_party",
        "status": "dialing"
    }
}