开放平台-对话

本章节将讲解：如何使用“开放平台-对话”渠道与机器人对话。

渠道配置

1. 点击机器人菜单“集成-渠道”，点击“配置”即可查看渠道ID。渠道ID将用来进行对话API的调用。

使用开放平台渠道

调用前准备

1. 手册顶部工具栏中“开放平台”包含全部的服务端接口和引擎层接口详情。其中服务端接口页面支持快速调用，操作指南请见调用开放平台接口。

2. 开放平台的所有接口调用均需增加鉴权，鉴权详情请见服务账号。

通过开放平台创建用户并收发消息

1. 平台提供机器人的创建用户接口，调用这个接口需要提供如下两个固定参数：

参数名	参数说明	查找方式
agentId	机器人ID，创建机器人后生成	前端url或机器人设置中
channelId	渠道ID，创建渠道后生成	渠道配置中

2. 平台提供机器人的收发消息接口，调用这个接口需要提供如下三个固定参数：

参数名	参数说明	查找方式
agentId	机器人ID，创建机器人后生成	前端url或机器人设置中
channelId	渠道ID，创建渠道后生成	渠道配置中
environment	指定环境，SKETCH即测试环境，PRODUCT即生产环境	根据对接的渠道类型，自行选择

• 接口可以传入未创建用户，未创建用户可以正常回复，但是不会出现在数据统计与消息记录中
• 接口channel_id支持传-，用户可以正常回复，但不会出现在数据统计与消息记录中

通过开放平台为用户添加属性

1. 用户属性及元数据可以用于影响对话内容，定义及详情请见元数据与属性。

2. 平台提供机器人的更改用户的属性值接口，调用这个接口需要提供如下三个固定参数：

参数名	参数说明	查找方式
agentId	机器人ID，创建机器人后生成	前端url或机器人设置中
channelId	渠道ID，创建渠道后生成	渠道配置中
username	用户名，创建用户后生成	-

3. 收发消息接口也支持传metadata，同名metadata会直接覆盖用户属性。