yeta机器人_Yeta智能语音电话机器人开放平台接入指南（2）

呼入对接模式

呼入对接模式是指用户在需要时主动向Yeta平台发起呼叫，由Yeta电话机器人接听呼入的电话并进行人机交互。呼入对接模式是Yeta平台推荐的对接模式。

呼入对接步骤：

1、SIP线路对接

呼入对接模式下，Yeta平台作为SIP服务器，用户CTI平台作为SIP客户端。

用户CTI平台呼叫Yeta电话机器人时，需要在SIP消息头中携带企业ID、应用ID、语音机器人话术ID、业务关联ID信息项，在语音机器人交互时用于拉取话术上下文动态数据，在交互结束推送结果数据时用于业务关联。

2、用户提供语音机器人话术上下文动态数据接口(可选)

如果用户配置的语音机器人话术需要上下文动态数据则需要进行此步骤，否则可以忽略此步骤。

(1)开发部署语音机器人话术上下文动态数据获取接口；

(2)在Yeta平台中配置话术上下文动态数据接口URL地址；

(3)电话呼入到语音机器人时，Yeta平台自动调用接口拉取动态数据，请求参数将从SIP呼入消息的自定义消息头中获取。

3、接收结果数据推送(可选)

(1)用户开发部署数据接收服务；

(2)在Yeta平台中配置结果数据接收URL地址；

(3)呼叫结束后，Yeta开放平台将自动向用户预设的URL异步推送话单、录音、对话数据。

呼出对接模式

呼出对接模式是指用户使用Yeta电话机器人主动呼叫客户电话，并进行人机交互的模式。

原则上Yeta开放平台不提供外呼中继线路，只提供外呼调度控制能力，用户需要自行从运营商(或线路商)申请可外呼的中继线路，然后将外呼中继线路对接Yeta平台，为语音机器人提供外呼话路通道。

呼出交互场景：

(1)用户业务系统调用Yeta开放平台API提交客户号码和数据；

(2)Yeta电话机器人通过用户外呼中继线路并发呼叫客户电话；

(3)客户接听后与电话机器人进行人机对话交互；

(4)对话结束后Yeta平台向用户业务系统推送交互结果数据。

对接步骤：

1、SIP线路对接

呼出对接模式下，Yeta平台作为SIP客户端，通过用户的外呼中继线路或外呼设备对客户电话进行呼叫。

2、发起外呼

发起外呼有直接外呼和任务外呼两种模式。

直接外呼面向便捷发起外呼业务场景，提交号码数据同时指定线路和语音机器人话术，直接发起外呼。直接外呼发起后不可取消。

任务外呼面向需要按照任务进行灵活控制调度的业务场景。可以指定话术和线路号码创建任务，分批多次向任务提交号码数据，可以对任务进行启动、暂停、删除等控制操作。需要注意，同一个线路号码资源被某个任务使用后必须等待任务完成，才可以用作其它任务。

3、接收结果数据推送(可选)

(1)用户开发部署数据接收服务；

(2)在Yeta平台中配置结果数据接收URL地址；

(3)呼叫结束后，Yeta开放平台将自动向用户预设的URL异步推送话单、录音、对话数据。