简要描述:

  • 创建线索

请求URL:

  • /api/v2/leads

请求方式:

  • POST

请求头:

请求参数:

字段名 是否必填 描述
source_app false 例如:
check_duplicates false 查重
lead[user_id] true 负责人
lead[name] true 姓名
lead[company_name] false 公司名称
lead[status] false 跟进状态
lead[source] false 线索来源
lead[department] false 部门
lead[job] false 职务
lead[note] false 备注
lead[want_department_id] false 这是 lead[want_department_id] 负责人所属部门
lead[address_attributes][detail_address] false 这是详情地址
lead[address_attributes][tel] false 电话
lead[address_attributes][qq] false QQ
lead[address_attributes][wechat] false 微信
lead[address_attributes][phone] false 手机
lead[address_attributes][url] false 网址
lead[address_attributes][email] false 邮箱
lead[address_attributes][province_id] false
lead[address_attributes][city_id] false 城市
lead[address_attributes][district_id] false 地区
lead[address_attributes][zip] false 邮编
lead[address_attributes][job] false 职务

请求参数json例子:


{
  "lead": {
    "name": "测试线索",
    "address_attributes": {
      "url": "www.baidu.com"
    }
  }
}

返回示例:

正确时返回:


{
  "code": 0,
  "data": {
    "id": 1039,
    "name": "赵宁",
    "company_name": "贸易公司5",
    "status": "85",
    "source": "",
    "source_mapped": "",
    "department": "销售部",
    "job": "销售经理",
    "note": "主营外贸销售,代理国外一线品牌",
    "created_at": "2015-06-24 14:29",
    "status_mapped": "未处理",
    "updated_at": "2015-08-31 11:34",
    "is_own": true,
    "status_display": "未处理",
    "attachment": {},
    "turned_to_customer": false,
    "text_asset_9a1fbb2d": "sssssssssss",
    "numeric_asset_9e45a882": 121312,
    "text_asset_a298fcae": "dsfads",
    "text_asset_a298fcae_display": "dsfads",
    "user": {
      "id": 2,
      "email": "wp@qq.com",
      "created_at": "2015-06-10T11:06:45.000+08:00",
      "name": "test",
      "organization_id": 1,
      "phone": "15921076830",
      "role_id": 0,
      "workflow_state": "organization_staff",
      "job": "",
      "tel": "",
      "avatar_url": "http://192.168.10.99:3000/assets/male.jpg",
      "department_name": "销售部"
    },
    "address": {
      "id": 1064,
      "country": {
        "id": 4,
        "name": "中国",
        "pinyin": null
      },
      "province": {},
      "city": {},
      "district": {},
      "tel": "010-64881993",
      "phone": "13881788888",
      "email": "zhaoning@web.com",
      "qq": "18888892",
      "fax": "",
      "wechat": "weixin",
      "wangwang": "288888893",
      "zip": "100004",
      "url": "",
      "detail_address": "北京市朝阳区朝阳门外大街18号丰联广场A座第9层",
      "lat": 0,
      "lng": 0,
      "distance": "0m",
      "region_info": "中国",
      "off_distance": 0
    },
    "owned_department": {
      "id": 2,
      "name": "销售部"
    }
  }
}

错误时返回:


{
  "code": 100000,
  "message": "device参数错误",
  "error": "invalid_app_error"
}

返回参数说明:

参数名 类型 说明
is_user_self boolean 是否自己线索

备注:

文档更新时间: 2025-04-29 14:18   作者:陈胜海