私信API

发送私信

SetPersonalMessageSend

接口

地址版本方式权限
/api/v2/personal/message/sendv2POST不需要权限

描述

用于向指定用户发送私信消息

提示

机器人和私信成员都必须同时位于来源群

当来源群开启成员隐私保护模式时,机器人需要拥有管理成员权限才可私信

按私聊对象限制,10次/30秒

按机器人限制,1W次/天

入参

字段类型必传说明
islandSourceIdstring来源群ID,可自行指定,亦可从私信事件中获取
dodoSourceIdstringDoDoID
messageTypeint消息类型,1:文字消息,2:图片消息,3:视频消息
messageBodyobject消息内容

出参

字段类型说明
statusint返回码
messagestring返回信息
dataobject返回数据

数据

字段类型说明
messageIdstring消息ID

入参示例

{
    "islandSourceId": "10001",
    "dodoSourceId": "1000101",
    "messageType": 1,
    "messageBody": {
        "content": "测试文字消息"
    }
}
{
    "islandSourceId": "10001",
    "dodoSourceId": "1000101",
    "messageType": 2,
    "messageBody": {
        "url": "https://img.imdodo.com/dodo/8c77d48865bf547a69fb3bba6228760c.png",
        "width": 500,
        "height": 500,
        "isOriginal": 1
    }
}
{
    "islandSourceId": "10001",
    "dodoSourceId": "1000101",
    "messageType": 3,
    "messageBody": {
        "url": "https://video.imdodo.com/dodo/ff85c752daf7d67884cb9ad3921a5d01.mp4",
        "coverUrl": "https://img.imdodo.com/dodo/8c77d48865bf547a69fb3bba6228760c.png",
        "duration": 100,
        "size": 100
    }
}

出参示例

{
   "status": 0,
   "message": "success",
   "data": {
       "messageId": "111111111111111111"
   }
}