# 消息操作
### 6 消息处理
### 6.1 发送已读回执
> GET /message/ack
#### 请求头
| 参数名称 | 默认值 | 描述 |
| ------------ | --- | ---------------------------------------------------- |
| access-token | | 令牌 |
| app\_id | | 应用ID |
| group\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口 |
| user\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口 |
#### 请求参数(Query Param)
| 参数名称 | 默认值 | 描述 |
| ---------------- | --- | ---------------- |
| conversation\_id | | conversation\_id |
| device\_sn | | device\_sn |
| msg\_id | | msg\_id |
#### 响应体
● 200 响应数据格式：JSON
| 参数名称 | 类型 | 默认值 | 不为空 | 描述 |
| ------- | ------- | --- | ----- | ----------------- |
| code | int32 | | false | 返回码，200是成功 |
| data | boolean | | false | 结果数据 |
| message | string | | false | 错误信息，如果成功，该项为null |
#### 接口描述
>
### 6.2 取指定会话的消息
> GET /message/conversation
#### 请求头
| 参数名称 | 默认值 | 描述 |
| ------------ | --- | ---------------------------------------------------- |
| access-token | | 令牌 |
| app\_id | | 应用ID |
| group\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口 |
| user\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口 |
#### 请求参数(Query Param)
| 参数名称 | 默认值 | 描述 |
| -------------- | --- | -------------- |
| limit | | limit |
| msg\_id\_start | | msg\_id\_start |
| opposite\_id | | opposite\_id |
#### 响应体
● 200 响应数据格式：JSON
| 参数名称 | 类型 | 默认值 | 不为空 | 描述 |
| -------------------- | -------------- | --- | ----- | ----------------- |
| code | int32 | | false | 返回码，200是成功 |
| data | object | | false | |
| ⇥ is\_last | boolean | | false | |
| ⇥ messages | array\[object] | | false | |
| ⇥⇥ attachment | string | | false | |
| ⇥⇥ config | string | | false | |
| ⇥⇥ content | string | | false | |
| ⇥⇥ ctype | string | | false | |
| ⇥⇥ ext | string | | false | |
| ⇥⇥ from\_xid | object | | false | |
| ⇥⇥⇥ device\_sn | int32 | | false | |
| ⇥⇥⇥ set\_device\_sn | boolean | | false | |
| ⇥⇥⇥ set\_uid | boolean | | false | |
| ⇥⇥⇥ uid | int32 | | false | |
| ⇥⇥ msg\_id | int32 | | false | |
| ⇥⇥ set\_attachment | boolean | | false | |
| ⇥⇥ set\_config | boolean | | false | |
| ⇥⇥ set\_content | boolean | | false | |
| ⇥⇥ set\_ctype | boolean | | false | |
| ⇥⇥ set\_ext | boolean | | false | |
| ⇥⇥ set\_from\_xid | boolean | | false | |
| ⇥⇥ set\_msg\_id | boolean | | false | |
| ⇥⇥ set\_status | boolean | | false | |
| ⇥⇥ set\_timestamp | boolean | | false | |
| ⇥⇥ set\_to\_xid | boolean | | false | |
| ⇥⇥ status | string | | false | |
| ⇥⇥ timestamp | int32 | | false | |
| ⇥⇥ to\_xid | object | | false | |
| ⇥⇥⇥ device\_sn | int32 | | false | |
| ⇥⇥⇥ set\_device\_sn | boolean | | false | |
| ⇥⇥⇥ set\_uid | boolean | | false | |
| ⇥⇥⇥ uid | int32 | | false | |
| ⇥ messages\_iterator | object | | false | |
| ⇥ messages\_size | int32 | | false | |
| ⇥ next\_msg\_id | int32 | | false | |
| ⇥ set\_is\_last | boolean | | false | |
| ⇥ set\_messages | boolean | | false | |
| ⇥ set\_next\_msg\_id | boolean | | false | |
| message | string | | false | 错误信息，如果成功，该项为null |
#### 接口描述
>
### 6.3 删除用户的指定会话
> DELETE /message/conversation
#### 请求头
| 参数名称 | 默认值 | 描述 |
| ------------ | --- | ---------------------------------------------------- |
| access-token | | 令牌 |
| app\_id | | 应用ID |
| group\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口 |
| user\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口 |
#### 请求参数(Query Param)
| 参数名称 | 默认值 | 描述 |
| ---------------- | --- | ---------------- |
| conversation\_id | | conversation\_id |
#### 响应体
● 200 响应数据格式：JSON
| 参数名称 | 类型 | 默认值 | 不为空 | 描述 |
| ------- | ------- | --- | ----- | ----------------- |
| code | int32 | | false | 返回码，200是成功 |
| data | boolean | | false | 结果数据 |
| message | string | | false | 错误信息，如果成功，该项为null |
#### 接口描述
>
### 6.4 发送系统通知
> POST /message/notify
#### 请求头
| 参数名称 | 默认值 | 描述 |
| ------------ | --- | ---------------------------------------------------- |
| access-token | | 令牌 |
| app\_id | | 应用ID |
| group\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口 |
| user\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口 |
#### 请求体(Request Body)
| 参数名称 | 数据类型 | 默认值 | 不为空 | 描述 |
| --------------- | ------------- | --- | ----- | ----------------------------------------------------------------------------------------------------------------------------- |
| attachment | string | | false | |
| config | string | | false | |
| content | string | | false | |
| content\_type | int32 | | false | 消息类型 TEXT = 0;
IMAGE = 1;
AUDIO = 2;
VIDEO = 3;
FILE = 4;
LOCATION = 5;
COMMAND = 6;
FORWARD = 7;
|
| ext | string | | false | |
| from\_user\_id | int32 | | false | 发送者的用户ID |
| targets | array\[int32] | | false | 接收用户ID或群ID |
| transaction\_id | int32 | | false | 请求ID，用于消息去重， 如果短时间内收到2个相同transaction\_id的请求，第二次请求不会被执行。 如果不设置就不会被去重 |
| type | int32 | | false | 目标类型，1 - 普通用户，2 - 群组 |
#### 响应体
● 200 响应数据格式：JSON
| 参数名称 | 类型 | 默认值 | 不为空 | 描述 |
| ------- | ------- | --- | ----- | ----------------- |
| code | int32 | | false | 返回码，200是成功 |
| data | boolean | | false | 结果数据 |
| message | string | | false | 错误信息，如果成功，该项为null |
#### 接口描述
>
### 6.5 发送系统通知
> PUT /message/notify
#### 请求头
| 参数名称 | 默认值 | 描述 |
| ------------ | --- | ---------------------------------------------------- |
| access-token | | 令牌 |
| app\_id | | 应用ID |
| group\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口 |
| user\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口 |
#### 请求体(Request Body)
| 参数名称 | 数据类型 | 默认值 | 不为空 | 描述 |
| --------------- | ------------- | --- | ----- | ----------------------------------------------------------------------------------------------------------------------------- |
| attachment | string | | false | |
| config | string | | false | |
| content | string | | false | |
| content\_type | int32 | | false | 消息类型 TEXT = 0;
IMAGE = 1;
AUDIO = 2;
VIDEO = 3;
FILE = 4;
LOCATION = 5;
COMMAND = 6;
FORWARD = 7;
|
| ext | string | | false | |
| from\_user\_id | int32 | | false | 发送者的用户ID |
| targets | array\[int32] | | false | 接收用户ID或群ID |
| transaction\_id | int32 | | false | 请求ID，用于消息去重， 如果短时间内收到2个相同transaction\_id的请求，第二次请求不会被执行。 如果不设置就不会被去重 |
| type | int32 | | false | 目标类型，1 - 普通用户，2 - 群组 |
#### 响应体
● 200 响应数据格式：JSON
| 参数名称 | 类型 | 默认值 | 不为空 | 描述 |
| ------- | ------- | --- | ----- | ----------------- |
| code | int32 | | false | 返回码，200是成功 |
| data | boolean | | false | 结果数据 |
| message | string | | false | 错误信息，如果成功，该项为null |
#### 接口描述
>
### 6.6 发送消息
> POST /message/send
#### 请求头
| 参数名称 | 默认值 | 描述 |
| ------------ | --- | ---------------------------------------------------- |
| access-token | | 令牌 |
| app\_id | | 应用ID |
| group\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口 |
| user\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口 |
#### 请求体(Request Body)
| 参数名称 | 数据类型 | 默认值 | 不为空 | 描述 |
| --------------- | ------------- | --- | ----- | ----------------------------------------------------------------------------------------------------------------------------- |
| attachment | string | | false | |
| config | string | | false | |
| content | string | | false | |
| content\_type | int32 | | false | 消息类型 TEXT = 0;
IMAGE = 1;
AUDIO = 2;
VIDEO = 3;
FILE = 4;
LOCATION = 5;
COMMAND = 6;
FORWARD = 7;
|
| ext | string | | false | |
| from\_user\_id | int32 | | false | 发送者的用户ID |
| targets | array\[int32] | | false | 接收用户ID或群ID |
| transaction\_id | int32 | | false | 请求ID，用于消息去重， 如果短时间内收到2个相同transaction\_id的请求，第二次请求不会被执行。 如果不设置就不会被去重 |
| type | int32 | | false | 目标类型，1 - 普通用户，2 - 群组 |
#### 响应体
● 200 响应数据格式：JSON
| 参数名称 | 类型 | 默认值 | 不为空 | 描述 |
| ------- | ------- | --- | ----- | ----------------- |
| code | int32 | | false | 返回码，200是成功 |
| data | boolean | | false | 结果数据 |
| message | string | | false | 错误信息，如果成功，该项为null |
#### 接口描述
>
### 6.7 发送消息
> PUT /message/send
#### 请求头
| 参数名称 | 默认值 | 描述 |
| ------------ | --- | ---------------------------------------------------- |
| access-token | | 令牌 |
| app\_id | | 应用ID |
| group\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口 |
| user\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口 |
#### 请求体(Request Body)
| 参数名称 | 数据类型 | 默认值 | 不为空 | 描述 |
| --------------- | ------------- | --- | ----- | ----------------------------------------------------------------------------------------------------------------------------- |
| attachment | string | | false | |
| config | string | | false | |
| content | string | | false | |
| content\_type | int32 | | false | 消息类型 TEXT = 0;
IMAGE = 1;
AUDIO = 2;
VIDEO = 3;
FILE = 4;
LOCATION = 5;
COMMAND = 6;
FORWARD = 7;
|
| ext | string | | false | |
| from\_user\_id | int32 | | false | 发送者的用户ID |
| targets | array\[int32] | | false | 接收用户ID或群ID |
| transaction\_id | int32 | | false | 请求ID，用于消息去重， 如果短时间内收到2个相同transaction\_id的请求，第二次请求不会被执行。 如果不设置就不会被去重 |
| type | int32 | | false | 目标类型，1 - 普通用户，2 - 群组 |
#### 响应体
● 200 响应数据格式：JSON
| 参数名称 | 类型 | 默认值 | 不为空 | 描述 |
| ------- | ------- | --- | ----- | ----------------- |
| code | int32 | | false | 返回码，200是成功 |
| data | boolean | | false | 结果数据 |
| message | string | | false | 错误信息，如果成功，该项为null |
#### 接口描述
>
### 6.8 取指定用户的最近会话列表
> GET /message/unread
#### 请求头
| 参数名称 | 默认值 | 描述 |
| ------------ | --- | ---------------------------------------------------- |
| access-token | | 令牌 |
| app\_id | | 应用ID |
| group\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口 |
| user\_id | | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口 |
#### 响应体
● 200 响应数据格式：JSON
| 参数名称 | 类型 | 默认值 | 不为空 | 描述 |
| ----------------------- | -------------- | --- | ----- | ----------------- |
| code | int32 | | false | 返回码，200是成功 |
| data | array\[object] | | false | 结果数据 |
| ⇥ conversation\_id | object | | false | |
| ⇥⇥ device\_sn | int32 | | false | |
| ⇥⇥ set\_device\_sn | boolean | | false | |
| ⇥⇥ set\_uid | boolean | | false | |
| ⇥⇥ uid | int32 | | false | |
| ⇥ num | int32 | | false | |
| ⇥ set\_conversation\_id | boolean | | false | |
| ⇥ set\_num | boolean | | false | |
| message | string | | false | 错误信息，如果成功，该项为null |
#### 接口描述
>