探马OpenAPI

创建群群发任务

POST

/api/v3/groupSend/addTask

sendTime参数必须晚于当前时间10分钟。

比如当前日期为2022-04-30 11:10:10 ,则请求时间最早应为2022-04-30 11:21:10

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

users

array[string]

员工id

可选

部门id和员工id不得同时为空

title

string

任务名称

必需

sendType

integer

发送模式

必需

0-立即发送，1-定时发送

sendTime

string

发送时间

可选

格式：yyyy-MM-dd HH:mm:ss，定时发送模式下不得为空

sendInfo

object

发送内容

必需

text

string

文本信息

可选

文本信息和任务内容不得同时为空

sendData

array [object {14}]

任务内容

可选

只支持图片、外链、小程序、营销内容

示例

{
  "title": "测试0424154000001",
  "sendTime": "2022-04-24 15:59:00",
  "users": [
    463352988837952
  ],
  "sendInfo": {
    "text": "测试群发1234512312312",
    "sendData": {
      "type": 99,
      "mcId": "bbbfe85ba01711ecacc500163e106b20",
      "title": "官网测一波",
      "content": "大大滴",
      "fileUrl": "https://dev.tanmarket.cn/fdfsServer/group3/M00/1B/22/rBHDsmIpXmWAdDwVAACFBkjOJ7o826.jpg",
      "mcType": 2
    }
  },
  "sendType": "1"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/groupSend/addTask' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "测试0424154000001",
    "sendTime": "2022-04-24 15:59:00",
    "users": [
        463352988837952
    ],
    "sendInfo": {
        "text":    "测试群发1234512312312",
        "sendData": {
            "type": 99,
            "mcId": "bbbfe85ba01711ecacc500163e106b20",
            "title": "官网测一波",
            "content": "大大滴",
            "fileUrl": "https://dev.tanmarket.cn/fdfsServer/group3/M00/1B/22/rBHDsmIpXmWAdDwVAACFBkjOJ7o826.jpg",
            "mcType": 2
        }
    },
    "sendType": "1"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

修改于 2022-06-11 11:14:23

创建群发助手SOP

创建客户群发任务