产品动态
关于云联络中心术语更新
呼入接口调用
场景说明
在呼入场景，您可能希望根据主被叫信息决定是否接听电话，动态切换接待的智能体 / 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": "小明"}]}}
文档反馈