• OpenAPI 简介
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 订阅消息
  • 分发
  • 搜索能力
  • 私信和群聊
  • 私信管理
  • 群聊管理
  • 群消息管理
  • 群消息 Webhook
  • 发送群消息
  • 撤回群消息
  • 粉丝群管理
  • 经营工具
  • 私域经营常见问题
  • 挂载
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 接口说明

      该接口用于撤回群聊消息

    使用限制

      当前仅支持一个用户授权一个应用;
      可撤回内容、时间限制与抖音端内保持一致

    基本信息

    名称
    描述
    HTTP URL
    HTTP Method
    POST
    Scope
    im.recall_message
    权限要求
    需要申请权限 在开发者后台-设置-关联设置-抖音号管理为小程序经营者申请小程序群管理能力

    请求头

    名称
    字段类型
    是否必填
    示例
    描述
    access-token
    String
    通过 BusinessToken 进行调用,示例:bus_act.3c2f5cc363d5c464e509c066*********oDYf3Fmzl6ztOYr
    content-type
    String
    application/json
    固定值"application/json"

    请求参数

    Query

    名称
    字段类型
    是否必填
    示例
    描述
    open_id
    String
    ba253642-0590-40bc-9bdf-9a1334b94059
    经营者唯一标识,
    可以通过:
      通过控制台-能力-私信和群聊-群聊管理授权用户详情页中获取
      其他OpenID获取方式获取
    示例:ba253642-0590-40bc-9bdf-9a1334b94059

    Body

    名称
    字段类型
    是否必填
    示例
    描述
    conversation_id
    String
    @72MqHzC5kqIEgB56A10333ntucyQ/A1Wn33333Vk9xDdDQrU9MpJSYEVV6/2hKHKVaRbE67Vx7Jd6yxgnq/g==
    会话 ID:
      来源于群消息 webhook 群消息事件,对应接受或发送群消息事件 content 里的 conversation_short_id 字段
    conversation_type
    Int32
    2
    会话类型 1- 单聊 2- 群聊
    msg_id
    String
    @7211MqHzC5kqIEgB56229n1ntu80T/MxUH6Wfj32VkdzCNbYrU9MpJSYEVV6/2hKL3r7seeHSYoexQTg/Prp5A==
    消息 id:来源于群消息 webhook 群消息事件,对应 接收或发送群消息webhook 事件 content 里的 server_message_id 字段

    请求示例

    curl -X POST 'https://open.douyin.com/im/recall/msg/?open_id=abcd-abcd-abcd-21221' \ -H 'Content-Type:application/json' -H 'access-token:act.d2o2u8ogtuoi2io2ruio2r2' \--data '{"msg_id":"@72MqHzC5kqIEgB56229n1ntu80T/MxUH6Wfj32VkdzCNbYrU9MpJSYEVV6/2hKL3r7seeHSYoexQTg/Prp5A==", \"conversation_id":"@72MqHzC5kqIEgB56A10333ntucyQ/A1Wn33333Vk9xDdDQrU9MpJSYEVV6/2hKHKVaRbE67Vx7Jd6yxgnq/g==", \"conversation_type":2 }'

    响应参数

    Body

    名称
    字段类型
    是否必填
    示例
    描述
    err_msg
    String
    消息发出已超过72小时无法撤回
    错误信息
    err_no
    Int32
    0
    错误信息
    log_id
    String
    20230202192209192B1185C6C1408E4EDB
    日志ID

    响应示例

    正常响应示例

    {"err_msg": "","err_no": 0,"log_id": "202302021924599A4FB64DA382950444C7"}

    异常响应示例

    {"err_msg": "消息发出已超过时间无法撤回","err_no": 28003036,"log_id": "20230202192209192B1185C6C1408E4EDB"}