抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 解决方案场景化拆分公告
  • 到店餐饮解决方案
  • 随心团解决方案
  • 到综行业解决方案
  • 线索管理解决方案
  • 综合到店提货券对接解决方案
  • 到综行业团购解决方案
  • 到综团购预约品解决方案
  • 组合券包SAAS对接方案
  • 航司saas对接解决方案
  • 度假旅行社行业解决方案
  • 景区行业解决方案
  • 酒店行业解决方案
  • 历史版本文档(不推荐)
  • 线索管理解决方案

    收藏
    我的收藏

    一、对接步骤

    第一步:入驻「抖音开放平台」

    抖音开放平台:
    说明:如果先前已经入驻抖音开放平台,则请直接进入第二步

    第二步:在「抖音来客」绑定服务应用

    动作
    图示
      抖音来客PC端-店铺管理-服务应用授权-【商家自研服务】,操作【绑定开发者】
    特别注意:确保对接的“抖音开放平台”和“抖音来客”认证主体资质(社会信用代码)一致。
      绑定后,在“抖音开放平台”账户内创建应用,选择【生活服务商家应用】
      查询“抖音开放平台”应用状态,在解决方案中勾选“线索管理解决方案”
    选择“线索管理解决方案”

    第三步:对接开发客资中心(全量)线索接口:

      特别注意:
    务必仔细检查【接口字段类型】和【标点符号格式】,调不通大概率是这两种问题!
    一条线索只对应一个订单,一对一的,如果系统开启了线索去重,相同手机号订单的线索会被去重,只保留最早的那个

    二、常见问题

    基础问题

    Q:为什么手机号不是明文还需要解密?

    为避免传输过程中数据泄露,传输过程中采取加密等安全措施传输线索信息(手机号),可参考如下【加密字段解密方法】文档进行解密。
    直接从接口拿的手机号是非明文

    Q:为什么解密完后还有部分线索有掩码?

    解密后还是掩码
    线索是否掩码的展示逻辑同“抖音来客-客资中心”:
      原因①:线索来源是“团购留资”且已退单
      原因②:由于用户的异常行为被平台判定为作弊用户的线索;

    Q:抖音来客上的“门店账号”可以自行对接吗?

    不支持门店账号对接,需要使用总部账户进行开发对接。

    Q:为什么提示“开发者账户和商家账户的社会信用代码不一致”?

    请按提示说明保证“抖音开放平台-开发者账户”和“抖音来客-商家账户”的主体社会信用代码一致

    Q:为什么接口拿不到数据?

    排查步骤:
      1.确认抖音来客是否已开通“线索经营”业务;
      2.确认抖音来客“线索经营-客资中心”是否已落入了线索;
      3.确认是否完成了本文中的对接步骤“一、二、三”;
      4.page和page_size是否填值了(page和page_size必须填值)

    Q:是否能支持POST方式对接?

    目前暂无POST方式,请使用文档的GET方式对接。

    Q:我之前对接过抖开,鉴权可以用原来的客户端密钥(client_key/client_secret)吗?

    可以用之前的client_key/client_secret。

    Q:抖音开放平台上“客资查询”是什么接口,可以对接吗?

    ❌ 请勿对接!
      “客资查询”是「来客通」的线索接口,「来客通」已经下线,仅部分存量客户在使用。在抖音来客上开通线索经营业务的商家,请使用“线索经营”-“线索查询”接口,即本文的【第三步】链接。

    Q:为什么我没有拉到直播间线索?

    线索最高有10分钟内的落入延迟,因此需要商家处理时间策略,将「endtime」改成至少10min之前。
    字段说明:endtime==当前时间

    字段问题

    Q:“意向门店”如何获取?

    intention_life_account_name
    (字段在24年6月7日新增,6月7日13:00后新落入的线索会展示新版意向门店的逻辑)详见「客资中心」操作手册

    Q:“内容id”是什么意思?

    依赖于线索来源,如果是“短视频”即短视频id,如果是“直播”即直播间id。

    Q:“跟进户”是什么意思?

    当前的跟进类型、跟进账户id、跟进账户名称同线上“客资中心”的展示逻辑,即“广告流量”线索展示的是该条线索来源广告投放的主体名称。跟进门店通常是平台直接下发落入的账户,如果在抖音来客客资中心中有操作变更过线索归属,则展示拉取后

    Q:“分配状态”是什么含义?

    分配状态来源于“抖音来客-客资中心”的用户操作数据。如果在来客平台操作过线索跟进行为随后使用API获取线索,会拉到来客平台上最新的线索分配跟进状态。(如不使用抖音来客平台跟进线索,则无需关注这些字段:线索阶段状态、线索标签、线索所属人、分配状态等)
    接口字段
    抖音来客-客资中心的线索详情

    Q:是否可以区分线索手机号是否属于“隐私号”?

    使用remark_dict字段中包含是否属于隐私号的信息。