同佳智慧酒店

一、酒店平台认证

认证地址：https://www.aligenie.com/account/approve

注意：机器人对接用户请选择“企业认证”方式，点击“下一步”，按界面提示完成信息填写和认证

二、酒店项目创建

参考：酒店项目创建

三、机器人应用创建：

酒店平台选择对应项目后，点击“设置-应用管理-新建应用” ，填写应用名称和应用描述完成创建

填写示例：

（1）添加应用名称：机器人1号

（2）添加应用描述：机器人1号测试应用

注意：

应用信息与酒店账号绑定，同一个应用可用于多个不同酒店项目

四、客需输出服务

支持平台推荐服务商快速开通和自主对接两种方式

1. 平台推荐服务商

服务商接入：将“服务商名称”，“服务商商标”，“服务商调用地址”告知酒店小二（可以钉钉扫描“技术支持”二维码进群反馈），由小二完成酒店后台配置，即可在平台界面展示推荐服务商信息。

客需服务开通：在酒店行业平台，点击“服务-客需输出服务”，选择“平台推荐服务商”，用户可以选择下方的客需服务商开通服务（下图示例中暂无推荐服务商信息）

2. 自主对接服务商

自主对接：在酒店行业平台，点击“服务-客需输出服务” ，选择“自主对接服务商”，点击“新增”

填写示例：

（1）名称：测试机器人

（2）应用选择，选择上一步创建好的应用：机器人1号

（3）调用地址，请填写https://（推荐） 或 http:// 开头的正确地址：https://test.cn/rebot/receive

五、酒店客需添加机器人服务

在酒店行业平台，点击“客需-物品服务”，选择对应物品点击“是否添加”开关按钮，选择“配送方式”为“机器人”，选择上一步创建的机器人名称

填写示例：

（1）添加可以配送的物品：擦鞋布

（2）选择配送方式：机器人

（3）选择提供配送的机器人名称：测试机器人

六、酒店房型&房间创建

参考：酒店房型和房间创建

七、酒店精灵App添加设备

下载链接：酒店精灵App

添加设备：安装好app后，使用淘宝账号（通过酒店平台认证并创建酒店项目的账号）登录，选择之前创建的酒店项目，点击“添加设备”，选择上一步创建好的“房间号”，选择实际的音箱型号，然后根据app提示进行配网操作，配网成功后，音箱会有配网成功的语音提示

八、酒店机器人对接调试

参考：酒店机器人对接协议

{
    "baseInfo": {
      "appName": "xxxx",
			"authType": "MD5",
			"hotelId": "b3e8a63****af8904b3cdb4",
			"requestId": "871d6117f8****8f4d44f3b3",
			"requestTime": 1690270270928,
			"roomNo": "201",
			"token": "c6f7c5774****2059fbab170"
    },
    "command": {
        "category": "客用品类",
				"deliveryMethod": "robot",						//配送方式
				"groupKey": "ca867424-6a7****a9cc80aa13929052134",
				"hotelId": "b3e8a63****04b3cdb4",			//酒店id
				"name": "纸巾",												//物品名称
				"orderNo": "202307251****7610361",		//订单号
				"paymentMethod": "robot",							//结算方式
				"price": 100.000,											//金额
				"quantity": 1,
				"robotName": "xx机器人",								//机器人名称
				"roomNo": "201",											//房间号
				"type": "GOODS"												//客需类型 目前就GOODS
    }
}

响应：

{
  "message":"success",				//具体返回情况 失败原因
  "statusCode":200,						//状态code 200成功
  "success":true
}

物品送达后，客控方可调用以下接口进行通知

https://open-api.aligenie.com/?version=ip_1.0&apiName=InvokeRobotPush

配送处理完成后，可根据以下接口进行工单完成

https://open-api.aligenie.com/?version=ip_1.0&apiName=UpdateTicket