发送消息

向指定子频道推送消息。

::: warning 注意

• 要求操作人在该子频道具有发送消息的权限。
• 主动推送消息，默认每天往每个频道可推送的消息数是 20 条，超过会被限制。
• 主动推送消息在每个频道中，每天可以往 2 个子频道推送消息，超过后会被限制。
• 不论主动消息还是被动消息，在一个子频道中，每 1s 只能发送 5 条消息。
• 被动回复消息有效期为 5 分钟，超时会报错。
• 发送消息接口要求机器人接口需要链接到 websocket gateway上保持在线状态。
• 有关主动消息审核，可以通过 Intents 中审核事件 MESSAGE_AUDIT 返回 MessageAudited 对象获取结果。

:::

使用示例

token := token.BotToken("appid", "token")
api := botgo.NewOpenAPI(token).WithTimeout(3 * time.Second)
ctx := context.Background()
message, err := api.PostMessage(ctx, channelId, &dto.MessageToCreate{
  MsgID:   msgId, //如果未空则表示主动消息
  Content: "hello world",
})
if err != nil {
  log.Fatalln("调用 PostMessage 接口失败, err = ", err)
}

参数说明

MessageToCreate

content、embed、ark、image至少需要有一个字段，否则无法下发消息。

被动回复消息

::: warning 注意

被动消息需是用户@机器人的消息，否则将会报错。

:::

Embed

详见消息内嵌格式。

Ark

详见发送模板消息。

MessageReference

详情见发送引用消息

返回说明

主动消息都需要审核，返回结果如下：

{
  "code": 304023,
  "message": "push message is waiting for audit now"
}

若为私域机器人可正常返回Message 对象。

Message

User

Member

DefaultRoleIDs

系统默认生成下列身份组 ID。

Timestamp

返回示例

以发送文本内容hello world为例，下面是返回示例：

data:

{
  "id": "101234567890abcdef",
  "channel_id": "10001",
  "guild_id": "6400000001",
  "content": "hello world",
  "timestamp": "2021-05-13T14:45:45+08:00",
  "tts": false,
  "mention_everyone": false,
  "author": {
    "id": "12345",
    "username": "abc",
    "avatar": "",
    "bot": true
  },
  "embeds": [{}],
  "pinned": false,
  "type": 0,
  "flags": 0
}