跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Interakt,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
让你的 AI 操作 Interakt 的 WhatsApp Business 账号:列出已审核的模板,查找和列出带属性与标签的客户,添加或更新客户,记录事件并分配聊天。发送模板消息和文本消息的工具在安装时处于关闭状态。
试试这样问
Interakt 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Interakt、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Interakt
让你的 AI 操作 Interakt 的 WhatsApp Business 账号:列出已审核的模板,查找和列出带属性与标签的客户,添加或更新客户,记录事件并分配聊天。发送模板消息和文本消息的工具在安装时处于关闭状态。
设置
设置大约需要 2 分钟。你需要一个 Growth 或更高套餐的 Interakt 账号:从这个套餐起才提供 API 访问。
- 在 Interakt 中打开 Settings → Developer Setting。
- 把 Secret Key 按原样复制到
INTERAKT_API_KEY,前面不要加 Basic。这个密钥已经编码过,连接器只会把它发送到 api.interakt.ai。 - 安装连接器并运行
interakt_list_templates:它会列出你的 WhatsApp 模板,并确认密钥和套餐可用。
电话号码:大多数工具需要不带国家代码的号码和单独的国家代码,例如 9876543210 和 +91(默认是印度)。发送自由文本的工具需要不带 + 的完整号码,例如 919876543210。
可读取的内容:你的 WhatsApp 模板,包括代码名称、显示名称、语言、类别、审核状态、页眉、带占位符的正文、页脚和按钮;按电话号码或 Interakt ID 查找的客户,包括姓名、邮箱、WhatsApp 订阅授权和你自定义的属性,以及标签和创建、最后修改时间;以及在某个时间段内创建或更新的客户,每次 100 个。
没有消息记录:Interakt API 不返回历史消息或送达状态,这些只会推送到 Interakt 的 Webhook。所以 AI 无法告诉你客户是否读过某条消息。
每次修改前都会询问:interakt_upsert_customer 新建客户,或更新同一号码的客户(属性会合并,标签只增加不删除);interakt_track_event 在客户时间线上记录 Order Placed 等事件,这可能触发会给客户发消息的 Interakt 自动化;interakt_assign_chat 按邮箱把共享收件箱中某位客户的聊天分配给团队成员。AI 会先展示客户和具体改动,等你同意后再执行。
安装时关闭:interakt_send_template 和 interakt_send_text。消息会立即送达客户,模板消息的会话由 Meta 计费。自由文本只能在客户最后一条消息后的 24 小时内发送;超出这个时间窗口,Interakt 会拒绝,只能使用已审核的模板。模板中的每个占位符({{1}}、{{2}} 等)都必须按顺序提供恰好一个值,因此 AI 会先读取模板并数清数量;带图片或文档页眉的模板还需要文件的公开链接。这些工具需要管理员有意识地开启,即使开启后,AI 也会先展示模板或文本、号码和取值,等你同意后再发送。成功的响应只表示 Interakt 已接收消息,并不代表已送达。
限制:Interakt 在 Growth 套餐下每分钟允许 300 次请求,Advanced 套餐下为 600 次,单个请求最大 32 KB。收到 429 后,AI 会等待一分钟再重试。
常见错误:401 表示密钥错误或你的套餐没有 API 访问权限:请重新复制 Secret Key(不要加 Basic),并确认套餐为 Growth 或更高。400 表示缺少字段或字段有误,Interakt 的消息会说明是哪一个,例如 "Missing variable values for template's body" 表示缺少模板取值。429 表示达到了请求频率上限。
该连接器不会创建模板,不运行营销活动,不上传媒体,不会改用 RCS 或短信发送,也不管理 Webhook。
前提条件: INTERAKT_API_KEY
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store,选择 Interakt 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
interakt_list_templates | List the account's WhatsApp message templates: id, name (the code name used to send), display_name, language, category, approval_status… |
interakt_list_customers | List customers (contacts) created or updated in a time window, 100 at a time: id, phone_number, country_code, traits (name, email… |
interakt_get_customer_by_phone | Find a customer by phone number: id, name and other traits, tags, WhatsApp opt-in, created and modified time |
interakt_get_customer | Read a customer by Interakt customer id: phone, traits, tags, created and modified time |
interakt_upsert_customer | Create a customer or update one with the same number: traits are merged into the profile, tags are added (never removed). traits must be a… |
interakt_track_event | Record an event on a customer's timeline (e.g |
interakt_assign_chat | Assign a customer's chat in the Interakt inbox to a team member by e-mail |
interakt_send_template | Send an approved WhatsApp template to a number |
interakt_send_text | Send a free-text WhatsApp message to a customer |
示例提示
- “查找客户 +91 98765 43210,告诉我她的姓名、标签,以及她是否同意接收 WhatsApp 消息。”
- “我们已审核的模板中哪些属于营销类?每个模板需要几个占位符?”
- “列出昨天在 Interakt 中新增或更新的客户。”
- “为 +91 98765 43210 记录一个 Order Placed 事件,订单号 1042,总额 Rs 1,499。先给我看一下。”
- “把 Rahul Sharma(+91 99887 76655)的聊天分配给 [email protected]。执行前先跟我确认。”
下一步
这份指南对你有帮助吗?