探马OpenAPI

跟进客户任务-客户跟进

POST

/api/v3/customer-follow-task/save

taskCode参数：
1.发微信
2.发短信
3.打电话
4.拜访
5.其他

对于发短信、打电话、拜访、其他类型的任务，仅支持文本信息。
图片：文件不要超过2M，最多支持9张图片
视频：文件不超过5MB，仅支持1个

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

taskCode

integer

任务类型：

必需

1.发微信 2.发短信 3.打电话 4.拜访 5.其他 6.发朋友圈

salesIds

array[integer]

指定执行员工

必需

数据来自分页查询员工信息data数据中的id值

sopContents

array [object {8}]

任务数据

必需

type

integer

任务内容类型

必需

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

fileId

integer

文件ID

可选

通过 SOP素材上传接口上传后返回文件ID。图片/链接/视频/文件

fileUrl

string

文件链接

可选

通过 SOP素材上传接口上传后返回文件链接地址。图片/链接/视频/文件

mediaId

string

媒体ID

可选

通过 SOP素材上传接口上传后返回媒体ID。图片/链接/视频/文件

fileName

string

文件名称

可选

通过 SOP素材上传接口上传后返回文件名称。图片/链接/视频/文件

content

string

任务内容参数

可选

sopContents-type为1时必填。对应为：文本内容简介描述

link

string

链接

可选

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

titile

string

内容标题

可选

sopContents-type为3时必填。对应为：链接标题

startTime

string

发送开始时间

必需

日期格式yyyy-MM-dd HH:mm 。如2022-04-12 11:20

endTime

string

发送截止时间

必需

日期格式yyyy-MM-dd HH:mm 。如2022-04-13 11:20

customers

array [object {3}]

客户信息

可选

不指定则后台处理默认发全部客户

salesId

integer

对应销售id

必需

customerId

integer

客户id

必需

customerName

string

客户名字

必需

示例

{
  "taskCode": 1,
  "salesIds": [
    463352988837952
  ],
  "sopContents": [
    {
      "type": 2,
      "fileId": 9173,
      "fileURL": "https://dev.tanmarket.cn/fdfsServer/group3/M00/90/44/rBHTdWI8F_OAEVMYAAFWABr5UHw296.png",
      "mediaId": "3BPfL85vzolL3WZcHW40O08_SsVgnDiM48IR-1VfZ7UPNKDqT7sEqutkWk63vwzaz",
      "fileName": "Snipaste_2022-03-04_10-50-32.png"
    },
    {
      "type": 1,
      "content": "测试04141111"
    }
  ],
  "startTime": "2022-04-14 17:20",
  "endTime": "2022-04-14 17:22",
  "textarea": "",
  "customers": [
    {
      "corpid": "ww9c5530210a0d5116",
      "salesId": 463352988837952,
      "customerId": 450458062432320,
      "isCustomer": 1,
      "customerName": "Main"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/customer-follow-task/save' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskCode": 1,
    "salesIds": [
        463352988837952
    ],
    "sopContents": [
        {
            "type": 2,
            "fileId": 9173,
            "fileURL": "https://dev.tanmarket.cn/fdfsServer/group3/M00/90/44/rBHTdWI8F_OAEVMYAAFWABr5UHw296.png",
            "mediaId": "3BPfL85vzolL3WZcHW40O08_SsVgnDiM48IR-1VfZ7UPNKDqT7sEqutkWk63vwzaz",
            "fileName": "Snipaste_2022-03-04_10-50-32.png"
        },
        {
            "type": 1,
            "content": "测试04141111"
        }
    ],
    "startTime": "2022-04-14 17:20",
    "endTime": "2022-04-14 17:22",
    "textarea": "",
    "customers": [
        {
            "corpid": "ww9c5530210a0d5116",
            "salesId": 463352988837952,
            "customerId": 450458062432320,
            "isCustomer": 1,
            "customerName": "Main"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

示例

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

创建客户群发任务

朋友圈任务执行详情