探马OpenAPI

创建手动发送SOP

POST

/api/v3/groupSop/addGroupCorporate

groupInfos：查询群标签列表接口获取群聊信息。chatId为群聊id、chatOwner为群主id

showDate：第几天发送。传值1为创建任务的当天
showTime：具体发送时间. 格式 HH:mm

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

groupInfos

array [object {2}]

群信息

必需

chatId

string

群id

必需

群列表接口返回的群id

chatOwner

string

群主id

必需

群列表接口返回的群主id

title

string

SOP名称

必需

mode

integer

模式

必需

0:群主模式,1:群主+成员(只要有一个执行，任务自动完成)

sopContents

array [object {3}]

任务内容

必需

支持文本，图片，链接，视频，文件，营销内容

showTime

string

发送时间

必需

格式：HH:mm 09:38

showDate

integer

第几天发送

必需

第1天为创建任务的当天

sopDatas

array [object {14}]

任务内容

必需

最多支持1条文本+9个附件

示例

{
  "groupInfos": [
    {
      "chatId": "wrvRo3DwAAWTbx-K7XDplMusYYlHs_uw",
      "chatOwner": "399653652604992"
    },
    {
      "chatId": "wrvRo3DwAAnjo-sVKj5b8T1zecpRxV6w",
      "chatOwner": "412770248998976"
    }
  ],
  "title": "API测试0424145100002",
  "sopContents": [
    {
      "showDate": 5,
      "showTime": "10:00",
      "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": 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": "这是一个链接"
        }
      ]
    }
  ],
  "mode": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/groupSop/addGroupCorporate' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "groupInfos": [
        {
            "chatId": "wrvRo3DwAAWTbx-K7XDplMusYYlHs_uw",
            "chatOwner": "399653652604992"
        },
        {
            "chatId": "wrvRo3DwAAnjo-sVKj5b8T1zecpRxV6w",
            "chatOwner": "412770248998976"
        }
    ],
    "title": "API测试0424145100002",
    "sopContents": [
        {
            "showDate": 5,
            "showTime":"10:00",
            "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": 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": "这是一个链接"
				}
            ]
        }

    ],
    "mode": 1
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

修改于 2022-06-11 11:45:08

创建添加客户任务(分配线索/待分配客户)

创建群发助手SOP