用途:把用户自己的 WhatsApp 号码、Instagram 账号和 Facebook 主页接入代码——入站事件转发到代码,回复通过 Meta 官方 API 发出。出站发送经 HookMyApp 网关(https://gateway.hookmyapp.com/meta/...):应用携带铸出的 hmat_ 网关访问令牌,网关在服务端替换为底层 Meta 令牌,/meta 之后的路径即 Meta Graph API 原文。已有直接调用 https://graph.facebook.com 的集成不受影响;新装推荐网关路径,令牌仅限单个渠道且可撤销。
主要能力:CLI 负责凭证签发、隧道生命周期与 webhook 配置。沙盒账号用于开发测试(6 个环境变量、无模板、收件人固定为会话手机);自有渠道支持 WhatsApp(7 个环境变量、支持模板)、Instagram(6 个环境变量、无模板)或 Facebook Page(令牌经 channels token,Page id 经 channels show)。
使用方式:先安装 CLI,要求 Node.js 20+。必要条件:command -v hookmyapp >/dev/null 2>&1 || npm install -g '@gethookmyapp/cli@>=0.14.17 <1'。登录用 hookmyapp login(--email 为免浏览器 OTP 登录),连接渠道用 hookmyapp channels connect,导出环境用 hookmyapp channels env <channel> --write 或沙盒 hookmyapp sandbox env --write .env。自有渠道收 webhook 有两种互斥方式:hookmyapp channels listen(CLI 提供 Cloudflare 隧道)或 hookmyapp channels webhook set <channel> --url https://...。
关键限制:浏览器步骤无法自动化;连接真实渠道须先确认是自有团队渠道还是客户渠道(后者须用 onboarding link 指向 customer workspace)。禁止把令牌或签名密钥粘贴到对话、工单或日志;未获人工确认不得运行 webhook set、channels disable、channels listen。通知需在每次会话转达并确认,先转达再 acknowledge。MCP 为可选,缺少 MCP 工具时应改用 CLI。