# 设备呼叫（API名称：openApiSendImMessage） #### 功能介绍用于与客户系统对接设备呼叫接口接口服务。 #### 相关API | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 | #### URL | 请求方式 | HTTPS地址 | 服务架构 | 消息体类型 | |:---|:---|:---|:---| | POST | https://***isdp+域名***/openapi/v1/openSendImMessage/openApiSendImMessage | OpenAPI | application/json | #### 请求头 | **KEY** | VALUE | 是否必填 | **描述** | |:---|:---|:---|:---| | Content-Type | application/json | 是 | 无 | | Authorization | bearer ${access_token} | 是 | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 | #### 请求参数 | 参数 | 类型 | 是否必填 | 描述 | |:---|:---|:---|:---| | message | String | 是 | 根据需求有所变化，详情见下方请求示例 | message参数说明 | 参数 | 类型 | 是否必填 | 描述 | |:---|:---|:---|:---| | userId | long | 是 | 应用管理中账号的userId | | userName | String | 是 | 应用管理中账号的userName | | userNo | String | 是 | 应用管理中账号的userNo | | tenantId | int | 是 | 租户id | | deviceId | String | 是 | 接受设备的设备id | | isdpDeviceId | String | 是 | 接受设备的isdpDeviceId | #### 响应参数 | 参数 | 类型 | 描述 | |:---|:---|:---| | result | Object | 响应消息体 | | errorMessage | String | 接口错误时有值，正常调用时为空 | | stateCode | String | "0"成功其他值失败 | #### 请求示例（呼叫设备例子）注：标红部分的是账号需要修改，759646@saasgroupchat.xxxx.test.huawei.com为设备的chatJid；1663236474522是一个随机数UUID，http://xxxx.test.huawei.com仅为sit示例，具体地址视现场openfire服务而定，后续标红账号见上表说明（蓝色部分是发送指令）。 ``` {"message":"qc-intellect-equip-remote-invite智能设备远端呼叫textqc-intellect-equip-remote-invite{"userId":864711,"userName":"zhang_sit","userNo":"Zhang123456","tenantId":886,"deviceId":"aqm0523","isdpDeviceId":"aqm0523--1"}"} ``` #### 响应示例 ``` { "stateCode": "0", "errorMessage": null, "result": null } ``` #### 状态码状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。 #### 错误码错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。