探马OpenAPI

创建朋友圈任务

POST

/api/v3/sendCircle

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

taskType

integer

任务类型

必需

6 员工转发，18 一键发表

taskName

string

任务名称

可选

custType

integer

选择客户

必需

0：筛选客户、1：全部客户

tagIds

array[string]

筛选的标签

可选

custType=0 必传,筛选的标签数组，最多30个

salesIds

array[integer]

执行员工id

必需

执行员工id，最大100

startTime

string

任务开始时间

必需

不能小于当前时间

endTime

string

任务结束时间

必需

不能小于开始时间

overdueReminder

boolean

逾期提醒

可选

true 提醒 false 不提醒, 默认false

likeTag

string

点赞标签id

可选

commentTag

string

评论标签id

可选

sopContents

array [object {9}]

朋友圈内容

必需

type

integer

朋友圈内容类型

必需

1-文本，2-图片，3-链接，4-视频

content

string

内容

可选

type=1 必传最大2000字，type=3,最大170字

mediaId

string

媒体ID

可选

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

fileName

string

文件名称

可选

通过上传文件上传后返回文件名称。图片/链接/视频为必填

sign

string

签名

可选

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

createTime

string

上传时间

可选

通过上传文件上传后返回上传时间。图片/链接/视频必填

url

string

链接图片地址

可选

通过上传文件上传后返回文件链接地址。图片/链接/视频为必填

link

string

链接地址

可选

type=3必传，链接地址

title

string

链接标题

可选

type=3,必传，最大42字符

示例

{
  "taskType": 18,
  "custType": 1,
  "tagIds": [],
  "salesIds": [
    93186
  ],
  "startTime": "2023-05-19 00:00",
  "endTime": "2023-06-30 23:59",
  "overdueReminder": true,
  "likeTag": "",
  "commentTag": "",
  "sopContents": [
    {
      "type": 1,
      "content": "xxsdsd"
    },
    {
      "type": 2,
      "mediaId": "WWME_2ohRCAAAO-clE2j3_KCN44rrjlUVig",
      "fileName": "WeChat_20230518105909.png",
      "sign": "da5b7cfd5519f8b9",
      "createTime": "2023-05-18 21:26:10",
      "url": "https://blue.wechatsi.com/fdfsServer/group1/M00/03/EF/rBIAdasJ2HrYY2RmJ62A.png"
    },
    {
      "type": 3,
      "link": "http://www.baidu.com",
      "title": "链接标题",
      "content": "链接内容",
      "mediaId": "WWME_2ohRCAAAO-clE2j3_KCN44rrjlUVig",
      "fileName": "WeChat_20230518105909.mp4",
      "sign": "da5b7cfd5519f8b9",
      "createTime": "2023-05-18 21:26:10",
      "url": "https://blue.wechatsi.com/fdfsServer/group1/M00/03/EF/rBIAY2R.png"
    },
    {
      "type": 4,
      "mediaId": "WWME_2ohRCAAAO-clE2j3_KCN44rrjlUVig",
      "fileName": "WeChat_20230518105909.mp4",
      "sign": "da5b7cfd5519f8b9",
      "createTime": "2023-05-18 21:26:10",
      "url": "https://blue.wechatsi.com/fdfsServer/group1/M00/03/EF/rBIAY2RmJ62AP73AACptB2Dca_I425.mp4"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/sendCircle' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskType": 18,
    "custType": 1,
    "tagIds": [],
    "salesIds": [
        93186
    ],
    "startTime": "2023-05-19 00:00",
    "endTime": "2023-06-30 23:59",
    "overdueReminder": true,
    "likeTag": "",
    "commentTag": "",
    "sopContents": [
        {
            "type": 1,
            "content": "xxsdsd"
        },
        {
            "type": 2,
            "mediaId": "WWME_2ohRCAAAO-clE2j3_KCN44rrjlUVig",
            "fileName": "WeChat_20230518105909.png",
            "sign": "da5b7cfd5519f8b9",
            "createTime": "2023-05-18 21:26:10",
            "url": "https://blue.wechatsi.com/fdfsServer/group1/M00/03/EF/rBIAdasJ2HrYY2RmJ62A.png"
        },
        {
            "type": 3,
            "link":"http://www.baidu.com",
            "title":"链接标题",
            "content":"链接内容",
            "mediaId": "WWME_2ohRCAAAO-clE2j3_KCN44rrjlUVig",
            "fileName": "WeChat_20230518105909.mp4",
            "sign": "da5b7cfd5519f8b9",
            "createTime": "2023-05-18 21:26:10",
            "url": "https://blue.wechatsi.com/fdfsServer/group1/M00/03/EF/rBIAY2R.png"
        },
        {
            "type": 4,
            "mediaId": "WWME_2ohRCAAAO-clE2j3_KCN44rrjlUVig",
            "fileName": "WeChat_20230518105909.mp4",
            "sign": "da5b7cfd5519f8b9",
            "createTime": "2023-05-18 21:26:10",
            "url": "https://blue.wechatsi.com/fdfsServer/group1/M00/03/EF/rBIAY2RmJ62AP73AACptB2Dca_I425.mp4"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

示例

{
  "code": 0,
  "message": "success"
}

修改于 2024-07-12 07:59:05

朋友圈任务执行详情

删除/中止朋友圈任务