阿里云OpenAPI的云呼叫中心外呼接口调用,提示话务未上线,有没有对应api调用?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
在阿里云云呼叫中心的OpenAPI中,如果外呼接口调用时提示“话务未上线”,通常是因为坐席的状态未正确设置为空闲或就绪状态。根据知识库中的信息,您需要确保坐席已经完成上线操作,并且状态符合发起外呼的要求。
以下是解决该问题的具体步骤及相关API调用说明:
在发起外呼之前,坐席的状态必须为“空闲”(状态码为3)或“仅外呼”(状态码为4)。如果坐席状态不符合要求,您需要先调整状态。
ReadyForService
调用此接口使指定实例下的坐席进入就绪状态(空闲状态)。
请求参数:
InstanceId
:实例ID。UserId
:坐席ID(可选,默认使用当前RAM账号映射的坐席)。示例:
{
"InstanceId": "ccc-test",
"UserId": "agent@ccc-test"
}
注意事项: - 确保坐席已登录系统并完成签入技能组的操作。 - 如果坐席未签入技能组,请参考下一步。
如果坐席未签入技能组,则无法正常上线或发起外呼。您需要调用以下API完成签入操作。
SignInGroup
调用此接口使坐席签入指定技能组,完成上线操作。
请求参数:
InstanceId
:实例ID。UserId
:坐席ID。SkillGroupId
:技能组ID。示例:
{
"InstanceId": "ccc-test",
"UserId": "agent@ccc-test",
"SkillGroupId": "skillgroup-12345"
}
注意事项: - 技能组ID可以通过ListSkillGroups
接口获取。 - 确保技能组已在阿里云云呼叫中心控制台中配置完成。
当坐席状态为“空闲”或“仅外呼”后,您可以调用MakeCall
接口发起外呼。
MakeCall
调用此接口发起呼叫,被叫可以是内部坐席或外部客户。
请求参数:
InstanceId
:实例ID。UserId
:发起外呼的坐席ID(可选)。DeviceId
:设备ID(无实际意义,可随意填写)。Caller
:主叫号码(如果是外部呼叫,需确保号码可用且绑定到坐席或技能组)。Callee
:被叫号码(内部呼叫填写分机号,外部呼叫填写客户电话号码)。示例:
{
"InstanceId": "ccc-test",
"UserId": "agent@ccc-test",
"DeviceId": "device-123",
"Caller": "010989****",
"Callee": "1318888****"
}
注意事项: - 主叫号码需通过PickOutboundNumbers
接口选择合适的号码。 - 确保被叫号码格式正确,且坐席有权限使用主叫号码。
如果以上步骤完成后仍然提示“话务未上线”,请检查以下内容: - 坐席是否已登录: 确保坐席已完成登录操作(logIn
钩子函数已触发)。 - 技能组配置: 确保技能组已在阿里云云呼叫中心控制台中正确配置。 - 状态同步: 使用PollUserStatus
接口轮询坐席状态,确认状态已更新为空闲或仅外呼。
通过调用SignInGroup
完成坐席签入技能组,调用ReadyForService
将坐席状态设置为空闲,最后调用MakeCall
发起外呼即可解决问题。如果仍有异常,请检查坐席登录状态及技能组配置是否正确。