SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场botpenguin

botpenguin

智能体与模型

查看项目

更新于 10-16 02:02

技能介绍

BotPenguin 是一个无需编程即可为网站和即时通讯应用构建聊天机器人的平台，主要被营销人员、客户支持团队和小型企业主用于自动化对话和线索获取。官方文档地址为 https://developers.botpenguin.com/。

用途 本技能用于将 BotPenguin 集成到工作流中，管理聊天机器人并与其数据进行交互。当用户需要访问或操作 BotPenguin 数据时使用。

主要能力 该技能通过 Membrane CLI 与 BotPenguin 交互，Membrane 自动处理身份验证和凭据刷新，因此可以专注于集成逻辑而非认证细节。可用的常见操作包括：

  • List Chats（list-chats）：从收件箱检索带有元数据的聊天会话。
  • Update Lead（update-lead）：更新收件箱中的线索/联系人详情。
  • Import Contacts（import-contacts）：在 BotPenguin 收件箱中导入或创建新的联系人/用户。
  • List Inbox Users（list-inbox-users）：从 BotPenguin 收件箱检索用户/联系人，支持可选筛选条件。
  • Send WhatsApp Media Message（send-whatsapp-media-message）：向 WhatsApp 用户发送媒体消息（图片、文档等）。
  • Send WhatsApp Text Message（send-whatsapp-text-message）：向 WhatsApp 用户发送纯文本消息。
  • Send WhatsApp Template Message（send-whatsapp-template-message）：向用户发送 WhatsApp 模板消息。
  • List WhatsApp Templates（list-whatsapp-templates）：检索已从 Facebook WhatsApp Business Manager 同步的所有 WhatsApp 消息模板。

使用方式

  1. 安装 CLI：npm install -g @membranehq/cli@latest
  2. 身份验证：membrane login --tenant --clientName=<agentType>。该命令会打开浏览器进行身份验证，或在控制台打印授权 URL。无头环境下会打印授权 URL，用户需在浏览器中打开，完成登录后看到代码，再执行 membrane login complete <code>。任意命令加 --json 可获得机器可读的 JSON 输出。Agent Types 包括 claude、openclaw、codex、warp、windsurf 等。
  3. 连接 BotPenguin：使用 membrane connection ensure "https://botpenguin.com/" --json 按应用 URL 或域名查找或创建连接。用户在浏览器中完成身份验证，输出包含新的连接 id。若返回的连接状态为 READY，可直接进入下一步；若为 BUILDING，则轮询 npx @membranehq/cli connection get <id> --wait --json 直到状态不再是 BUILDING。状态说明：READY 表示连接已完全建立；CLIENT_ACTION_REQUIRED 表示用户或代理需要执行操作，clientAction.type 为 "connect" 表示需要身份验证，为 "provide-input" 表示需要更多信息，clientAction.description 为人类可读说明，clientAction.uiUrl 为可选的操作 UI 地址，clientAction.agentInstructions 为可选的代理指令；CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错，需检查 error 字段。
  4. 搜索操作：membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。应在特定连接的上下文中搜索操作。每个结果包含 id、name、description、inputSchema（接受的参数）和 outputSchema（返回内容）。
  5. 运行操作：membrane action run <actionId> --connectionId=CONNECTION_ID --json。传递 JSON 参数：membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。结果位于响应的 output 字段中。
  6. 代理请求：当可用操作无法覆盖用例时，可通过 Membrane 的代理直接向 BotPenguin API 发送请求：membrane request CONNECTION_ID /path/to/endpoint。Membrane 会自动附加基础 URL 并注入正确的认证头，包括凭据过期时的透明刷新。常用选项包括 -X/--method（HTTP 方法，默认 GET）、-H/--header（添加请求头，可重复）、-d/--data（请求体字符串）、--json（发送 JSON 体并设置 Content-Type: application/json）、--rawData（原样发送请求体）、--query（查询字符串参数，可重复）、--pathParam（路径参数，可重复）。

适用场景 适用于需要与 BotPenguin 数据交互的场景，例如管理聊天机器人、处理收件箱中的聊天与联系人、更新线索、导入联系人，以及通过 WhatsApp 发送文本、媒体或模板消息。

限制 资料未提供 BotPenguin 的收费、价格、平台覆盖范围、具体效果或更多使用步骤等信息。使用前需完成 Membrane CLI 安装与身份验证，并建立与 BotPenguin 的连接。