jing-openplatform-api
  1. 客户管理(Account Management)
jing-openplatform-api
  • 开放接口-V1文档 (Interface Document_V1)
    • 开发前必读(Must Read Before Development)
      • 接口更新日志 (Interface Update Log)
      • 接入指南(Access Guide)
      • 接口权限(Interface Permissions)
      • 访问频率和并发限制(Access Frequency & Concurrency Restrictions)
      • 全局错误码说明(Global Error Code Description)
    • OAuth授权(Authorization)
      • 获取访问Token(Get Access Token)
      • 刷新 Token(Refresh Token)
    • 用户管理(User Management)
      • 用户批量创建(User Batch Creation)
      • 用户查询(User Query)
      • 用户批量更新(User Batch Update)
      • 批量查询用户身份 (User Batch Query)
    • 用户群组 (User Group)
      • 查询静态人群列表 (Query Static Group)
      • 获取静态人群详情 (Get Static Group Details)
      • 查询静态人群详情用户列表 (Query Static Group User List)
      • 创建静态人群 (Creat Static Group)
      • 更新静态人群 (Update Static Group)
      • 删除静态人群 (Delete Static Group)
      • 导入群组用户 (Import Group User)
    • 用户标签(User Tags)
      • 批量创建普通标签(Batch Creating Tags)
      • 批量给用户打标签(Batch Tagging Users)
      • 查询普通标签 (Query Tags)
      • 移除用户标签 (Remove Tags)
    • 活动管理 (Activities Management)
      • 查询活动详情 (Query Activity Details)
      • 查询活动列表 (Query Activity List)
      • 查询活动报名用户列表 (Query Activity Registered User List)
      • 批量更新活动用户状态 (Batch Update Activity User Status)
    • 邮件管理 (EDM Management)
      • 查询邮箱列表 (Query Email Address List)
      • 创建发送邮件 (Crest Send Email)
      • 查询发送邮件详情 (Query Send Email Details)
      • 更新发送邮件 (Update Send Email)
      • 删除发送邮件 (Delete Send Email)
      • 查询发送邮件列表 (Query Send-Email List)
      • 查询发送明细 (Query Send Details)
    • 短信管理 (SMS Management)
      • 查询短信列表 (Query Message List)
      • 查询短信发送详情 (Query Send Message Detail)
      • 创建任务 (Create Task)
      • 发送 (Send Message)
    • 来源管理 (Source Management)
      • 查询来源选项 (Query Source Option)
      • 创建自定义来源选项 (Create Custom Source Option)
      • 更新自定义来源选项 (Update Custom Source Option)
      • 查询来源下所有选项 (Query all Options from Source)
    • 二维码管理 (QR Code Management)
      • 创建临时二维码 (Create Temporary QR Code)
      • 创建永久二维码 (Create Permanent QR Code)
    • 会员管理 (Member Management)
      • 会员创建 (Create Member)
      • 会员查询 (Query Member)
      • 会员更新 (Update Member)
      • 查询会员剩余积分 (Query Member Remaining Points)
      • 查询会员规则列表 (Query Member Rule List)
      • 查询会员列表 (Query Member List)
      • 扣减会员积分 (Deduct Member Points)
      • 增加会员积分 (Add Member Points)
    • 成员管理 (Employee Management)
      • 查询成员信息(Query Member Information)
    • 微信公众号 (WeChat Account)
      • 发送微信模版消息 (Send WeChat Template Message)
      • 获取用户的openid和关注状态 (Get User Openid & Follow Status)
    • 线索管理(Lead Management)
      • 线索创建(Lead Creation)
      • 线索更新(Lead Update)
      • 线索查询(Lead Query)
      • 线索状态列表查询(Get Lead Status List)
      • 线索状态更新(Get Status Update)
      • 线索布局列表查询(Lead List)
      • 更新线索协作人(Update Lead Collaborators)
      • 查询线索详情链接(Query Lead Details Link)
    • 客户管理(Account Management)
      • 客户创建(Account Creation)
        POST
      • 客户查询(Account Query)
        POST
      • 客户更新(Account Update)
        POST
      • 客户布局列表查询(Account List)
        POST
    • CRM 对象通用接口(CRM Object Interface)
      • 查询业务类型列表(Get Business Type)
      • 查询选项集字段(Get Option Set Fields)
      • 查询来源选项字段(获取下拉选项)(Source Field Type (Get Drop-down Options))
      • 查询自定义选项字段(Get Custom Option Set Fields)
      • 查询对象所有字段(Get All Fields of the Object)
    • CTA管理 (CTA Management)
      • 查询CTA列表 (Query CTA List)
      • 查询CTA明细列表 (Query CTA Detail List)
    • 模板消息 (Template Message)
      • 创建模版消息 (Create Template Message)
      • 创建模板消息推送 (Create Template Message Send)
      • 更新模板消息 (Update Template Message)
      • 查询模版消息详情 (Query Template Message Detail)
      • 删除模版消息 (Delete Template Message)
      • 查询模板消息列表 (Query Template Message List)
      • 查询微信模板列表 (Query WeChat Template Message List)
      • 查询消息模板推送明细 (Query Template Message Send Detail)
      • 查询消息模板点击明细 (Query Template Message Chick Detail)
      • 查询模板消息推送记录列表 (Query Template Message Send Record List)
    • 隐私条款v1(Privacy Policy_V1)
      • 查询隐私条款列表(Query Privacy Policy List)
      • 查询隐私条款授权记录列表(Query Privacy Policy Authorization Record List)
    • 隐私条款v2(Privacy Policy_V2)
      • 查询隐私条款列表(Query Privacy Policy List)
      • 新增用户授权记录(Add User Authorization Record)
      • 查询用户授权状态(Query User Authorization Status)
      • 移除用户授权记录(Delete User Authorization Record)
      • 查询隐私条款模版(Query Privacy Policy Templete)
    • 企业微信 (WeCom Management)
      • 发送企微应用消息(Send WeCom App Message)
      • 获取用户的企微好友状态(Get User's WeCom Friendship Status )
    • 评分管理 (Scoring Management)
      • 批量查询用户意向评分 (Batch Query User Intention Scoring)
      • 批量查询用户行为评分 (Batch Query User Active Scoring)
      • 批量查询线索身份评分 (Batch Query Lead Identity Scoring)
      • 批量查询线索行为评分 (Batch Query Lead Active Scoring)
      • 批量查询线索意向评分 (Batch Query Lead Intention Scoring)
      • 批量查询用户身份评分 (Batch Query User Identity Scoring)
      • 批量用户行为评分清零 (Batch Delete User Action Scoring)
    • 自定义事件 (Custom Events)
      • 创建自定义事件 (Creat Custom Events)
      • 上报自定义事件 (Report Custom Events)
    • 公司管理 (Company Management)
      • 批量创建公司 (Batch Create Company)
      • 批量更新公司 (Batch Update Company)
      • 批量删除公司 (Batch Delete Company)
      • 批量获取公司列表 (Batch Get Company List)
  • webhook
    • 用户(User)
      • 用户创建(User Creation)
      • 创建用户webhook推送事件(Create Push Events of User webhook)
        • add_omni_user_success事件(add_omni_user_success event)
      • 修改用户webhook推送事件
        • custom_field事件(修改用户信息)
    • 活动
      • 创建活动
        • 活动webhook-直播
        • 活动webhook-会议
      • 更新活动
        • 更改直播活动webhook
        • 更改会议活动webhook
      • 删除活动
        • 删除直播活动webhook
        • 删除会议活动webhook
    • 线索(Lead)
      • 线索事件说明文档(Description Document of Lead Event)
      • 创建线索webhook推送事件(Create Push Events of User webhook)
        • add_omni_user_success事件(add_omni_user_success event)
        • object_create事件(object_create event)
        • object_update_life_cycle事件(object_update_life_cycle event)
        • object_source_info事件(object_source_info event)
      • 线索更新(Lead Update)
        • object_update_life_cycle事件(object_update_life_cycle event)
        • object_update事件(object_update event)
      • 线索状态更新(Lead Update Status)
        • object_update_status事件(object_update_status event)
      • 线索作废(Lead Voided)
        • object_voids事件(object_voids event)
      • 线索负责人变更(Lead Owner Change)
        • object_change_owner事件(不包含线索信息)(object_change_owner event (without lead information))
        • object_change_owner事件(包含线索信息,需要平台人员手动配置启用)
      • 线索生命周期变更(Lead Lifecycle Change)
        • object_update_life_cycle事件(object_update_life_cycle event)
      • 线索添加备注(Lead Add Notes)
        • object_add_notes事件(object_add_notes event)
      • 线索添加协作人(Lead Add Collaborator)
        • object_add_team_member事件(object_add_team_member event)
      • 线索移除协作人(Lead Remove Collaborator)
        • object_remove_team_member事件(object_remove_team_member event)
      • 公海池变更(Lead Pool Change)
        • object_change_lead_pool事件(object_change_lead_pool event)
      • 线索关联(Lead Association)
        • object_relation事件(object_relation event)
      • 线索恢复(Lead Restore)
        • object_restore事件(object_restore event)
      • 线索来源 (Lead Source)
        • 线索来源(Lead Source)
    • 客户(Account)
      • 客户(Account)
      • 客户webhook推送(Account webhook Push)
        • 创建客户(Create Account)
          • object_create事件-客户(object_create event-Account)
        • 更新客户(Update Account)
          • object_update事件-客户(object_update event-Account)
        • 客户负责人变更(Object_Change_Owner)
          • object_change_owner事件-客户(object_change_owner event-Account)
        • 客户作废(object_voids)
          • object_voids事件-客户(object_voids event-Account)
        • 客户关联线索(object_relation)
          • object_relation事件-客户(object_relation event-Account)
    • 模板消息(Template Message)
      • 点击模板消息
      • 模板消息推送成功(Template Send Success)
      • 模板消息推送失败(Template Send Error)
      • 模板消息推送通知(Template Message Push Notification)
        • template_send事件(template_send event)
    • Jingtrack
      • JINGtrack-H5
        • 访问页面(pageView)
        • 自定义事件(customEvent)
      • JINGtrack-小程序
        • 访问页面 (小程序)(View Page)
          • pages/store/detail/detail事件(pages/store/detail/detail event)
        • 小程序自定义事件(tracking_customevent)
          • RemoveFromCart事件(RemoveFromCart Event)
        • 打开小程序(Open Mini Program)
          • tracking_vst事件(tracking_vst event)
        • 关闭小程序(Close Mini Program)
          • tracking_cls事件(tracking_cls event)
    • 评分(Scoring)
      • 身份等级变更(Identity Grade Updated)
        • 身份等级变更事件(custom_field_update event)
      • 行为等级变更(Active Level Update)
        • 行为等级变更事件(total_update event)
    • 用户行为(User Action)
      • 活动用户行为
        • 提交活动报名信息
      • CTA用户行为
        • CTA提交信息
      • 用户标签行为
        • 用户打标签
      • 授权隐私条款行为
        • 授权隐私条款(Authorized Privacy Policy)
    • 系统行为(System Action)
      • 活动系统行为
        • 活动报名用户状态变更(Change Activity Registered User Status)
  1. 客户管理(Account Management)

客户创建(Account Creation)

live-阿里云(Alibaba Cloud)
https://jingopenapi.jingsocial.com
live-阿里云(Alibaba Cloud)
https://jingopenapi.jingsocial.com
POST
https://jingopenapi.jingsocial.com
/v1/customer/create
-接口说明
如需操作自定义属性,则通过调用《获取对象所有字段》接口来获取相关属性code,自定义属性与预设字段同级。
接口返回的is_preset=0是自定义字段,is_preset=1是预设字段。
预设字段即标准字段可操作属性看该接口文档
自定义字段的type为department, multi_departmemt, image, look_up的不能创建或更新
接口调用限制为:
每秒10次;每天10000次
Interface Description:
If you need to operate custom attributes, you can get the relevant attribute code by calling the "Get all fields of an object" interface. The custom attributes are at the same level as the preset fields.
The interface returns is_preset=0 is a custom field and is_preset=1 is a preset field.
The operable attribute of the preset fields i.e. standard fields should refer to the interface documentation
The type of the custom field is department, multi_ departmemt, image, look_up cannot be created or updated
Interface calls are limited to:
10 times per second; 10,000 times per day

请求参数

Header 参数
app_id
string 
应用id
必需
默认值:
{{app_id}}
access_token
string 
应用密钥
必需
默认值:
{{access_token}}
Body 参数application/json
name
string 
必需
客户名称
(English)account name
business_type
string 
必需
业务类型(通过《获取业务类型》获取)
(English)business type (obtained through the "Get Business Type")
mobile
string 
mobile
可选
email
string 
email
可选
industry
string 
可选
行业
(English)industry
company_id
string 
可选
公司名称
(English)company name
account_type
string 
可选
客户类型(接口获取:获取自定义选项集字段)
(English)account type (interface acquisition: obtain custom option set fields)
nature_enterprise
string 
可选
企业性质(接口获取:获取选项集字段)
(English)enterprise nature (interface acquisition: obtain option set fields)
company_size
string 
可选
公司规模(接口获取:获取选项集字段)
(English)company empire (interface acquisition: obtain option set fields)
official_website
string 
可选
公司官网
(English)company official website
country_region
string 
可选
国家/地区(接口获取:获取选项集字段)
(English)country / region (interface acquisition: obtain option set fields)
address
string 
可选
详细地址
(English)detailed address
description
string 
可选
描述
(English)description
latest_remark
string 
可选
最新备注
(English)the latest remark
owner
string 
负责人id
可选
示例
{
    "name": "string",
    "business_type": "string",
    "mobile": "string",
    "email": "string",
    "industry": "string",
    "company_id": "string",
    "account_type": "string",
    "nature_enterprise": "string",
    "company_size": "string",
    "official_website": "string",
    "country_region": "string",
    "address": "string",
    "description": "string",
    "latest_remark": "string",
    "owner": "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://jingopenapi.jingsocial.com/v1/customer/create' \
--header 'app_id;' \
--header 'access_token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "business_type": "string",
    "mobile": "string",
    "email": "string",
    "industry": "string",
    "company_id": "string",
    "account_type": "string",
    "nature_enterprise": "string",
    "company_size": "string",
    "official_website": "string",
    "country_region": "string",
    "address": "string",
    "description": "string",
    "latest_remark": "string",
    "owner": "string"
}'

返回响应

🟢200成功
application/json
Body
request_id
string 
必需
请求唯一id
(English)request unique id
code
integer 
必需
成功返回0
(English)success then return 0
msg
string 
success
必需
data
object 
必需
jing_uuid
string 
必需
客户id
(English)account id
示例
{
    "request_id": "string",
    "code": 0,
    "msg": "string",
    "data": {
        "jing_uuid": "string"
    }
}
修改于 2023-08-15 02:38:21
上一页
查询线索详情链接(Query Lead Details Link)
下一页
客户查询(Account Query)
Built with