探马OpenAPI

创建客户群发任务

POST

/api/v3/customerSend/addTask

不支持管理后台筛选客户功能，仅支持群发全部客户

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

salesId

array[number]

员工id

必需

员工id

sendType

integer

发送类型

必需

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

taskName

string

任务名称

可选

sendTime

string

发送时间

可选

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

text

string

文本内容

可选

文本内容和附件不得同时为空

sendInfo

array [object {14}]

附件内容

可选

只支持图片、外链、小程序、营销内容，最多支持9个附件

type

integer

内容类型

必需

1-文本，2-图片，3-链接，4-视频，5-文件，6-小程序，99-营销内容

fileId

integer

文件id

可选

文件上传后返回文件ID。图片/链接/视频/文件/小程序为必填

fileName

string

文件名称

可选

文件上传后文件名称。图片/链接/视频/文件/小程序为必填

fileUrl

string

文件url

可选

文件上传后文件链接地址。图片/链接/视频/文件/小程序为必填

mediaId

string

可选

文件上传后返回媒体ID。图片/链接/视频/文件/小程序为必填

content

string

内容

可选

sopDatas-type为1,6,99时必填。对应为：文本内容,营销内容简介,小程序描述

title

string

标题

可选

sopDatas-type为3,99时必填。对应为：链接标题,营销内容标题

link

string

外链跳转地址

可选

sopDatas-type为3时，必填该值，以https://或http://开头

mcType

integer

营销内容类型

可选

sopDatas-type为99时，必填该值

mcId

string

营销内容id

可选

sopDatas-type为99时，必填该值

appid

string

小程序appid

可选

sopDatas-type为6时，必填该值

page

string

小程序页面路径

可选

sopDatas-type为6时，必填该值

sign

string

文件签名

可选

文件上传后返回签名。图片/视频/文件为必填

createTime

string

文件上传时间

可选

文件上传后返回上传时间。图片/链接/视频/文件/小程序为必填

示例

{
  "sendType": 1,
  "salesId": [
    463352988837952,
    459662865780800
  ],
  "sendTime": "2022-04-25 10:00:25",
  "text": "casdsadsadads",
  "sendInfo": [
    {
      "type": 99,
      "mcId": "bbbfe85ba01711ecacc500163e106b20",
      "title": "官网测一波",
      "content": "大大滴",
      "fileUrl": "https://dev.tanmarket.cn/fdfsServer/group3/M00/1B/22/rBHDsmIpXmWAdDwVAACFBkjOJ7o826.jpg",
      "mcType": 2
    },
    {
      "type": 3,
      "fileName": "Snipaste_2022-03-03_17-04-37.png",
      "fileUrl": "https://dev.tanmarket.cn/fdfsServer/group3/M00/90/44/rBHTdWI8GgSAEruhAAOznwRlgDY036.png",
      "mediaId": "31sRwaYurqxKSKaJG_OOkZ_h_CB2D4g3BIdsn4t9x7KnpIBQjD3XbjQLvpdP0upj0",
      "fileId": 9176,
      "link": "https://ww.tm.com",
      "title": "这是一个链接"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/customerSend/addTask' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sendType": 1,
    "salesId": [
        463352988837952,
        459662865780800
    ],
    "sendTime": "2022-04-25 10:00:25",
    "text": "casdsadsadads",
    "sendInfo": [
        {
            "type": 99,
            "mcId": "bbbfe85ba01711ecacc500163e106b20",
            "title": "官网测一波",
            "content": "大大滴",
            "fileUrl": "https://dev.tanmarket.cn/fdfsServer/group3/M00/1B/22/rBHDsmIpXmWAdDwVAACFBkjOJ7o826.jpg",
            "mcType": 2
        },
        {
            "type": 3,
            "fileName": "Snipaste_2022-03-03_17-04-37.png",
            "fileUrl": "https://dev.tanmarket.cn/fdfsServer/group3/M00/90/44/rBHTdWI8GgSAEruhAAOznwRlgDY036.png",
            "mediaId": "31sRwaYurqxKSKaJG_OOkZ_h_CB2D4g3BIdsn4t9x7KnpIBQjD3XbjQLvpdP0upj0",
            "fileId": 9176,
            "link": "https://ww.tm.com",
            "title": "这是一个链接"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

修改于 2024-07-12 10:07:55

创建群群发任务

跟进客户任务-客户跟进