本文档介绍了如何使用 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"}。