选择本地推账号
将分页调用本地推 instance/query，拉取当前来客账号下全部客服组，包括 instance_id、link_id、客服列表 user_list 和状态。不会同步客户加粉、开口或对话数据。
美客来8
首页
经营概览与待处理事项
当前员工：加载中
连接中
最近客户
最近预约
客户列表
新增客户
查找客户
预约列表
新增订单
订单列表
兼容新增定金记录
定金记录 / 定金查询
广告客服开关
按客服查看广告加粉、预约、到店表现，并管理是否接收广告加粉。
阶段说明
本地推开关会同步本地推客服包成员；其他平台本阶段仍只更新系统内部开关状态。
本地推兜底客服包配置
按来客账号配置兜底客服包，候选包无有效客服或空包保护时用于承接新流量。
报表筛选
渠道报表
门店报表
综合看板筛选
数据来源：本地已同步广告消耗 + CRM 经营数据
城市明细
本月消耗
以平台为单位进行汇总
新客到店数当前按消费到店统计；平台归因按客户首个有效加粉记录计算。
客服报表
按客服维度汇总加微、预约、定金、到店、业绩等数据。
操作日志
品牌
事业部
城市
岗位
门店
部门
员工
收款方式
收款账户
项目分类
项目
卡项模板
定金配置
推广渠道
城市推广映射
城市推广映射在城市管理中维护
用于把平台原始投放城市归到系统城市，便于广告消耗和城市报表核对。
授权中心
平台回调配置
企业微信配置
企业微信获客链接管理
企业微信获客接口调试
本地推接入配置
这里配置本地推 / 抖音来客接口账号
本页面只维护本地推账号名称、抖音来客总户 ID、来客企微 ID、开放平台应用 ID、应用密钥、client_token 自动续期、访问令牌状态、启用状态和备注。
本页面不管理本地推客服组、Webhook 原始事件、客户行为状态或广告回传规则。
配置完成后，系统才能同步客服组、创建客服组、接收动态回调、接收 Webhook 和做后续回传。
| 字段 | 你要填什么 | 从哪里拿 |
|---|---|---|
| 账号名称 | 你自己起名，比如“美客来本地推总户” | 自己填，方便识别 |
| 抖音来客总户 ID（root_life_account_id） | 抖音来客总户 ID | 抖音来客 / 本地推后台，文档里叫 RootLifeAccountId / 总户 ID |
| 来客企微 ID（corp_id） | 来客上对应的企微 ID | 抖音来客的“企业微信组件 / 管理企业微信及客服”里对应的企微 ID |
| 抖音开放平台应用 ID（client_key） | 抖音开放平台 APPID / client_key | 抖音开放平台应用详情 |
| 抖音开放平台应用密钥（client_secret） | 抖音开放平台应用密钥 | 抖音开放平台应用详情，保存后会脱敏 |
| 接口访问令牌（access_token） | 本地推接口调用凭证，系统会优先通过 client_key / client_secret 自动获取 | 正常不手动填写；仅调试或兜底时手动填写，保存后会脱敏 |
| 自动续期 | 开启后系统会在 token 过期前自动刷新 | 默认开启；关闭后只使用手动填写的 access_token |
| 令牌过期时间（token_expires_at） | 当前 token 的预计过期时间 | 系统按 expires_in 自动计算并提前 5 分钟缓冲保存 |
| 最近刷新时间 | 系统最近一次获取 client_token 的时间 | 自动刷新或点击“测试并刷新 token”后更新 |
| 最近刷新错误 | 如果自动刷新失败，会显示原因 | 可检查 client_key/client_secret 后手动刷新 |
| 启用状态 | 启用 | 要调用接口必须启用 |
| 备注 | 自定义说明 | 比如“本地推测试账号” |
本地推客服组管理
这里管理本地推客服组配置
这里管理本地推客服组配置。客服组对应本地推企业微信组件里的微信包，核心字段是客服组组件 ID（instance_id）和本地推链接 ID（link_id）。本页面只管理客服组配置，不展示客户是否加粉、是否开口、对话轮次。
创建客服组
创建时系统会先把员工的企业微信客服 userid（wecom_userid）转换成本地推加密客服 ID，再调用本地推 instance/upsert 创建客服组。instance_id 和 link_id 由本地推接口返回，不需要手动填写。
兜底客服包配置
按当前本地推账号选择一个已有真实 instance_id 的客服包作为兜底。保存只写本地配置，不调用 instance/upsert。
查询本地客服组
这里查询的是系统本地保存的客服组记录。若要获取远端最新数据，请先点击上方“同步远端全部客服组”。
客服组列表
列表按当前选择的本地推账号隔离，只展示客服组配置和客服 ID 映射。
本地推 Webhook 事件记录
这里记录本地推推送的加粉、开口、对话轮次、链接不可用等原始事件，只做验签、去重、落库。
本页面不做客户入库操作，不展示客户状态聚合表，也不编辑客服组或回传规则；客户是否加粉、是否开口会在客户行为状态页面聚合展示。
关键字段：消息去重 ID（Msg-Id）、抖音签名（X-Douyin-Signature）、渠道参数（state / customer_channel）、外部联系人 ID（external_user_id）、企业微信客服 userid（user_id / wecom_userid）、客服组组件 ID（instance_id）。
Webhook 接入地址：
/api/local-push/webhook
本地推客户行为状态
这里根据本地推 Webhook 事件聚合客户是否本地推已加粉、是否开口、对话轮次，并显示自动入库状态。
本页面展示外部联系人 ID（external_user_id）、渠道参数（state / customer_channel）、企业微信客服 userid（user_id / wecom_userid）、客服组组件 ID（instance_id）、是否本地推已加粉、是否已开口、对话轮次、最近事件时间、自动入库状态、系统客户、归属客服、点击 ID（click_id）、线索 ID（clue_id）、广告账户 ID（adv_id）和 response_param。
本页面不以原始 Webhook 大字段为主，不编辑客服组或回传规则。add_wechat 事件会自动尝试入库并绑定客服；自动入库成功后只触发 customer_wechat_added，是否回传由后台规则决定，人工处理不触发。
本地推客户入库记录
这里查看本地推客户自动入库、手动入库、批量入库的处理记录。
本页面职责是核对入库时间、外部联系人 ID（external_user_id）、渠道参数（state / customer_channel）、客服组组件 ID（instance_id）、企业微信客服 userid（user_id / wecom_userid）、系统客户、归属客服、action、status、error_message 和 raw_snapshot。
本阶段不新增独立日志查询接口；不在这里管理客服组、动态回调配置或回传规则。
本地推线索拉取/补全
这里用于从本地推平台拉取广告线索，并补齐 click_id、clue_id、广告账户、计划、创意等归因字段。
线索补全不会自动触发广告回传，也不会修改预约、订单、收款数据。
如果本地接口文档缺少完整拉取接口定义，系统会记录失败批次并提示补充接口地址和参数，不会伪造线索同步成功。
同步线索
按本地推账号和日期范围手动同步平台线索；一次最多同步 7 天。
同步批次
记录每次手动同步的账号、时间范围、状态、总数、新增数、更新数、匹配数和错误。
本地推线索列表
本地推线索详情
请选择线索查看详情
详情会展示投放归因字段、表单字段、raw_payload、匹配结果、customer_id 和 lead_attribution_id。
本地推动态回调记录
这里记录用户点击加微按钮后，本地推请求系统下发微信包的 select_ca_link 回调。
这里是点击 ID（click_id）、线索 ID（clue_id）、广告账户、计划、创意等投放归因字段来源，也展示客服组组件 ID（selected_instance_id）、response_param 和归因回填状态。
本页面不编辑客服组，不展示客户是否开口或对话轮次，也不维护回传规则。
接入地址：
/api/local-push/select-ca-link
本地推微信包报表
微信包 = 本地推客服组 instance_id；展示次数 = select_ca_link 成功返回 instance_id 的次数，不是广告曝光量。
本地推加粉数来自 Webhook 和客户行为聚合；预约和到店来自系统业务数据。
公式：本地推加粉率 = 本地推加粉数 ÷ 展示次数；预约率 = 本地推加粉数 ÷ 预约数；到店率 = 本地推加粉数 ÷ 到店数。
本页面不编辑客服组，不展示 Webhook 原始事件，也不维护回传规则。
账户同步入口
账户同步按授权配置执行
进入授权中心，在已授权且 Token 有效的配置行内点击“同步账户”。
广告账户
广告账户映射
这里维护平台真实广告账户与系统组织归属的映射。广告账户不绑定门店。
平台回调或线索中发现未知广告账户时，系统会自动创建为待绑定账户。请补充运营负责人、事业部、品牌、部门，避免报表归入未绑定。
广告消耗城市日表
同步诊断
同步失败诊断
重试队列
本地推回传配置/日志
这里是本地推转化回传相关配置和日志。
实际规则仍使用广告回传中心的通用 conversion_rules 和 conversion_logs，本入口默认筛选平台 platform_code = local_push。
本地推动态客服链路使用 click_id 作为 callback 回传。预约触发 appointment_created 后，系统会按回传规则自动回传 CLUE_CONFIRM 或 CLUE_HIGH_INTENTION；add_wechat 自动入库成功后会触发 customer_wechat_added，可按规则回传 FORM / form。没有 click_id 时不会伪造回传。
关键字段：广告账户 ID（adv_id）、点击 ID（click_id）、线索 ID（clue_id）、平台事件 platform_event、平台去重 ID（outer_event_id）、平台返回 code/message 和日志状态 status。
广告平台管理
平台账号配置
转化字段字典
动作回传规则
系统动作是系统内部触发点，不是平台回传字段。
比如 appointment_created 表示创建预约成功；真正回传给本地推的是右侧选择的回传字段，例如 194 / 196 / CLUE_CONFIRM / CLUE_HIGH_INTENTION / FORM。
本地推常用配置：创建预约（appointment_created）→ 196 / CLUE_HIGH_INTENTION，或按投放目标配置为 194 / CLUE_CONFIRM。
客户加企微（customer_wechat_added）可用于本地推 add_wechat 加粉成功后的回传。若需要按转化 API 示例回传 form，请选择回传字段：表单提交（FORM / form）。386 微信_添加企业微信目前仅作为字段保留，不默认等同于 form。
本地推 clickID/callback 回传支持 CLUE_CONFIRM、CLUE_HIGH_INTENTION 和 form；没有 click_id 不会使用 clue_id 冒充 callback。
回传日志
本地推回传日志会展示 click_id、clue_id、adv_id、platform_event、outer_event_id 和平台返回 code/message。
真实请求发送到 analytics.oceanengine.com/api/v2/conversion，不额外携带 access-token；clue_id 回传需等待独立接口文档。