用途:ReferralHero 是一个推荐计划平台,帮助企业通过口碑营销获取新客户,提供设计、发布和管理推荐活动的工具,面向营销团队和增长人员,用于激励推荐并跟踪效果。官方文档:https://help.referralhero.com/en/。该技能通过 Membrane CLI 与 ReferralHero 交互,用于管理数据、记录和自动化工作流。涉及对象包括 Campaign、Referral Program、Form、Page、Email、Referral Link、Rule、Contact、Reward、Subscription、User、Workspace。
主要能力:调用 Membrane 预置动作对 ReferralHero 数据进行查询与操作;在动作不覆盖需求时,通过代理直接向 ReferralHero API 发送请求;Membrane 自动处理认证与凭据刷新。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无交互环境会输出授权 URL,用户完成登录后用 membrane login complete <code> 收尾。建立连接:membrane connection ensure "https://referralhero.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 --input '{"key": "value"}' --json。代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。任意命令可加 --json 获得机器可读输出。
适用场景:需要读取或写入 ReferralHero 推荐活动、联系人、奖励等数据,或将其接入自动化流程时使用;也适合在已有动作不满足需求时直接调用其 API。
限制:资料未提供具体动作清单、可用字段、速率限制、错误码及定价信息,需以实际连接后的动作列表和官方文档为准。不要向用户索取 API key 或 token,应通过创建连接让 Membrane 管理凭据生命周期。