发送 GIF 消息

发送 GIF 动图表情。

请求参数

参数	必填	类型	说明
`appid`	是	`string`	实例 appid，标识操作哪个已登录账号。示例：`we_xxxxxxxxxxxxxxx`
`conversationId`	是	`int64`	会话 id：单聊传对方 `userId`，群聊传 `roomId`，给自己发传当前账号 `uin`；必须是 JSON number。示例：`10786447466811918`
`content`	是	`object`	消息内容，子字段见下。示例：`{"url":"http://p.qpic.cn/pic_wework/1802732579/f2f4.../0"…`

content 字段

字段	类型	说明
`content.url`	`string`	GIF 表情信息（通常来自收到的消息）
`content.thumbUrl`	`string`	GIF 表情信息（通常来自收到的消息）
`content.md5`	`string`	GIF 表情信息（通常来自收到的消息）
`content.size`	`int64`	GIF 表情信息（通常来自收到的消息）
`content.width`	`int64`	GIF 表情信息（通常来自收到的消息）
`content.height`	`int64`	GIF 表情信息（通常来自收到的消息）
`content.name`	`string`	GIF 表情信息（通常来自收到的消息）

请求示例

http

POST {BASE_URL}/wx-api/api/message/sendGif
Authorization: Bearer <你的 App Token>
Content-Type: application/json

{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "url": "http://p.qpic.cn/pic_wework/1802732579/f2f4.../0",
    "thumbUrl": "http://p.qpic.cn/pic_wework/1802732579/3036.../0",
    "md5": "48BC89479099BDEB9965CB93C8884FB8",
    "size": 45754,
    "width": 240,
    "height": 240,
    "name": "辛苦了"
  }
}

bash

curl -X POST '{BASE_URL}/wx-api/api/message/sendGif' \
  -H 'Authorization: Bearer <你的 App Token>' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "url": "http://p.qpic.cn/pic_wework/1802732579/f2f4.../0",
    "thumbUrl": "http://p.qpic.cn/pic_wework/1802732579/3036.../0",
    "md5": "48BC89479099BDEB9965CB93C8884FB8",
    "size": 45754,
    "width": 240,
    "height": 240,
    "name": "辛苦了"
  }
}'

python

import requests

url = "{BASE_URL}/wx-api/api/message/sendGif"
headers = {"Authorization": "Bearer <你的 App Token>", "Content-Type": "application/json"}
body = """{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "url": "http://p.qpic.cn/pic_wework/1802732579/f2f4.../0",
    "thumbUrl": "http://p.qpic.cn/pic_wework/1802732579/3036.../0",
    "md5": "48BC89479099BDEB9965CB93C8884FB8",
    "size": 45754,
    "width": 240,
    "height": 240,
    "name": "辛苦了"
  }
}"""

resp = requests.post(url, headers=headers, data=body.encode("utf-8"))
print(resp.text)

java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String url = "{BASE_URL}/wx-api/api/message/sendGif";
String body = "{\n" +
    "  \"appid\": \"we_xxxxxxxxxxxxxxx\",\n" +
    "  \"conversationId\": 10786447466811918,\n" +
    "  \"content\": {\n" +
    "    \"url\": \"http://p.qpic.cn/pic_wework/1802732579/f2f4.../0\",\n" +
    "    \"thumbUrl\": \"http://p.qpic.cn/pic_wework/1802732579/3036.../0\",\n" +
    "    \"md5\": \"48BC89479099BDEB9965CB93C8884FB8\",\n" +
    "    \"size\": 45754,\n" +
    "    \"width\": 240,\n" +
    "    \"height\": 240,\n" +
    "    \"name\": \"辛苦了\"\n" +
    "  }\n" +
    "}";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create(url))
    .header("Authorization", "Bearer <你的 App Token>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

php

<?php

$url = '{BASE_URL}/wx-api/api/message/sendGif';
$body = <<<'JSON'
{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "url": "http://p.qpic.cn/pic_wework/1802732579/f2f4.../0",
    "thumbUrl": "http://p.qpic.cn/pic_wework/1802732579/3036.../0",
    "md5": "48BC89479099BDEB9965CB93C8884FB8",
    "size": 45754,
    "width": 240,
    "height": 240,
    "name": "辛苦了"
  }
}
JSON;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer <你的 App Token>',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

响应示例

响应结构与发送文本消息相同

成功时 data 就是刚发出的完整消息，字段见发送文本消息的响应示例。data.content 回显你发送的内容或上传字段，形状随消息类型不同，见消息模块总览的码表。

响应字段

字段	类型	说明
`code`	`int64`	统一封套状态码：0=成功，负数=失败
`detail`	`string`	附加明细，通常为空
`message`	`string`	文案：成功为 ok；失败形如 -码\|描述
`time`	`string`	服务端处理时间 YYYY-MM-DD HH:MM:SS

常见错误

下表为企微错误码。业务失败时顶层 code=-1，具体错误码在 message 的 | 前，例如 -3004|参数错误；鉴权与网关错误见错误码。

错误码	含义	怎么办
`-4014`	过期或错误的 `uin` 作 `conversationId`	先 `personal/getInfo` 取当前 `uin`
`-3020`	用自聊伪房间 `roomId` 作发送目标	给自己发用当前账号 `uin`
`-3004`	参数错误	检查字段名与类型，数字 id 不能传字符串

发送 GIF 消息 ​

请求参数 ​

请求示例 ​

响应示例 ​

响应字段 ​

常见错误 ​

下一步 ​