用途:该技能用于与 Punchh 营销平台交互。Punchh 面向餐厅、美发沙龙、便利店等线下零售商,帮助其创建和管理忠诚度计划、促销活动与客户互动活动,以促进复购并提升客户终身价值。涉及对象包括 Guest(访客)、Loyalty Account(忠诚账户)、Reward(奖励)、Order(订单)。官方文档:https://developers.punchh.com/
主要能力:通过 Membrane 预置動作读写 Punchh 数据,涵盖上述对象;Membrane 自动处理认证与凭据刷新,无需用户提供 API 密钥;当预置动作不覆盖需求时,可通过 Membrane 代理直接请求 Punchh API,自动补全基础 URL 并注入认证头。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无界面环境会打印授权 URL,用户完成登录后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://punchh.com" --json;若状态为 BUILDING 则轮询 npx @membranehq/cli connection get <id> --wait --json,直至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,可用 --input '{"key":"value"}' 传参,结果在 output 字段。直接请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--query、--pathParam 等选项,任意命令可加 --json 输出机器可读结果。
适用场景:需要读取或管理访客、忠诚账户、奖励、订单等 Punchh 数据,或在自动化工作流中调用 Punchh 营销能力时使用。
限制:具体可用动作需通过 action list 查询,本资料未列出完整动作清单;代理请求需自行构造路径与参数;认证由 Membrane 服务端管理,不应向用户索取密钥;使用前需具备 Membrane 账号与相应连接权限。