模板消息

获取模板列表

GET /v1/templates?access_token={access_token}&kw={kw}&skip={skip}&limit={limit}

请求头部:

请求头说明
Content-Typeapplication/json

请求参数:

字段类型是否必填说明
access_tokenStringY访问令牌
kwStringN关键字查询,检索模板标题,tags
skipintN分页参数,默认值0
limitintN分页参数,默认值10

请求示例:

/v1/templates?access_token=9e37bbc45be34cd8be8bc3fa31149b88

返回数据:

点击查看返回数据

::: v-pre

{
  "status": 0, 
  "message": "Everything is ok.", 
  "result": {
    "total_count": 1, 
    "records": [
      {
        "id": "32790e3d-2ce2-45ad-b9c2-c562f39882c3", 
        "domain_id": "atwork", 
        "org_id": "85939199-6424-4f28-84d4-fce2aedf0e64", 
        "app_id": "DEFAULT", 
        "title": "标题", 
        "sample": "消息示例", 
        "operator": "a86e83a26be44eb59806901cc8be5d5c", 
        "create_time": 1502336857426, 
        "refresh_time": 1502336857426, 
        "actions": [
          {
            "name": "查看详情", 
            "value": "https://baidu.com"
          }, 
          {
            "name": "投诉", 
            "value": "https://baidu.com"
          }
        ], 
        "contents": [
          [
            {
              "content": "我是第一行:{{data1.DATA}}", 
              "align": "center"
            }
          ], 
          [
            {
              "content": "2-1", 
              "align": "right"
            }, 
            {
              "content": "2-2", 
              "align": "left"
            }
          ], 
          [
            {
              "content": "第三行信息", 
              "align": "center"
            }
          ]
        ]
      }
    ]
  }
}

:::

错误返回值:

statusmessage说明
10011token not found.访问令牌不存在

新增模板

POST /v1/templates?access_token={access_token}&app_id={app_id}&source_type={source_type}

请求头部:

请求头说明
Content-Typeapplication/json

请求参数: ::: v-pre | 字段| 类型 | 是否必填|说明| |---|---|---|---| | access_token | String | Y | 访问令牌 | | app_id | String | Y | 应用标识 | | source_type | String | N | 枚举,NATIVE/ISV,默认值为NATIVE,ISV应用时传ISV | | tags | String | N | 标签信息,用于检索 | | title | String | N | 模板标题 | | actions | String | N | 模板动作,name为显示名称,value为点击动作,格式请参考样例 | | contents | String | N | 模板内容,格式请参考样例 | | contents.align | String | N | 对其方式: left/right/center | | contents.content | String | N | 变量格式为:{XXX.DATA}}",其中XXX为自定义变量名 | ::: 请求示例:

/v1/templates?access_token=9e37bbc45be34cd8be8bc3fa31149b88&app_id=dafc2d03-3991-4de0-91d6-de3135c1fb4f&source_type=NATIVE

::: v-pre

{
  "title": "接口模板2", 
  "tags": "标签信息", 
  "sample": "消息示例", 
  "actions": [
    {
      "name": "查看详情", 
      "value": "https://baidu.com"
    }, 
    {
      "name": "投诉", 
      "value": "https://baidu.com"
    }
  ], 
  "contents": [
    [
      {
        "content": "我是第一行:{{data1.DATA}}", 
        "align": "center"
      }
    ]
  ]
}

:::

返回数据:

点击查看返回数据

::: v-pre

{
  "status": 0, 
  "message": "Everything is ok.", 
  "result": {
    "id": "86007b6c-5cd1-4a9d-a5a6-f85ba8fdd03f", 
    "domain_id": "atwork", 
    "org_id": "85939199-6424-4f28-84d4-fce2aedf0e64", 
    "app_id": "dafc2d03-3991-4de0-91d6-de3135c1fb4f", 
    "type": "DEFAULT", 
    "title": "接口模板2", 
    "sample": "消息示例", 
    "operator": "dafc2d03-3991-4de0-91d6-de3135c1fb4f", 
    "create_time": 0, 
    "refresh_time": 0, 
    "actions": [
      {
        "name": "查看详情", 
        "value": "https://baidu.com"
      }, 
      {
        "name": "投诉", 
        "value": "https://baidu.com"
      }
    ], 
    "contents": [
      [
        {
          "content": "我是第一行:{{data1.DATA}}", 
          "align": "center"
        }
      ]
    ], 
    "tags": "标签信息"
  }
}

:::

错误返回值:

statusmessage说明
10011token not found.访问令牌不存在

修改模板

POST /v1/templates/{templateId}?access_token={access_token}&app_id={app_id}&source_type={source_type}

请求头部:

请求头说明
Content-Typeapplication/json

请求参数:

::: v-pre | 字段| 类型 | 是否必填|说明| |---|---|---|---| | access_token | String | Y | 访问令牌 | | templateId | String | Y | 模板标识 | | app_id | String | Y | 应用标识 | | source_type | String | N | 枚举,NATIVE/ISV,默认值为NATIVE,ISV应用时传ISV | | tags | String | N | 标签信息,用于检索 | | title | String | N | 模板标题 | | actions | String | N | 模板动作,name为显示名称,value为点击动作,格式请参考样例 | | contents | String | N | 模板内容,格式请参考样例 | | contents.align | String | N | 对其方式:left/right/center | | contents.content | String | N | 变量格式固定为:{{data1.DATA}} | :::

请求示例:

/v1/templates/a624d18d-98a3-4bec-a854-b279d260b478?access_token=9e37bbc45be34cd8be8bc3fa31149b88

::: v-pre

{
  "title": "接口模板3", 
  "tags": "标签信息", 
  "sample": "消息示例", 
  "actions": [
    {
      "name": "查看详情", 
      "value": "https://baidu.com"
    }, 
    {
      "name": "投诉", 
      "value": "https://baidu.com"
    }
  ], 
  "contents": [
    [
      {
        "content": "我是第一行:{{data1.DATA}}", 
        "align": "center"
      }
    ]
  ]
}

:::

返回数据:

点击查看返回数据

::: v-pre

{
  "status": 0, 
  "message": "Everything is ok.", 
  "result": {
    "id": "86007b6c-5cd1-4a9d-a5a6-f85ba8fdd03f", 
    "domain_id": "atwork", 
    "org_id": "85939199-6424-4f28-84d4-fce2aedf0e64", 
    "app_id": "dafc2d03-3991-4de0-91d6-de3135c1fb4f", 
    "type": "DEFAULT", 
    "title": "接口模板3", 
    "sample": "消息示例", 
    "operator": "dafc2d03-3991-4de0-91d6-de3135c1fb4f", 
    "create_time": 0, 
    "refresh_time": 0, 
    "actions": [
      {
        "name": "查看详情", 
        "value": "https://baidu.com"
      }, 
      {
        "name": "投诉", 
        "value": "https://baidu.com"
      }
    ], 
    "contents": [
      [
        {
          "content": "我是第一行:`{{data1.DATA}}`", 
          "align": "center"
        }
      ]
    ], 
    "tags": "标签信息"
  }
}

:::

错误返回值:

statusmessage说明
10011token not found.访问令牌不存在

获取模板详情

GET /v1/templates/{templateId}?access_token={access_token}

请求头部:

请求头说明
Content-Typeapplication/json

请求参数:

::: v-pre | 字段| 类型 | 是否必填|说明| |---|---|---|---| | access_token | String | Y | 访问令牌 | | templateId | String | Y | 模板标识 | | appId | String | Y | 应用标识 | | source_type | String | N | 枚举,NATIVE/ISV,默认值为NATIVE,ISV应用时传ISV | | category_id | String | N | 模板分类标识,可为空 | | title | String | N | 模板标题 | | actions | String | N | 模板动作,name为显示名称,value为点击动作,格式请参考样例 | | contents | String | N | 模板内容,格式请参考样例 | | contents.align | String | N | 对其方式:left/right/center | | contents.content | String | N | 变量格式固定为:{{data1.DATA}} | :::

请求示例:

/v1/templates/a624d18d-98a3-4bec-a854-b279d260b478?access_token=9e37bbc45be34cd8be8bc3fa31149b88

返回数据:

点击查看返回数据

::: v-pre

{
  "status": 0, 
  "message": "Everything is ok.", 
  "result": {
    "id": "86007b6c-5cd1-4a9d-a5a6-f85ba8fdd03f", 
    "domain_id": "atwork", 
    "org_id": "85939199-6424-4f28-84d4-fce2aedf0e64", 
    "app_id": "dafc2d03-3991-4de0-91d6-de3135c1fb4f", 
    "type": "DEFAULT", 
    "title": "接口模板3", 
    "sample": "消息示例", 
    "operator": "dafc2d03-3991-4de0-91d6-de3135c1fb4f", 
    "create_time": 0, 
    "refresh_time": 0, 
    "actions": [
      {
        "name": "查看详情", 
        "value": "https://baidu.com"
      }, 
      {
        "name": "投诉", 
        "value": "https://baidu.com"
      }
    ], 
    "contents": [
      [
        {
          "content": "我是第一行:{{data1.DATA}}", 
          "align": "center"
        }
      ]
    ], 
    "tags": "标签信息"
  }
}

:::

错误返回值:

statusmessage说明
10011token not found.访问令牌不存在

模板消息推送

POST /v1/apps/mbox?access_token={access_token}

请求头部:

请求头说明
Content-Typeapplication/json

请求参数:

字段类型是否必填说明
access_tokenStringY访问令牌
typeStringY消息类型,模板消息类型固定为template
client_idsList<String>N消息推送的用户标识
scopesList<String>N发送范围,组织路径,例如/122/234/
platformsListN枚举,ANDROID/IOS/PC,默认值为IOS和ANDROID
bodyMapY推送消息体
body.template_idStringN模板ID,模板消息必填
body.dataStringN模板数据,模板消息必填,value为变量值,color为颜色,font_size为字号大小
body.top_colorStringN顶部颜色
body.top_avatarStringN顶部图标
body.top_titleStringN顶部标题
body.data.text_styleStringNnormal(正常)bold(粗体)

请求示例:

/v1/apps/mbox?access_token=b646339e2f4f4234af6bae5f72db9879

模板消息:

点击查看模板消息
{
  "type": "TEMPLATE", 
  "body": {
    "template_id": "152891af-1bec-4a18-8201-a58e08a7afad", 
    "top_color": "#00ff00",
    "top_avatar": "Z3JvdXAxL00wMC8wMC80MC9yQkFCR1ZkWDQ0ZUFRY21LQUFBZXVHZDBHS0U4MTkuanBn",
    "top_title": "流程大师",
    "data": [
      {
        "key": "keyword1", 
        "value": "339208499", 
        "color": "#00ff00", 
        "font_size": "12", 
        "text_style": "normal"
      }, 
      {
        "key": "keyword2", 
        "value": "2016年01月05日", 
        "color": "#00ff00", 
        "font_size": "12", 
        "text_style": "normal"
      }, 
      {
        "key": "keyword3", 
        "value": "830138013810", 
        "color": "#00ff00", 
        "font_size": "12", 
        "text_style": "normal"
      }, 
      {
        "key": "keyword4", 
        "value": "8310380131", 
        "color": "#00ff00", 
        "font_size": "12", 
        "text_style": "bold"
      }
    ]
  }, 
  "client_ids": [
    "a86e83a26be44eb59806901cc8be5d5c"
  ], 
  "platforms": [
    "ANDROID"
  ]
}

返回数据:

字段类型说明
idString推送计划ID
material_idString推送的素材ID
app_idString推送者ID
expectsint目标推送数
failsint推送失败数
oksint成功推送数
scopesList<String>发送范围,组织路径,例如/122/234/
client_idsList<String>消息推送的对象标记

返回示例:

点击查看返回示例
{
  "status": 0, 
  "message": "Everything is ok.", 
  "result": {
    "domain_id": "atwork", 
    "org_id": "a918d8a6-67e9-4e76-8503-baa73d3c6fd2", 
    "id": "f3b9250c-96d4-414b-be7f-308f2fdeca99", 
    "app_id": "92bc3faa-12bd-4afc-9962-01f2410f0bee", 
    "material_id": "52dec89a-04a0-4127-99b5-a3d136c638a4", 
    "expects": 0, 
    "fails": 0, 
    "oks": 0, 
    "create_time": 1485053077748, 
    "refresh_time": 0, 
    "expect_time": 1485054877748, 
    "scopes": [ ], 
    "client_ids": [
      "/232/301/c24b6a94cfb14b79af12a1399edc9e31"
    ]
  }
}

错误返回值:

statusmessage说明
10011token not found.访问令牌不存在
202012没有对应的雇员没有对应的雇员