Zalo机器人集成

技能简介

本技能提供Zalo Bot API的完整接入方案，涵盖官方Bot平台（OA/ZNS）的token认证流程、webhook配置及长轮询处理，同时包含非官方个人账号自动化工具的分支指引与安全边界说明。

业务背景

Zalo是越南主流即时通讯平台，覆盖超7000万用户。本技能帮助企业快速接入Zalo官方Bot能力，实现本地化客户触达与自动化服务运营，无需自建复杂基础设施即可开展通知推送、在线客服、营销广播等场景，降低东南亚市场数字化运营成本。

落地案例：某跨境电商企业面向越南消费者提供售后服务。通过本技能配置Zalo Bot Token后，订单发货自动触发物流通知推送给买家；用户咨询时，Bot识别关键词转接人工客服会话；大促期间向订阅用户批量发送优惠券提醒。全程采用Webhook接收消息，配合速率控制避免平台限流，同时严格隔离Token权限防止泄露。

能做什么

• 通过Bot Token建立与Zalo开放平台的认证连接
• 配置Webhook接收用户消息事件或采用长轮询模式
• 实现通知推送、客服支持、广播群发三类核心场景
• 管理会话状态与消息速率限制
• 评估个人账号自动化方案的适用边界

使用说明

1. 前置准备：注册Zalo开放平台账号，创建Official Account获取Bot ID
2. 安装依赖：根据目标语言选择SDK，Node.js环境执行npm install zalo-sdk或参考官方文档引入对应客户端库
3. Token配置：在开发者后台生成Bot Token，配置IP白名单与回调地址
4. 连接测试：调用用户信息接口验证token有效性，确认网络连通性
5. 部署模式选择：高并发场景选用Webhook+HTTPS端点；低频或开发测试选用长轮询
6. 消息处理：实现事件解析器，区分文本/图片/链接等消息类型，设置重试与去重机制
7. 个人账号分支（可选）：如需非官方方案，查阅zca-js相关文档，注意该路径无平台保障

输入与输出

见下方输入与输出表格。

风险提示

• 个人账号自动化工具不受Zalo官方支持，存在封号风险
• Token泄露可导致消息篡改或数据泄露，禁止硬编码或日志记录
• 未做速率控制可能触发平台限流，影响服务可用性
• Webhook端点需验证请求签名，防止伪造事件注入
• 越南境外服务器访问可能出现网络延迟或间歇性阻断

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/codedao12/zalo/SKILL.md
来源类型：GitHub仓库