用途:把 Podium 网页聊天消息接入生产系统,并处理网页聊天侧的典型故障,而非搭建教程。
主要能力:一是在组件输入边界用 phonenumbers 将号码规范为 E.164,避免本地格式导致后续短信静默失败;二是以 E.164 号码为唯一键做幂等 upsert,容忍 409 冲突后重取,防止同一号码并发创建重复联系人;三是监控会话空闲,20 分钟提醒、28 分钟前保存部分状态并干净关闭,避免多步回答上下文丢失;四是在上传前校验附件不超过 25 MiB,避免上传完成后才收到 413;五是启动时加载有效 location_uid 集合,缺失或未知即拒绝,不设默认门店;六是维护统一退订存储,SMS 与网页聊天共用,每次外发前检查,STOP 等关键词触发记录并同步到 Podium。
使用方式:需 Python 3.10+ 或 Node.js 18+,安装 phonenumbers(pip install phonenumbers),并依赖 podium-auth 与 podium-webhook-reliability 技能。示例命令:python3 scripts/phone_normalize.py --phone "0412 345 678" --default-country AU;python3 scripts/optout_audit.py --phone "+61412345678"。可将处理函数接入 FastAPI 的 /podium/webchat 端点,并用 60 秒循环扫描会话。
限制:退订查询缓存不超过 60 秒;联系人姓名冲突等复杂合并由 podium-contact-dedup 处理;限流应对见 podium-rate-limit-survival。具体价格、平台支持范围等资料未提供。