将第三方添加到通话中

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

调用端点

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

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

将 CALL_ID 替换为通话 ID。

请求正文

以下是请求正文的示例:

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

替换以下内容:

  • AGENT_EMAIL:通话中客服人员的邮箱。
  • PHONE_NUMBER:要添加到通话中的第三方的手机号码。

响应

输出类似于以下内容:

成功响应

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

错误响应

  • 400 Bad Request - phone_number 或 agent_email 缺失或为空。 正文:{"message": "param is missing or the value is empty: <name>"}。
  • 400 Bad Request - agent_email 与已知用户不匹配。正文: {"message": "Invalid agent_email"}。
  • 401 Unauthorized - 身份验证失败。正文: {"message": "Not Authorized"}。
  • 404 Not Found - 不存在具有所提供 call_id 的通话。正文: {"message": "Not Found"}。
  • 422 Unprocessable Entity - 由 agent_email 标识的代理未连接到通话。正文: {"message": "Agent is not connected to the call"}。
  • 422 Unprocessable Entity - 无法发起拨号;涵盖手机号码标准化失败和提供商拨号发起错误。正文:{"message": "Error dialing third party"}。
  • 500 Internal Server Error - 拨号期间发生意外故障。正文: {"message": "Unexpected error dialing third party"}。