用途:该技能用于与 Facebook Messenger 数据交互,覆盖用户、联系人、Stories、Reactions 等对象的管理。官方平台文档见 https://developers.facebook.com/docs/messenger-platform。
主要能力:围绕会话(Conversation)、消息(Message)、附件(Attachment)、用户(User)、群聊(Group Chat)等概念进行操作。
使用方式:通过 Membrane CLI 调用,命令为 npx @membranehq/cli@latest。首次设置执行 npx @membranehq/cli@latest login --tenant,浏览器完成认证后凭据存于 ~/.membrane/credentials.json。无头环境下运行命令并把打印的 URL 交给用户在浏览器打开,再执行 npx @membranehq/cli@latest login complete <code>。
连接:先搜索连接器 npx @membranehq/cli@latest search facebook-messenger --elementType=connector --json,从输出 items[0].element?.id 取连接器 ID,再执行 npx @membranehq/cli@latest connect --connectorId=CONNECTOR_ID --json,用户在浏览器完成认证后获得 connection id。可用 npx @membranehq/cli@latest connection list --json 查看现有连接。
查找与运行动作:用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 发现动作,返回含 id 与 inputSchema;运行用 npx @membranehq/cli@latest action run --connectionId=CONNECTION_ID ACTION_ID --json,传参数加 --json --input "{ "key": "value" }"。
代理请求:动作不覆盖时可执行 npx @membranehq/cli@latest request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam,也可传完整 URL。Membrane 会自动附加基础 URL 并注入认证头,凭据过期可透明刷新。
限制与建议:优先使用 Membrane 预建动作以获得内置认证、分页与错误处理;先发现再构建;不要让用户提供 API 密钥或令牌,改用连接方式由 Membrane 服务端管理认证生命周期。具体可用动作与参数以实际查询结果为准,资料未列出固定动作清单。