抖音开放平台Logo
开发者文档
控制台

线索管理解决方案

收藏
我的收藏

一、对接步骤

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

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

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

动作
图示
    抖音来客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字段中包含是否属于隐私号的信息。