1.1. 文本消息
1.1.1. 请求参数
| 属性名 | 类型 | 说明 |
|---|---|---|
| msgid | 字符串 | 消息id，消息的唯一标识，企业可以使用此字段进行消息去重。 |
| action | 字符串 | 消息动作，目前有send(发送消息)/recall(撤回消息)/switch(切换企业日志)三种类型。 |
| from | 字符串 | 消息发送方id。同一企业内容为userid，非相同企业为external_userid。消息如果是机器人发出，也为external_userid。 |
| tolist | 字符串数组 | 消息接收方列表，可能是多个，同一个企业内容为userid，非相同企业为external_userid。 |
| roomid | 字符串 | 群聊消息的群id。如果是单聊则为空。 |
| msgtime | 整型 | 消息发送时间戳，utc时间，ms单位。 |
| msgtype | 字符串 | 消息类型 |
| text | 对象 | 消息体 |
| - content | 字符串 | 消息内容 |
1.1.2. 示例
{
"msgid": "CAQQluDa4QUY0On2rYSAgAMgzPrShAE=",
"action": "send",
"from": "XuJinSheng",
"tolist": [
"icefog"
],
"roomid": "",
"msgtime": 1547087894783,
"msgtype": "text",
"text": {
"content": "test"
}
}
1.1.3. 注：
机器人与外部联系人的账号都是external_userid，其中机器人的external_userid是以"wb"开头，例如："wbjc7bDwAAJVylUKpSA3Z5U11tDO4AAA"，外部联系人的external_userid以"wo"或"wm"开头。 如果是机器人发出的消息，可以通过openapi拉取机器人详情：如何获取机器人详情？ 如果是外部联系人发出的消息，可以通过openapi拉取外部联系人详情：如何获取外部联系人详情？ 如果是引用/回复消息，发消息的用户的语言设置是中文，消息内容前面会加上“这是一条引用/回复消息：”，如果发消息的用户的语言设置是英文，消息内容的前面会加上“This is a quote/reply:”。
1.1.4. 示例
{
"msgid": "CAQQluDa4QUY0On2rYSAgAMgzPrShAE=",
"action": "send",
"from": "XuJinSheng",
"tolist": [
"icefog"
],
"roomid": "",
"msgtime": 1547087894783,
"msgtype": "text",
"text": {
"content": "这是一条引用/回复消息：\nnick\n666\n------\n@nick777"
}
}