扎洛频道
此包通过 Zalo Bot API 使用 HTTP 请求提供代理文本消息, 包含来自长选票或已注册的 Webhook 处理器的输入更新 .
安装
npm install @framers/agentos-ext-channel-zalo
同伴依赖 : @framers/agentos >=0.10.40。 。 。 .
使用量
import { AgentOS } from '@framers/agentos';
const agentos = await AgentOS.create({
extensionManifest: {
packs: [
{
package: '@framers/agentos-ext-channel-zalo',
options: { botToken: process.env.ZALO_BOT_TOKEN },
},
],
},
});
配置
| 选项 | 秘密编号 | 环境变量 | 需求 | 默认 |
|---|---|---|---|---|
botToken | zalo.botToken | ZALO_BOT_TOKEN | 对 | 无 |
webhookSecret | zalo.webhookSecret | ZALO_WEBHOOK_SECRET | 没有 | 空字符串 |
webhookPath | 无 | ZALO_WEBHOOK_PATH | 没有 | /zalo-webhook |
poll | 无 | 无 | 没有 | 启用, 除非 false 或网球秘密解决 |
pollTimeoutSec | 无 | 无 | 没有 | 30 秒数 |
maxBodyBytes | 无 | 无 | 没有 | 1024 * 1024 字节 |
priority | 无 | 无 | 没有 | 50 |
secrets | zalo.botToken, (中文(简体) ), zalo.webhookSecret | 无 | 没有 | 无 |
和Webhook 秘密决心从选项,然后 options.secrets,然后是环境变量。 Webhook 的秘密被裁剪。 Webhook 路径获得先行斜线,失去后行斜线. 网路隐藏的秘密即使 poll 实值 true。 。 。 .
工具
| 工具 | 它会做什么 |
|---|---|
zaloChannelSendMessage | 通过Zalo频道适配器发送短信. |
zaloChannelSendMessage
| 参数 | 类型 | 需求 | 说明 |
|---|---|---|---|
conversationId | 字符串 | 对 | 目标 Zalo 用户/行走ID |
text | 字符串 | 对 | 信件文本 |
频道适配器
适配器注册平台 zalo。发送使用第一个文本块并将其张贴到 Bot API 上 sendMessage 终点 即将到来的民意测验或webhook更新成为直接或集体的文字活动. 它使用信件文本或标题,并 <media:image> 财务报告和审定财务报表 <media:sticker> 倒影用于图像和粘贴事件. 没有聊天ID,发送ID或可用文本的更新会被忽略. 打字指标无用.
启动服务,并在启用时开始投票。 包还登记 zaloWebhook HTTP处理器. 使用 Webhook 密钥集, 处理器接受请求 webhookPath,答案 获取请求,并要求 POST 请求带有匹配 x-bot-api-secret-token 头曰. 有效有效载荷得到确认并传递给适配器。 该包不会启动 HTTP 服务器, 也不会用 Zalo 注册 Webhook URL .
页:1
创建包扔, 如果没有机器人符号解析 。 发送修剪对象和文本, 拒绝空值并将信件切换到 2000 字符键。 发送更改目标聊天内容. 如果API不提供消息ID,服务会在当地生成一个消息.
投票暂停在地板和夹住之间 5 财务报告和审定财务报表 60 秒; 添加 HTTP 请求截止日期 5 秒数。 投票 API 超时错误被忽略, 而其他错误则登录警告和暂停 2500 继续前的ms. 发送请求没有明确的超时 .
Webhook 机构默认为 a 1024 * 1024-字节限制。 正面限制 maxBodyBytes 超过它。 缺少或不匹配的秘密头,体型过大,有效载荷无效和不支持的方法都会收到出错回复. 与 poll: false 而且没有秘密, 也没有进入的运输运行.
释放
新版本发表于 架设层/剂-外延 由 GitHub Actions 通过 npm 信任的出版, 并附有出处声明 .
许可证
阿帕奇 - 2.0