API接口文档 (小组级)
  1. 加好友接口
API接口文档 (小组级)
  • 接入说明
  • 快速入门
    • 加密手机号加好友方案
    • 加密版接口
    • 如何发送一条消息
    • 通过接口实现群发
    • 加密externalUserId打通方案
    • unionId打通方案
  • 接口文档
    • 小组级接口
      • 小组级接口说明
      • 基础接口
        • 获取托管企业微信列表
        • 获取个人微信授权到期及首次扫码登录的时间
        • 获取联系人列表
        • 获取群列表
        • 获取群列表(不包含成员信息)
        • 发送系统通知
        • 获取自定义标签列表
        • 获取组内员工列表
      • 群聊接口
        • 加入群聊
        • 退出群聊事件回调
        • 加入群聊事件回调
        • 更改群名事件回调
        • 创建群聊
        • 通过联系人id获取联系人所在群聊
      • 会话接口
        • 开发建议
        • 获取指定会话
        • 获取会话列表
        • 会话事件回调
        • 分配会话
        • 消息置顶
      • 加好友接口
        • 通过手机号加好友接口
          POST
        • 加好友任务成功回调
          POST
        • 好友通过后回调
          POST
        • 群聊加好友接口
          POST
      • 消息接口
        • 获取原图
        • 发送消息
        • 小组级接收消息回调
        • 聊天历史
        • 企微id发消息
      • 群发接口
        • 创建群发
        • 创建群发 Copy
        • 重发群发
        • 取消群发
        • 删除群发
        • 群发回调
        • 获取群发任务的失败列表
        • 获取群发任务的没有发送的列表
        • 获取群发任务的进度
    • 自建应用依赖接口
      • 自建应用依赖接口说明
      • 客户信息接口
        • 修改客户备注
        • 添加跟进记录
      • 雷达接口
        • 雷达访问接口
      • id信息获取接口
        • 获取chatId
        • 通过unionId获取chatId
    • 废弃接口
      • 会话小结
      • 渠道二维码管理
        • 获取渠道列表(企业控制台数据)
      • 通过企微id群聊加好友
      • 新增客户
      • 获取成员详情
      • 获取客户列表(2023/12/05 废弃)
      • 秒回数据同步
      • 获取群列表
      • 获取客户详情
      • 获取群信息
      • 绑定企业微信官方ID
      • 通过externalUserId获取chatId
      • 获取群列表(2023/2/05 废弃)
  • 更新日志
    • 更新日志
  1. 加好友接口

加好友任务成功回调

POST
/friend/send
功能说明:
本接口会将成功添加好友任务的数据进行回调
如果需要加好友事件回调,可以参考:https://apifox.com/apidoc/shared-7d5bf7ae-ff7c-4e09-b4d6-530a597f03b8/api-147790341

请求参数

Body 参数application/json
code
enum<number> 
必需
0 发送成功, 1 搜索不到或搜索失败
枚举值:
01
data
object 
加好友详情
必需
fromwxid
string 
托管账号系统联系人id
必需
fromwxName
string 
托管账号名称
必需
企微号名称
fromwxAvatar
string 
托管账号头像
必需
企微号头像
type
enum<number> 
加好友的方式类型
必需
枚举值:
123
phoneNum
string 
手机号
可选
type为1时存在
roomWxid
string 
系统群聊id
可选
type为2时存在
contactSenderWxid
string 
发名片人的系统联系人id
可选
type为3时存在
extraInfo
string 
附加信息
必需
payload
object 
添加的联系人信息
必需
当code为0时返回
createTimestamp
number 
任务创建时间
必需
sendTimestamp
number 
好友申请发送时间
必需
token
string 
接口调用凭证
必需
message
string 
错误信息
可选
code为1时返回
示例
{
  "code": 0,
  "data": {
    "fromwxid": "string",
    "fromwxName": "string",
    "fromwxAvatar": "string",
    "type": 1,
    "phoneNum": "string",
    "roomWxid": "string",
    "contactSenderWxid": "string",
    "extraInfo": "string",
    "payload": {
      "avatar": "string",
      "name": "string",
      "gender": 0,
      "wxid": "string",
      "friend": true
    },
    "createTimestamp": 0,
    "sendTimestamp": 0,
    "token": "string"
  },
  "message": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://aa-stream-api.ddregion.com/friend/send' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": 0,
    "data": {
        "fromwxid": "string",
        "fromwxName": "string",
        "fromwxAvatar": "string",
        "type": 1,
        "phoneNum": "string",
        "roomWxid": "string",
        "contactSenderWxid": "string",
        "extraInfo": "string",
        "payload": {
            "avatar": "string",
            "name": "string",
            "gender": 0,
            "wxid": "string",
            "friend": true
        },
        "createTimestamp": 0,
        "sendTimestamp": 0,
        "token": "string"
    },
    "message": "string"
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
上一页
通过手机号加好友接口
下一页
好友通过后回调
Built with