ToolJet 集成 Plivo 短信插件从凭据配置到 Send SMS 查询的完整实战指南【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJetPlivo 是 ToolJet Marketplace 中开箱即用的短信SMS通信插件允许你在低代码应用中直接向指定手机号发送短信适用于验证码通知、告警提醒、业务消息触达等场景。本文以 v2.50.0-LTS 文档 plivo.md 为主体结合仓库内 Plivo 插件的源码、清单与操作定义完整讲解插件的安装前置条件、连接配置、Send SMS 查询参数以及底层调用链帮助你在 ToolJet 中快速接入短信能力。前置准备启用 Marketplace 并安装 Plivo 插件使用 Plivo 插件前需要先完成 Marketplace 插件的安装流程对应文档中 Using Marketplace plugins 的说明。根据仓库中的 marketplace_overview.md安装步骤如下启用 Marketplace 功能在 ToolJet 的.env文件中加入环境变量ENABLE_MARKETPLACE_FEATUREtrue注意本地运行时需先构建 marketplace再启动服务端确保插件可用同时只有Administrator管理员角色才能访问 Marketplace 页面。进入 Marketplace 页面点击仪表盘左下角的设置图标从菜单中选择Marketplace页面包含Installed和Marketplace两个标签页。安装插件在 Marketplace 标签页的插件卡片列表中点击 Plivo 卡片上的Install按钮安装完成后状态由 Install 变为 Installed。在数据源中调用进入仪表盘的Data sources标签页下拉到Plugins区域即可看到已安装的 Plivo 插件配置完成后即可在查询面板Query Panel新建查询时选用该数据源。安装完成后即可进入本文的核心环节——连接配置。连接 PlivoAuth ID 与 Auth Token 的获取与配置在 ToolJet 中新建 Plivo 数据源时需要提供两项凭据凭据说明Auth TokenPlivo 账户的 API 认证令牌属于敏感信息连接配置中以密码形式输入Auth IDPlivo 账户的 API 认证标识通常为一串字母数字组合获取 Auth ID / Auth Token根据官方文档指引获取凭据的步骤为登录 Plivo 官方控制台Plivo Console在控制台的API区域查看你的 Auth ID 与 Auth Token若未显示或需要重新生成可点击Generate New Auth ID/Token按钮生成新凭据。从插件源码清单 manifest.json 中可以印证这两个凭据在连接表单中的实际定义authId类型为text文本框label 为 Auth ID其helpText指向 Plivo Console 用于生成 Auth IDauthToken类型为password密码输入框label 为 Auth token并且options中声明了encrypted: true——这意味着 Auth Token 在 ToolJet 数据源中会被加密存储避免明文落库插件还声明了customTesting: true表示连接测试由插件自身逻辑完成而非默认的通用连通性测试。凭据如何进入查询执行链路在运行时这两项凭据会被传给插件的客户端构造方法。见 index.tsgetClient(authId: string, authToken: string): any { return new plivo.Client(authId, authToken); }即每次执行查询时插件会用sourceOptions.authId与sourceOptions.authToken实例化 Plivo 官方 Node SDK 的Client对象后续的短信发送操作全部经由该客户端完成。支持的查询Send SMS 发送短信当前版本的 Plivo 插件支持一种查询操作Send SMS发送短信。这一点在 operations.json 的操作下拉列表中也有明确体现——operation枚举仅包含send_sms显示名 Send SMS一个选项。必填参数发送短信时需要填写以下三个必填参数参数字段 key说明To Numberto接收短信的目标手机号From Numberfrom发送方号码通常为 Plivo 账户中已购买的号码或 Alphanumeric Sender IDBodybody短信正文内容从 operations.json 可以看到三个参数在查询表单中均以codehinter类型的编辑器呈现——这意味着参数值不仅支持直接输入文本还支持通过{{ }}表达式绑定应用组件、查询结果或全局变量例如To Number绑定文本输入组件{{ components.phoneInput.value }}Body拼接动态内容{{ 验证码 variables.otp }}这种动态绑定能力使 SMS 查询可以与前端表单联动实现用户输入手机号 → 点击按钮 → 发送短信的完整业务流。底层调用链从查询参数到 Plivo APIrun方法是插件查询执行的入口完整的发送逻辑见 index.tsasync run(sourceOptions: any, queryOptions: any): PromiseQueryResult { let result {}; try { const client this.getClient(sourceOptions.authId, sourceOptions.authToken); if (queryOptions.operation send_sms) { result await client.messages.create(queryOptions.from, queryOptions.to, queryOptions.body); } } catch (error) { throw new QueryError(Query could not be completed, error.message, {}); } return { status: ok, data: result, }; }这段实现对应了文档描述的完整调用链插件根据operation字段分发操作当值为send_sms时进入短信发送分支调用 Plivo Node SDK 的client.messages.create(from, to, body)内部会向 Plivo 的 SMS 发送 API 发起请求若请求异常统一抛出QueryError(Query could not be completed, error.message)错误信息会展示在查询运行结果中成功时返回{ status: ok, data: result }其中data为 Plivo API 的原始响应通常包含message_uuid等消息标识可用于后续的状态跟踪。从类型定义 types.ts 可以看出插件遵循 ToolJet Marketplace 统一的服务契约实现QueryService接口其依赖为 package.json 中声明的plivo4.75.1与tooljet-marketplace/common因此该插件可以无缝接入 ToolJet 的查询执行引擎与内置数据源的使用方式一致。在查询面板中的完整使用流程完成数据源配置后在应用中发送短信的完整流程如下打开应用的查询面板点击 新建查询选择 Plivo 数据源操作类型保持Send SMS填写或绑定To Number、From Number、Body三个参数点击Run执行查询右侧结果区域会返回 Plivo API 的响应体可通过queries.queryName.data引用查询结果用于后续的事件处理如发送成功后更新状态、跳转页面或弹出通知。常见注意事项凭据安全Auth Token 在 manifest.json 中声明为encrypted: trueToolJet 会对其加密存储请勿在查询参数、日志或共享应用中明文输出该值。号码格式To/From 参数一般应使用 E.164 格式的国际号码如14155552671From Number 需为 Plivo 账户中可用的号码或 Sender ID否则 Plivo API 会返回错误。插件移除风险从 Marketplace 的 Installed 页移除 Plivo 插件后应用中所有关联的查询都会被一并删除移除前请确认没有正在使用的查询。版本说明本文以 v2.50.0-LTS 版本文档为基准当前仓库中 docs/docs/marketplace/plugins/plivo.md 的内容与之一致若需更深入了解插件开发规范可参考 Marketplace 总览文档中的 Plugin Development guide 指引。至此你已经掌握了在 ToolJet 中接入 Plivo 短信能力的完整链路从 Marketplace 安装、Auth ID/Token 凭据配置到 Send SMS 查询的动态参数绑定与底层 API 调用足以在内部工具中快速落地短信通知类业务。【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ToolJet 集成 Plivo 短信插件：从凭据配置到 Send SMS 查询的完整实战指南
ToolJet 集成 Plivo 短信插件从凭据配置到 Send SMS 查询的完整实战指南【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJetPlivo 是 ToolJet Marketplace 中开箱即用的短信SMS通信插件允许你在低代码应用中直接向指定手机号发送短信适用于验证码通知、告警提醒、业务消息触达等场景。本文以 v2.50.0-LTS 文档 plivo.md 为主体结合仓库内 Plivo 插件的源码、清单与操作定义完整讲解插件的安装前置条件、连接配置、Send SMS 查询参数以及底层调用链帮助你在 ToolJet 中快速接入短信能力。前置准备启用 Marketplace 并安装 Plivo 插件使用 Plivo 插件前需要先完成 Marketplace 插件的安装流程对应文档中 Using Marketplace plugins 的说明。根据仓库中的 marketplace_overview.md安装步骤如下启用 Marketplace 功能在 ToolJet 的.env文件中加入环境变量ENABLE_MARKETPLACE_FEATUREtrue注意本地运行时需先构建 marketplace再启动服务端确保插件可用同时只有Administrator管理员角色才能访问 Marketplace 页面。进入 Marketplace 页面点击仪表盘左下角的设置图标从菜单中选择Marketplace页面包含Installed和Marketplace两个标签页。安装插件在 Marketplace 标签页的插件卡片列表中点击 Plivo 卡片上的Install按钮安装完成后状态由 Install 变为 Installed。在数据源中调用进入仪表盘的Data sources标签页下拉到Plugins区域即可看到已安装的 Plivo 插件配置完成后即可在查询面板Query Panel新建查询时选用该数据源。安装完成后即可进入本文的核心环节——连接配置。连接 PlivoAuth ID 与 Auth Token 的获取与配置在 ToolJet 中新建 Plivo 数据源时需要提供两项凭据凭据说明Auth TokenPlivo 账户的 API 认证令牌属于敏感信息连接配置中以密码形式输入Auth IDPlivo 账户的 API 认证标识通常为一串字母数字组合获取 Auth ID / Auth Token根据官方文档指引获取凭据的步骤为登录 Plivo 官方控制台Plivo Console在控制台的API区域查看你的 Auth ID 与 Auth Token若未显示或需要重新生成可点击Generate New Auth ID/Token按钮生成新凭据。从插件源码清单 manifest.json 中可以印证这两个凭据在连接表单中的实际定义authId类型为text文本框label 为 Auth ID其helpText指向 Plivo Console 用于生成 Auth IDauthToken类型为password密码输入框label 为 Auth token并且options中声明了encrypted: true——这意味着 Auth Token 在 ToolJet 数据源中会被加密存储避免明文落库插件还声明了customTesting: true表示连接测试由插件自身逻辑完成而非默认的通用连通性测试。凭据如何进入查询执行链路在运行时这两项凭据会被传给插件的客户端构造方法。见 index.tsgetClient(authId: string, authToken: string): any { return new plivo.Client(authId, authToken); }即每次执行查询时插件会用sourceOptions.authId与sourceOptions.authToken实例化 Plivo 官方 Node SDK 的Client对象后续的短信发送操作全部经由该客户端完成。支持的查询Send SMS 发送短信当前版本的 Plivo 插件支持一种查询操作Send SMS发送短信。这一点在 operations.json 的操作下拉列表中也有明确体现——operation枚举仅包含send_sms显示名 Send SMS一个选项。必填参数发送短信时需要填写以下三个必填参数参数字段 key说明To Numberto接收短信的目标手机号From Numberfrom发送方号码通常为 Plivo 账户中已购买的号码或 Alphanumeric Sender IDBodybody短信正文内容从 operations.json 可以看到三个参数在查询表单中均以codehinter类型的编辑器呈现——这意味着参数值不仅支持直接输入文本还支持通过{{ }}表达式绑定应用组件、查询结果或全局变量例如To Number绑定文本输入组件{{ components.phoneInput.value }}Body拼接动态内容{{ 验证码 variables.otp }}这种动态绑定能力使 SMS 查询可以与前端表单联动实现用户输入手机号 → 点击按钮 → 发送短信的完整业务流。底层调用链从查询参数到 Plivo APIrun方法是插件查询执行的入口完整的发送逻辑见 index.tsasync run(sourceOptions: any, queryOptions: any): PromiseQueryResult { let result {}; try { const client this.getClient(sourceOptions.authId, sourceOptions.authToken); if (queryOptions.operation send_sms) { result await client.messages.create(queryOptions.from, queryOptions.to, queryOptions.body); } } catch (error) { throw new QueryError(Query could not be completed, error.message, {}); } return { status: ok, data: result, }; }这段实现对应了文档描述的完整调用链插件根据operation字段分发操作当值为send_sms时进入短信发送分支调用 Plivo Node SDK 的client.messages.create(from, to, body)内部会向 Plivo 的 SMS 发送 API 发起请求若请求异常统一抛出QueryError(Query could not be completed, error.message)错误信息会展示在查询运行结果中成功时返回{ status: ok, data: result }其中data为 Plivo API 的原始响应通常包含message_uuid等消息标识可用于后续的状态跟踪。从类型定义 types.ts 可以看出插件遵循 ToolJet Marketplace 统一的服务契约实现QueryService接口其依赖为 package.json 中声明的plivo4.75.1与tooljet-marketplace/common因此该插件可以无缝接入 ToolJet 的查询执行引擎与内置数据源的使用方式一致。在查询面板中的完整使用流程完成数据源配置后在应用中发送短信的完整流程如下打开应用的查询面板点击 新建查询选择 Plivo 数据源操作类型保持Send SMS填写或绑定To Number、From Number、Body三个参数点击Run执行查询右侧结果区域会返回 Plivo API 的响应体可通过queries.queryName.data引用查询结果用于后续的事件处理如发送成功后更新状态、跳转页面或弹出通知。常见注意事项凭据安全Auth Token 在 manifest.json 中声明为encrypted: trueToolJet 会对其加密存储请勿在查询参数、日志或共享应用中明文输出该值。号码格式To/From 参数一般应使用 E.164 格式的国际号码如14155552671From Number 需为 Plivo 账户中可用的号码或 Sender ID否则 Plivo API 会返回错误。插件移除风险从 Marketplace 的 Installed 页移除 Plivo 插件后应用中所有关联的查询都会被一并删除移除前请确认没有正在使用的查询。版本说明本文以 v2.50.0-LTS 版本文档为基准当前仓库中 docs/docs/marketplace/plugins/plivo.md 的内容与之一致若需更深入了解插件开发规范可参考 Marketplace 总览文档中的 Plugin Development guide 指引。至此你已经掌握了在 ToolJet 中接入 Plivo 短信能力的完整链路从 Marketplace 安装、Auth ID/Token 凭据配置到 Send SMS 查询的动态参数绑定与底层 API 调用足以在内部工具中快速落地短信通知类业务。【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考