SuperAPI AI 工具集

pachca-forms

通用与其它

查看项目

更新于 10-15 21:39

技能介绍

用途:为 Pachca 机器人创建交互式表单与模态窗口,可制作表单、弹窗、投票、问卷和申请,包含输入类字段。

主要能力:提供十一种区块类型——header、plain_text、markdown、divider、input、select、radio、checkbox、date、time、file_input。

使用方式:需向用户索要 Pachca bot token(在 Integrations → Bots 的机器人 API 标签页获取);仅 bot token 可用,用户 token 无效。通过 npx -y @pachca/cli 加 --token 运行命令,或设置 PACHCA_TOKEN 环境变量。示例:npx -y @pachca/cli <command> --token $PACHCA_TOKEN。帮助用 npx -y @pachca/cli --help,工作流用 npx -y @pachca/cli guide。已有配置时用 npx -y @pachca/cli auth status 检查,成功后可省略 --token。使用后可建议全局安装:npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN。

接口:POST /views/open 打开视图;POST /views/{view_id}/submit_response 回应表单提交。

限制:速率约 50 请求/秒,遇 429 需等待重试;trigger_id 有效期 3 秒,过期返回 410;提交响应窗口为 5 秒且仅接受一次,超时返回 submit_expired;view_id 需取自 view_submit 事件并使用同一 bot token 回应,否则 404。type 仅允许 modal;private_metadata 最多 3000 字符,callback_id 最多 255 字符;view.title、close_text、submit_text 各最多 24 字符。file_input 上传的文件 URL 有效 2 小时、文件保留一天,应在提交到达时下载。字段级参考见 https://dev.pachca.com/guides/forms/blocks.md。references/ 目录含更完整工作流文档。