发送 ARK 模板消息

2024-05-05 11:03| 来源: 网络整理| 查看: 265

# 发送 ARK 模板消息 # 接口

POST /channels/{channel_id}/messages

# 功能描述

通过指定 ark 字段发送模板消息。

要求操作人在该子频道具有发送消息和对应ARK 模板的权限。调用前需要先申请消息模板，这一步会得到一个模板 id，在请求时填在 ark.template_id 上。发送成功之后，会触发一个创建消息的事件。可用模板参考可用模板。 # Content-Type

application/json

# 参数字段名类型描述 ark MessageArk ark 消息 # 返回

返回Message 对象。

# 错误码

详见错误码。

# 示例

假设模板如下，其中#META_LIST#类型为数组、#META_URL#类型为 URL 其他为文本

{ "app": "com.tencent.miniapp", "view": "detail", "ver": "0.0.0.1", "desc": "#DESC#", "prompt": "[QQ小程序]#PROMPT#", "meta": { "detail": { "title": "#TITLE#", "desc": "#META_DESC#", "url": "#META_URL#", "list": "#META_LIST#" } } } 123456789101112131415

请求数据包

{ "ark": { "template_id": 1, "kv": [ { "key": "#DESC#", "value": "机器人订阅消息" }, { "key": "#PROMPT#", "value": "XX机器人" }, { "key": "#TITLE#", "value": "XX机器人消息" }, { "key": "#META_URL#", "value": "http://domain.com/" }, { "key": "#META_LIST#", "obj": [ { "obj_kv": [ { "key": "name", "value": "aaa" }, { "key": "age", "value": "3" } ] }, { "obj_kv": [ { "key": "name", "value": "bbb" }, { "key": "age", "value": "4" } ] } ] } ] } } 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152

则实际下发的 json 为

{ "app": "com.tencent.miniapp", "view": "detail", "ver": "0.0.0.1", "desc": "机器人订阅消息", "prompt": "[QQ小程序]XX机器人", "meta": { "detail": { "title": "XX机器人消息", "url": "http://domain.com/", "list": [ { "name": "aaa", "age": "3" }, { "name": "bbb", "age": "4" } ] } } } 1234567891011121314151617

响应数据包

{ "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 }, "pinned": false, "type": 0, "flags": 0 } 123456789101112131415161718 上次更新: 12/26/2021, 6:57:43 PM

← 撤回消息发送 Markdown 消息（灰度中） →

贡献者🎉

【本文地址】

发送 ARK 模板消息

发送 ARK 模板消息

今日新闻

推荐新闻