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