云联络中心呼入接口调用

提示：
腾讯云联络中心语音智能体功能目前内测中，您可以点击 问卷链接 提供您的使用场景等信息，我们会根据您提供的信息邀请您参与内测。
场景说明
在呼入场景，您可能希望根据主被叫信息决定是否接听电话，动态切换接待的智能体 / IVR，或调整呼入流程中的话术。成功配置呼入接口调用功能即可实现上述能力。例如，用户进线振铃时，可调用接口获取客户的 VIP 信息和姓名，根据是否是 VIP 选择接待的智能体，并使用客户姓名定制动态欢迎语。
一、开启方式
方式一：您可以通过 绑定号码呼入回调接口 直接配置呼入接口调用功能。
方式二：在 腾讯云联络中心管理端 的电话号码中找到需设置的号码并单击编辑。
﻿
进入编辑电话设置页面，在呼入设置 > 呼入接口调用中填写接回调地址，并单击确定保存生效。
﻿
二、请求方式
成功开启呼入接口调用后，用户拨打对应电话号码进线振铃时，系统会请求您填写的接口获取信息。请求接口时，主叫用户侧会持续振铃直到收到您的接口请求。
说明：
超过5秒接口未返回信息，系统会重新发送请求。重试2次失败后放弃请求，电话会接入对应号码原先绑定的智能体或 IVR 流程，若未绑定则会挂断。
1. 接口请求格式。
请求您填写的接口时，会提供以下信息
SessionId：每个通话的唯一 ID。
SdkAppId：号码归属的应用 ID。
AIAgentId：号码原先绑定的智能体 ID（为0时表示未绑定智能体）。
IvrId：号码原先绑定的 IVR ID（为0时表示未绑定 IVR）。
Caller：用户呼入时使用的主叫号码。
Callee：被叫号码。
{
    "Event": "CallInBound",
    "SessionId": "01bd935d-c45e-476a-9e5b-700e09494470",
    "SdkAppId": 1400692008,
    "CallInBound": {
        "AIAgentId": 123,
        "IvrId": 0,
        "Caller": "+8613066668888",
        "Callee": "+8675566668888"
    }
}
2. 接口响应格式。
您可按以下响应格式对通话进行设置
OverrideAIAgentId：需要覆盖的目标智能体 ID（和 OverrideIvrId 只能传递一个）。
OverrideIvrId：需要覆盖的目标 IVR ID（和 OverrideAIAgentId 只能传递一个）。
Variables：变量。
说明：
若您希望挂断电话，可在响应中将 CallInBound 设为空，系统将自动为您挂断电话。
{
    "CallInBound": {
        "OverrideAIAgentId": 388,
        // "OverrideIvrId": 435,
        "Variables": [
            {
                "Key": "name",
                "Value": "小明"
            }
        ]
    }
}
﻿
呼入接口调用

本页目录：

场景说明

一、开启方式

二、请求方式
