第三方接入
1.获取client_id、client_secret
进入API秘钥管理
创建秘钥
2. 获取请求Token
请求头
| Header | |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
请求body
| 参数 | 是否必填 | 示例值 | 说明 |
|---|---|---|---|
| client_id | 是 | y3a79b4ebdc8bb47a18180df8012181986 | 请求的客户端标识（需要到后台申请） |
| client_secret | 是 | af6708b399e248de8468419476f7501e | 请求的客户端秘钥（需要到后台申请） |
| grant_type | 是 | client_credentials | 授权方式 |
| scope | 是 | Y3.FanAssistant.WebApi | 授权作用域 |
返回结果
| 参数 | 示例值 | 说明 |
|---|---|---|
| access_token | eyJhbGciOiJSUzI1NiIsImt... | 授权token |
| expires_in | 3600 | 过期时长 单位秒 |
| token_type | Bearer | token 类型 |
| scope | Y3.RepetitionFansRemind.WebApi | 授权作用域 |
3. 获取万花桶已授权的加粉账号列表
请求头Header
| 参数 | 类型 | 是否必填 | 示例值 | 说明 |
|---|---|---|---|---|
| Content-Type | string | 是 | application/json | |
| Authorization Bearer Token | string | 是 | eyJhbGciOiJSUzI1NiIsImt... | 获取的token |
请求body 无
返回结果
| 参数 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| Id | int | 168 | 加粉账号主键，提交任务时必传 |
| TenantId | string | 1082 | 计费租户编号 |
| Acount | string | david08265427 | 加粉账号 |
| AcountName | string | Watson_test-david08265427 | 账户名 |
| AppType | int | 1 | APP类型(1:企微（主）2:企微(分身)3:个微（主）4:个微(分身)) |
| Remark | strng | 张三 | 备注 |
| DayLimit | int | 30 | 运营号每天执行任务上限 |
| SupportBatchTask | bool | true | 支持执行批量任务添加好友 |
| ExecNum | int | 20 | 当天已执行数量 |
| machineName | string | M21639394396020101 | 设备名称字段 |
| state | int | 1 | 状态 |
4. 提交加粉任务(不支持批量)
请求头Header
| 参数 | 类型 | 是否必填 | 示例值 | 说明 |
|---|---|---|---|---|
| Content-Type | string | 是 | application/json | |
| Authorization Bearer Token | string | 是 | eyJhbGciOiJSUzI1NiIsImt... | 获取的token |
请求body
| 参数 | 类型 | 是否必填 | 示例值 | 说明 |
|---|---|---|---|---|
| ExecAccountId | int | 是 | 168 | 指定执行账号Id(即同步的加粉账号主键) |
| account | string | 是 | david08265427 | 加粉账号 |
| desc | string | 否 | 666 | 粉丝微信描述 |
| remarkName | string | 否 | 666 | 粉丝微信备注 |
| Channel | string | 是 | CRM | 渠道 |
| ExtraField | string | 是 | 100 | 结果回调唯一标识，用于加粉结果回调定位客户 |
| SayHi | string | 否 | 您好，添加一下微信 | 打招呼语 |
| AppType | int | 是 | 1 | 账号同步的APP类型 |
| IsExecuteNow | bool | 是 | false | 是否立即执行（设置为false时由万花桶调配执行） |
返回结果
| 参数 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| code | int | 0 | 返回码(0成功，其他失败) |
| message | string | 商户不存在 | 返回错误时的错误信息 |
| data | string |
5. 查询加粉结果（每次最多返回1000条数据）
请求头Header
| 参数 | 类型 | 是否必填 | 示例值 | 说明 |
|---|---|---|---|---|
| Content-Type | string | 是 | application/json | |
| Authorization Bearer Token | string | 是 | eyJhbGciOiJSUzI1NiIsImt... | 获取的token |
请求body
| 参数 | 类型 | 是否必填 | 示例值 | 说明 |
|---|---|---|---|---|
| updateTime | datetime | 是 | 2023-12-20 11:00:00 | 最后获取加粉结果的时间（不能查询超过一年的数据） |
返回结果
| 参数 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| code | int | 0 | 返回码(0成功，其他失败) |
| message | string | 商户不存在 | 返回错误时的错误信息 |
| data | List | 返回的List集合 |
data数据
| 参数 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| Id | int | 1234 | 主键 |
| MissionId | int | 132 | 任务Id |
| FanAccount | 15987485498 | string | 自定义备注 |
| AppType | int | 1 | 账号同步的APP类型 |
| MachineId | string | M21634538813254171 | 运营机标识 |
| AccountName | string | P06机器ren-kkk368555 | 执行的加粉的账号名 |
| Account | string | kkk368555 | 执行的加粉的账户 |
| AddTime | DateTime | 2023-12-20T11:34:11 | 添加时间 |
| State | int | 0 | 状态（0未执行，1已执行） |
| TaskId | string | 21703043256574178 | 下发万花桶的任务编号 |
| ResultInfo | string | 等待手机执行 | 状态结果描述 |
| ActualExecTime | DateTime | 2023-12-20T11:34:16 | 实际下发任务时间 |
| AddFriendExecState | string | 5 | 添加好友执行状态 |
| UpdateTime | string | 2023-12-20T11:34:16 | 最后修改时间 |
| ExtraField | string | 248 | 发任务传入的自定义编号，用于加粉结果回调定位客户 |
AddFriendExecState 状态
| 值 | 说明 |
|---|---|
| 0 | 等待验证 |
| 1 | 脚本执行失败 |
| 2 | 已是好友 |
| 3 | 对方账号异常 |
| 4 | 操作频繁 |
| 5 | 等待手机执行 |
| 6 | 用户不存在 |
| 7 | 成功添加 |
| 8 | 已失效,3天前发的添加申请 |
| 9 | 已失效,对方已把你加入黑名单 |
state 状态
| 值 | 说明 |
|---|---|
| -1 | 请忽略此值 |
| 0 | 请忽略此值 |
| 1 | 账号正常 |
| 3 | 账号已删除 |
| 5 | 账号操作频繁 |
| 6 | 账号未登录设备 |
| 8 | 账号关联的RPA设备离线 |
修改于 2024-05-11 02:45:45