生态互联：微信服务号 · 企业微信 · KOOK

怎么接入

1. 在微信后台确认这是一个「已认证服务号」，并配置好网页授权网址（这两步系统检测不了，页面会标「只需自行确认」，但要自己确认好，否则绑定微信与微信登录会失败）
2. 在公众号后台「模板消息」里选好一个模板，复制它的模板 ID
3. 到「店铺设置 → 生态互联 → 微信服务号」填公众号的 AppID、AppSecret 与通知模板 ID，保存后这一段直接显示「已接入」
4. 点「立即检测」：系统会真的拿凭证试一次，通不过会给出微信返回的原始错误码与原文、这句话什么意思、去微信后台哪一栏改
5. 到「店铺设置 → 通知通道」把「微信服务号」开关打开，再到「公众号菜单」把菜单推送到本店公众号

接上之后能做什么

• 公众号菜单一键推送后，服务号底部菜单里就能放入口，点进去直接到本店，不用再找链接
• 老板收到：在线订单状态变化（支付成功、陪玩已就位、服务结束、超时取消、退款）、充值到账、余额变动、客户等级升级
• 陪玩收到：报单待确认、收益已入账、报单未通过审核（带原因）、提现审批结果（通过 / 驳回带原因）、收到礼物、抢单池有新单
• 店员按排班收到：待审核报单、老板处理报单后的跟进、陪玩提现申请
• 微信里收到的本店提醒点进去一律回到本店页面：谁点都能进，进去之后再按自己的身份找到对应的事

怎么接入

1. 在企业微信后台建一个自建应用，拿到企业 ID、应用 Secret 与 AgentId
2. 到「店铺设置 → 生态互联 → 企业微信」填入这三项，点「立即检测」由系统判断能不能用（能取到凭证就算通）
3. 按页面显示的内容到企微后台填「企业可信 IP」—— 不填这一处，前面全填对了也发不出消息，系统会把这一步单独标红并给出错误码
4. 把页面显示的「授权后跳回的网址」填进应用「网页授权及JS-SDK」里需要填网址的那一栏
5. 做一次「通讯录同步」：按手机号把企微成员与本店店员对上

接上之后能做什么

• 待办类提醒按排班发给当班店员，没人在班时自动发给店长
• 通讯录同步可以反复点，已经对上的不会重复改；对不上的会逐条列出来（企微里没填手机号、手机号与店员资料不一致、同一个企微号已经绑给了别人），照着补即可
• 企业微信登录入口出现在登录页，只对店员开放
• 页面显示的 IP 与回调网址都支持一键复制，避免手抄出错

怎么接入

1. 平台侧开通机器人后，店铺后台可以复制 Webhook 回调地址（机器人令牌只在服务端，不需要你填到网页里）
2. 到「店铺设置 → KOOK 配置」填服务器 ID、值班频道与消息模板，打开本店开关
3. 绑定身份：老板在 H5「我的」里绑定；陪玩与店员用一次性口令私信机器人完成绑定（一个 KOOK 账号在本店只绑一种身份）
4. 点「发送测试」确认值班频道能收到中文卡片即可开始使用

接上之后能做什么

• 机器人指令：/登录（一键免密进系统）、/id（查自己的 KOOK ID）、/我是谁（查绑定的系统身份）、/余额查询（老板显示三余额明细）、/roll、/转盘、/查单、/点单
• 消息与播报：报单确认推送陪玩（附「结单申报」按钮免登录直达确认）、余额变动私信、账号创建通知、登录成功通知、赠礼私信与频道播报、充值播报、客户等级升级播报
• 身份打通：客户与陪玩标签、客户等级自动同步 KOOK 频道身份组，升级 / 降级自动授予新角色并撤销原角色，不影响你在 KOOK 里手动设置的其它角色
• 登录页会出现「KOOK 登录」按钮，点一下在 KOOK 里确认即可