腾讯乐享接口文档

# 消息通知

企业/组织可使用消息通知接口接收消息回调，与自有通知渠道进行对接，如:企业办公IM、短信、邮箱等。

事件类型：message/push

# 文本消息

# 回调示例

{
  "nonce": "f8c593b1-2e80-4662-8e78-f4de18272387", 
  "timestamp": 1565250843, 
  "sign": "354954e40f7ac183d51cbb85f2fd3290c117f7ba", 
  "action": "message/push", 
  "attributes": {
    "to_user": "STAFF_ID1|STAFF_ID2", 
    "to_department": "", 
    "to_tag": "", 
    "msg_type": "text", 
    "text": {
      "content": "腾讯乐享欢迎您！"
    }, 
    "to_team": "90b684c0146711ec8afa62e1943b6703"
  }, 
  "team_setting": {
    "from_team": "90b684c0146711ec8afa62e1943b6703", 
    "only_member_received": "0"
  }, 
  "operator": "StaffID", 
  "operator_info": {
    "name": "StaffID"
  }
}

# 参数说明：

参数 说明
to_user 消息接收成员ID列表，多个接收者用‘|’分隔。特殊情况：指定为@all表示向关注该企业应用的全部成员发送
to_department 消息接收部门ID列表，多个接收者用‘|’分隔
to_tag 消息接收标签ID列表，多个接收者用‘|’分隔
to_team 消息接收的K吧ID
msg_type 消息类型，text 表示文本消息
team_setting.from_team 来自哪个K吧
team_setting.only_member_received 当后台K吧管理设置为“K吧内容仅允许推送给本吧成员”，则“only_member_received”的参数值为1，设置为“K吧内容允许推送给全员”，则“only_member_received”的参数值为0
content 消息内容

# 图文消息

# 回调示例

{
  "nonce": "2944ade4-8aa2-453a-9979-7fe039a694a7", 
  "timestamp": 1565258350, 
  "sign": "6ddcc44d88096609d557e4627c871b8ae729531d", 
  "action": "message/push", 
  "attributes": {
    "to_user": "STAFF_ID1|STAFF_ID2", 
    "to_department": "", 
    "to_tag": "", 
    "msg_type": "news", 
    "news": {
      "articles": [
        {
          "title": "乐享欢迎您！", 
          "picurl": "", 
          "url": "https://lexiangla.com/?company_from=xxxx", 
          "description": "内有惊喜！"
        }
      ]
    }, 
    "to_team": "90b684c0146711ec8afa62e1943b6703"
  }, 
  "team_setting": {
    "from_team": "90b684c0146711ec8afa62e1943b6703", 
    "only_member_received": "0"
  }, 
  "operator": "StaffID", 
  "operator_info": {
    "name": "StaffID"
  }
}

# 参数说明：

参数 说明
to_user 消息接收成员ID列表，多个接收者用‘|’分隔。特殊情况：指定为@all表示向关注该企业应用的全部成员发送
to_department 消息接收部门ID列表，多个接收者用‘|’分隔
to_tag 消息接收标签ID列表，多个接收者用‘|’分隔
to_team 消息接收的K吧ID
msg_type 消息类型，news 表示图文消息
team_setting.from_team 来自哪个K吧
team_setting.only_member_received 当后台K吧管理设置为“K吧内容仅允许推送给本吧成员”，则“only_member_received”的参数值为1，设置为“K吧内容允许推送给全员”，则“only_member_received”的参数值为0
articles 图文消息内容
title 标题
description 描述
url 分享的链接
picurl 图文消息的图片链接

# 文本卡片消息

# 回调示例

{
  "nonce": "10c84590-e5b4-407c-869d-e2e8c8d3a52e", 
  "timestamp": 1565333174, 
  "sign": "8f6021e0dd0a7aebe4deb9dae835251c6f8817c3", 
  "action": "message/push", 
  "attributes": {
    "to_user": "", 
    "to_department": "1", 
    "to_tag": "", 
    "msg_type": "textcard", 
    "textcard": {
      "title": "乐问是什么？", 
      "description": "陈晨晨邀请你查看问题：专家来解答吧", 
      "url": "https://lexiangla.com/questions/2bba97403a6d11e9ad86e74ac6c31f4c", 
      "btntxt": "查看详情"
    }, 
    "to_team": "90b684c0146711ec8afa62e1943b6703"
  }, 
  "team_setting": {
    "from_team": "90b684c0146711ec8afa62e1943b6703", 
    "only_member_received": "0"
  }, 
  "operator": "StaffID", 
  "operator_info": {
    "name": "StaffID"
  }
}

# 参数说明：

参数 说明
to_user 消息接收成员ID列表，多个接收者用‘|’分隔。特殊情况：指定为@all表示向关注该企业应用的全部成员发送
to_department 消息接收部门ID列表，多个接收者用‘|’分隔
to_tag 消息接收标签ID列表，多个接收者用‘|’分隔
to_team 消息接收的K吧ID
msg_type 消息类型，textcard 表示文本卡片消息
team_setting.from_team 来自哪个K吧
team_setting.only_member_received 当后台K吧管理设置为“K吧内容仅允许推送给本吧成员”，则“only_member_received”的参数值为1，设置为“K吧内容允许推送给全员”，则“only_member_received”的参数值为0
articles 图文消息内容
title 标题
description 描述
url 分享的链接
btntxt 按钮文字

← 创建任务 →