探马OpenAPI

客户SOP-定期提醒SOP

POST

/api/v3/customer-sop/save

客户SOP:

定期提醒SOP-功能同WEB管理后台一致.
type字段：

1-定期提醒；

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

title

string

SOP名称

必需

salesIds

array[integer]

指定执行员工

必需

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

tagIds

array[integer]

客户标签ID值。将匹配包含这些标签数据的客户，不传则匹配全部客户

可选

customerConditions

array [object {6}]

客户字段值的匹配条件。客户字段变成传入的值会匹配对应客户.

可选

数据格式。 "customerConditions": [{ "id": 917, "name": "客户意向", "type": 2, "ids": [ 58, 59, 60, 61 ], "names": [ "5", "A1", "A2", "A3" ], "options": [{ "itemId": 58, "name": "5", "fieldId": 917, "seq": 0 }, { "itemId": 59, "name": "A1", "fieldId": 917, "seq": 1 }, { "itemId": 60, "name": "A2", "fieldId": 917, "seq": 2 }, { "itemId": 61, "name": "A3", "fieldId": 917, "seq": 3 }, { "itemId": 62, "name": "A4", "fieldId": 917, "seq": 4 } ] }]

integer

字段ID

必需

name

string

字段名称

必需

用于管理后台预览展示，该值不影响任务下发。

type

integer

字段类型

必需

ids

array[integer]

选项ID集合

必需

根据id值匹配客户

names

array[string]

选项名称集合

必需

用于管理后台预览展示，该值不影响任务下发。

options

array [object {4}]

字段选项集合

必需

sopContents

array [object {4}]

SOP任务数据

必需

sopDatas

array [object {14}]

SOP任务明细内容

必需

sendType

integer

发送类型

必需

0：当天某时间发送 1：指定几天后某时间发送

sendTime

string

发送时间

必需

当sendType为0时，必传该值。数据格式用英文 : 分隔,代表 “时:分”。如当天1小时5分钟发送，则为 1:5 ，当天 59分钟后发送，则为 0:59 。最多支持24小时59分即 24:59

sendDay

integer

发送天数

可选

当sendType为1时，必传该值，将采用该值与sendTime结合的计时方式. 代表第几天的某小时某分钟发送。最小值为1

type

integer

任务类型

必需

固定为1-定期提醒

示例

{
	"title": "测试04131755",
	"salesIds": [
		463352988837952
	],
	"tagIds": [
		35475,
		37626,
		37625,
		37624,
		35432
	],
	"customerConditions": [{
		"id": 917,
		"name": "客户意向",
		"type": 2,
		"ids": [
			58,
			59,
			60,
			61
		],
		"names": [
			"5",
			"A1",
			"A2",
			"A3"
		],
		"options": [{
				"itemId": 58,
				"name": "5",
				"fieldId": 917,
				"seq": 0
			},
			{
				"itemId": 59,
				"name": "A1",
				"fieldId": 917,
				"seq": 1
			},
			{
				"itemId": 60,
				"name": "A2",
				"fieldId": 917,
				"seq": 2
			},
			{
				"itemId": 61,
				"name": "A3",
				"fieldId": 917,
				"seq": 3
			},
			{
				"itemId": 62,
				"name": "A4",
				"fieldId": 917,
				"seq": 4
			}
		]
	}],
	"sopContents": [{
			"sopDatas": [{
					"type": 1,
					"content": "#客户昵称##员工姓名#"
				},
				{
					"type": 99,
					"mcId": "bbbfe85ba01711ecacc500163e106b20",
					"title": "官网测一波",
					"content": "大大滴",
					"fileUrl": "https://dev.tanmarket.cn/fdfsServer/group3/M00/1B/22/rBHDsmIpXmWAdDwVAACFBkjOJ7o826.jpg",
					"mcType": 2
				},
				{
					"type": 2,
					"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",
					"sign": "32c918e8fc8167222f617fb08ba56ac1",
					"fileId": 9176
				},
				{
					"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",
					"sign": "32c918e8fc8167222f617fb08ba56ac1",
					"fileId": 9176,
					"link": "https://ww.tm.com",
					"title":"这是一个链接"
				}
			],
			"sendType": 0,
			"sendTime": "12:10"
		},
		{
			"sopDatas": [{
					"type": 1,
					"content": "#04131749000000测试#"
				},
				{
					"type": 99,
					"mcId": "bbbfe85ba01711ecacc500163e106b20",
					"title": "官网测一波",
					"content": "大大滴",
					"fileUrl": "https://dev.tanmarket.cn/fdfsServer/group3/M00/1B/22/rBHDsmIpXmWAdDwVAACFBkjOJ7o826.jpg",
					"mcType": 2
				}
			],
			"sendType": 1,
			"sendDay": 1,
			"sendTime": "00:00"
		}
	],
	"type": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/customer-sop/save' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
	"title": "测试04131755",
	"salesIds": [
		463352988837952
	],
	"tagIds": [
		35475,
		37626,
		37625,
		37624,
		35432
	],
	"customerConditions": [{
		"id": 917,
		"name": "客户意向",
		"type": 2,
		"ids": [
			58,
			59,
			60,
			61
		],
		"names": [
			"5",
			"A1",
			"A2",
			"A3"
		],
		"options": [{
				"itemId": 58,
				"name": "5",
				"fieldId": 917,
				"seq": 0
			},
			{
				"itemId": 59,
				"name": "A1",
				"fieldId": 917,
				"seq": 1
			},
			{
				"itemId": 60,
				"name": "A2",
				"fieldId": 917,
				"seq": 2
			},
			{
				"itemId": 61,
				"name": "A3",
				"fieldId": 917,
				"seq": 3
			},
			{
				"itemId": 62,
				"name": "A4",
				"fieldId": 917,
				"seq": 4
			}
		]
	}],
	"sopContents": [{
			"sopDatas": [{
					"type": 1,
					"content": "#客户昵称##员工姓名#"
				},
				{
					"type": 99,
					"mcId": "bbbfe85ba01711ecacc500163e106b20",
					"title": "官网测一波",
					"content": "大大滴",
					"fileUrl": "https://dev.tanmarket.cn/fdfsServer/group3/M00/1B/22/rBHDsmIpXmWAdDwVAACFBkjOJ7o826.jpg",
					"mcType": 2
				},
				{
					"type": 2,
					"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",
					"sign": "32c918e8fc8167222f617fb08ba56ac1",
					"fileId": 9176
				},
				{
					"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",
					"sign": "32c918e8fc8167222f617fb08ba56ac1",
					"fileId": 9176,
					"link": "https://ww.tm.com",
					"title":"这是一个链接"
				}
			],
			"sendType": 0,
			"sendTime": "12:10"
		},
		{
			"sopDatas": [{
					"type": 1,
					"content": "#04131749000000测试#"
				},
				{
					"type": 99,
					"mcId": "bbbfe85ba01711ecacc500163e106b20",
					"title": "官网测一波",
					"content": "大大滴",
					"fileUrl": "https://dev.tanmarket.cn/fdfsServer/group3/M00/1B/22/rBHDsmIpXmWAdDwVAACFBkjOJ7o826.jpg",
					"mcType": 2
				}
			],
			"sendType": 1,
			"sendDay": 1,
			"sendTime": "00:00"
		}
	],
	"type": 1
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

客户SOP-群发活动SOP

客户SOP-新增好友SOP