ClawSkills logoClawSkills

ManyChat

ManyChat API 集成，包含托管身份验证。管理订阅者、标签、自定义字段，并通过 Facebook Messenger 发送消息。 当此技能用于...

访问网站

介绍

# ManyChat

通过托管身份验证访问 ManyChat API。管理订阅者、标签、自定义字段、流程，并通过聊天自动化发送消息。

## 快速开始

```bash # Get page info python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/manychat/fb/page/getInfo') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ```

## 基础 URL

``` https://gateway.maton.ai/manychat/{native-api-path} ```

将 `{native-api-path}` 替换为实际的 ManyChat API 端点路径。网关将请求代理到 `api.manychat.com` 并自动注入您的 API 令牌。

## 身份验证

所有请求都需要在 Authorization 头中包含 Maton API 密钥：

``` Authorization: Bearer $MATON_API_KEY ```

**环境变量：** 将您的 API 密钥设置为 `MATON_API_KEY`：

```bash export MATON_API_KEY="YOUR_API_KEY" ```

### 获取您的 API 密钥

1. 登录或在 [maton.ai](https://maton.ai) 创建账户 2. 前往 [maton.ai/settings](https://maton.ai/settings) 3. 复制您的 API 密钥

## 连接管理

在 `https://ctrl.maton.ai` 管理您的 ManyChat 连接。

### 列出连接

```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=manychat&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ```

### 创建连接

```bash python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'manychat'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ```

### 获取连接

```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ```

**响应：** ```json { "connection": { "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80", "status": "ACTIVE", "creation_time": "2025-12-08T07:20:53.488460Z", "last_updated_time": "2026-01-31T20:03:32.593153Z", "url": "https://connect.maton.ai/?session_token=...", "app": "manychat", "metadata": {} } } ```

通过连接 URL 提供您的 ManyChat API 密钥以完成连接。

### 删除连接

```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ```

### 指定连接

如果您有多个 ManyChat 连接，请使用 `Maton-Connection` 头指定要使用的连接：

```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/manychat/fb/page/getInfo') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ```

如果省略，网关将使用默认（最旧的）活动连接。

## API 参考

### 页面操作

#### 获取页面信息

```bash GET /manychat/fb/page/getInfo ```

速率限制：每秒 100 次查询

**响应：** ```json { "status": "success", "data": { "id": 123456789, "name": "Page Name", "category": "Business", "avatar_link": "https://...", "username": "pagename", "about": "About text", "description": "Page description", "is_pro": true, "timezone": "America/New_York" } } ```

### 标签操作

#### 列出标签

```bash GET /manychat/fb/page/getTags ```

速率限制：每秒 100 次查询

**响应：** ```json { "status": "success", "data": [ {"id": 1, "name": "VIP"}, {"id": 2, "name": "Customer"} ] } ```

#### 创建标签

```bash POST /manychat/fb/page/createTag Content-Type: application/json

{ "name": "New Tag" } ```

速率限制：每秒 10 次查询

#### 从页面移除标签

```bash POST /manychat/fb/page/removeTag Content-Type: application/json

{ "tag_id": 123 } ```

速率限制：每秒 10 次查询。从页面及所有订阅者处移除标签。

#### 按名称移除标签

```bash POST /manychat/fb/page/removeTagByName Content-Type: application/json

{ "tag_name": "Old Tag" } ```

速率限制：每秒 10 次查询

### 自定义字段操作

#### 列出自定义字段

```bash GET /manychat/fb/page/getCustomFields ```

速率限制：每秒 100 次查询

**响应：** ```json { "status": "success", "data": [ {"id": 1, "name": "phone_number", "type": "text"}, {"id": 2, "name": "purchase_count", "type": "number"} ] } ```

#### 创建自定义字段

```bash POST /manychat/fb/page/createCustomField Content-Type: application/json

{ "caption": "Phone Number", "type": "text", "description": "Customer phone number" } ```

速率限制：每秒 10 次查询

**字段类型：** `text`、`number`、`date`、`datetime`、`boolean`

### Bot 字段操作

#### 列出 Bot 字段

```bash GET /manychat/fb/page/getBotFields ```

速率限制：每秒 100 次查询

#### 创建 Bot 字段

```bash POST /manychat/fb/page/createBotField Content-Type: application/json

{ "name": "counter", "type": "number", "description": "Global counter", "value": 0 } ```

速率限制：每秒 10 次查询

#### 设置 Bot 字段

```bash POST /manychat/fb/page/setBotField Content-Type: application/json

{ "field_id": 123, "field_value": 42 } ```

速率限制：每秒 10 次查询

#### 按名称设置 Bot 字段

```bash POST /manychat/fb/page/setBotFieldByName Content-Type: application/json

{ "field_name": "counter", "field_value": 42 } ```

速率限制：每秒 10 次查询

#### 设置多个 Bot 字段

```bash POST /manychat/fb/page/setBotFields Content-Type: application/json

{ "fields": [ {"field_id": 123, "field_value": "value1"}, {"field_name": "field2", "field_value": "value2"} ] } ```

速率限制：每秒 10 次查询。每个请求最多 20 个字段。

### 流程操作

#### 列出流程

```bash GET /manychat/fb/page/getFlows ```

速率限制：每秒 10 次查询

**响应：** ```json { "status": "success", "data": { "flows": [ {"ns": "content123456", "name": "Welcome Flow", "folder_id": 1} ], "folders": [ {"id": 1, "name": "Main Folder"} ] } } ```

### 增长工具

#### 列出增长工具

```bash GET /manychat/fb/page/getGrowthTools ```

速率限制：每秒 100 次查询

### OTN 主题

#### 列出 OTN 主题

```bash GET /manychat/fb/page/getOtnTopics ```

速率限制：每秒 100 次查询

### 订阅者操作

#### 获取订阅者信息

```bash GET /manychat/fb/subscriber/getInfo?subscriber_id=123456789 ```

速率限制：每秒 10 次查询

**响应：** ```json { "status": "success", "data": { "id": 123456789, "name": "John Doe", "first_name": "John", "last_name": "Doe", "gender": "male", "profile_pic": "https://...", "subscribed": "2025-01-15T10:30:00Z", "last_interaction": "2025-02-01T14:20:00Z", "tags": [{"id": 1, "name": "VIP"}], "custom_fields": [{"id": 1, "name": "phone", "value": "+1234567890"}] } } ```

#### 按名称查找订阅者

```bash GET /manychat/fb/subscriber/findByName?name=John%20Doe ```

速率限制：每秒 10 次查询。最多 100 条结果。

#### 按自定义字段查找订阅者

```bash GET /manychat/fb/subscriber/findByCustomField?field_id=123&field_value=value ```

速率限制：每秒 10 次查询。适用于文本和数字字段。最多 100 条结果。

#### 按系统字段查找订阅者

```bash GET /manychat/fb/subscriber/[email protected] ```

```bash GET /manychat/fb/subscriber/findBySystemField?phone=+1234567890 ```

速率限制：每秒 50 次查询。设置 `email` 或 `phone` 参数之一。

#### 按 User Ref 获取订阅者

```bash GET /manychat/fb/subscriber/getInfoByUserRef?user_ref=123456 ```

#### 创建订阅者

```bash POST /manychat/fb/subscriber/createSubscriber Content-Type: application/json

{ "first_name": "John", "last_name": "Doe", "phone": "+1234567890", "email": "[email protected]", "gender": "male", "has_opt_in_sms": true, "has_opt_in_email": true, "consent_phrase": "I agree to receive messages" } ```

速率限制：每秒 10 次查询

**注意：** 导入带有电话或电子邮件的订阅者需要 ManyChat 的特殊权限。请联系 ManyChat 支持部门为您的账户启用此功能。

#### 更新订阅者

```bash POST /manychat/fb/subscriber/updateSubscriber Content-Type: application/json

{ "subscriber_id": 123456789, "first_name": "John", "last_name": "Smith", "phone": "+1234567890", "email": "[email protected]" } ```

速率限制：每秒 10 次查询

#### 为订阅者添加标签

```bash POST /manychat/fb/subscriber/addTag Content-Type: application/json

{ "subscriber_id": 123456789, "tag_id": 1 } ```

速率限制：每秒 10 次查询

#### 按名称添加标签

```bash POST /manychat/fb/subscriber/addTagByName Content-Type: application/json

{ "subscriber_id": 123456789, "tag_name": "VIP" } ```

速率限制：每秒 10 次查询

#### 从订阅者处移除标签

```bash POST /manychat/fb/subscriber/removeTag Content-Type: application/json

{ "subscriber_id": 123456789, "tag_id": 1 } ```

速率限制：每秒 10 次查询

#### 按名称移除标签

```bash POST /manychat/fb/subscriber/removeTagByName Content-Type: application/json

{ "subscriber_id": 123456789, "tag_name": "VIP" } ```

速率限制：每秒 10 次查询

#### 设置自定义字段

```bash POST /manychat/fb/subscriber/setCustomField Content-Type: application/json

{ "subscriber_id": 123456789, "field_id": 1, "field_value": "+1234567890" } ```

速率限制：每秒 10 次查询

#### 按名称设置自定义字段

```bash POST /manychat/fb/subscriber/setCustomFieldByName Content-Type: application/json

{ "subscriber_id": 123456789, "field_name": "phone_number", "field_value": "+1234567890" } ```

速率限制：每秒 10 次查询

#### 设置多个自定义字段

```bash POST /manychat/fb/subscriber/setCustomFields Content-Type: application/json

{ "subscriber_id": 123456789, "fields": [ {"field_id": 1, "field_value": "value1"}, {"field_name": "field2", "field_value": "value2"} ] } ```

速率限制：每秒 10 次查询。每个请求最多 20 个字段。

#### 通过签名请求验证订阅者

```bash POST /manychat/fb/subscriber/verifyBySignedRequest Content-Type: application/json

{ "subscriber_id": 123456789, "signed_request": "signed_request_token" } ```

速率限制：每秒 10 次查询

### 发送操作

#### 发送内容

```bash POST /manychat/fb/sending/sendContent Content-Type: application/json

{ "subscriber_id": 123456789, "data": { "version": "v2", "content": { "messages": [ { "type": "text", "text": "Hello! How can I help you today?" } ] } }, "message_tag": "CONFIRMED_EVENT_UPDATE" } ```

速率限制：每秒 25 次查询

**消息标签：** 在 24 小时消息窗口之外发送时需要 - `CONFIRMED_EVENT_UPDATE` - `POST_PURCHASE_UPDATE` - `ACCOUNT_UPDATE`

**OTN（一次性通知）：** ```json { "subscriber_id": 123456789, "data": {...}, "otn_topic_name": "Price Drop Alert" } ```

#### 按 User Ref 发送内容

```bash POST /manychat/fb/sending/sendContentByUserRef Content-Type: application/json

{ "user_ref": 123456, "data": { "version": "v2", "content": { "messages": [ { "type": "text", "text": "Welcome!" } ] } } } ```

速率限制：每秒 25 次查询

#### 发送流程

```bash POST /manychat/fb/sending/sendFlow Content-Type: application/json

{ "subscriber_id": 123456789, "flow_ns": "content123456" } ```

速率限制：每秒 20 次查询，每位订阅者每小时最多 100 次

## 消息内容格式

ManyChat 使用结构化内容格式来发送消息：

### 文本消息

```json { "version": "v2", "content": { "messages": [ { "type": "text", "text": "Your message here" } ] } } ```

### 图片消息

```json { "version": "v2", "content": { "messages": [ { "type": "image", "url": "https://example.com/image.jpg" } ] } } ```

### 快速回复

```json { "version": "v2", "content": { "messages": [ { "type": "text", "text": "Choose an option:", "quick_replies": [ {"type": "node", "caption": "Option 1", "target": "content123"}, {"type": "node", "caption": "Option 2", "target": "content456"} ] } ] } } ```

### 按钮

```json { "version": "v2", "content": { "messages": [ { "type": "text", "text": "Click a button:", "buttons": [ {"type": "url", "caption": "Visit Website", "url": "https://example.com"}, {"type": "flow", "caption": "Start Flow", "target": "content123"} ] } ] } } ```

## 代码示例

### JavaScript

```javascript // Get page info const response = await fetch( 'https://gateway.maton.ai/manychat/fb/page/getInfo', { headers: { 'Authorization': `Bearer ${process.env.MATON_API_KEY}` } } ); const data = await response.json();

// Send a message const sendResponse = await fetch( 'https://gateway.maton.ai/manychat/fb/sending/sendContent', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.MATON_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ subscriber_id: 123456789, data: { version: 'v2', content: { messages: [{ type: 'text', text: 'Hello!' }] } } }) } ); ```

### Python

```python import os import requests

# Get page info response = requests.get( 'https://gateway.maton.ai/manychat/fb/page/getInfo', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'} ) data = response.json()

# Send a message send_response = requests.post( 'https://gateway.maton.ai/manychat/fb/sending/sendContent', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}, json={ 'subscriber_id': 123456789, 'data': { 'version': 'v2', 'content': { 'messages': [{'type': 'text', 'text': 'Hello!'}] } } } ) ```

## 注意事项

- 订阅者 ID 在您的 ManyChat 页面内是唯一的 - 流程命名空间 (flow_ns) 用于标识特定的自动化流程 - 在 24 小时消息窗口之外发送消息时，`message_tag` 参数是必需的 - OTN（一次性通知）允许按主题订阅发送一条消息 - 大多数 POST 端点在成功时返回 `{"status": "success"}` - 重要：使用 curl 命令时，如果 URL 包含括号，请使用 `curl -g` 以禁用 glob 解析 - 重要：当将 curl 输出通过管道传递给 `jq` 或其他命令时，`$MATON_API_KEY` 等环境变量在某些 shell 环境中可能无法正确展开

## 错误处理

| 状态 | 含义 | |--------|---------| | 400 | 缺少 ManyChat 连接 | | 401 | Maton API 密钥无效或缺失 | | 429 | 速率受限 | | 4xx/5xx | 来自 ManyChat API 的透传错误 |

### ManyChat 错误代码

| 代码 | 含义 | |------|---------| | 2011 | 未找到订阅者 | | 2012 | 未找到 User ref | | 3011 | 消息内容无效 | | 3021 | 需要消息标签 | | 3031 | 未找到 OTN 主题 |

### 故障排除：API 密钥问题

1. 检查是否已设置 `MATON_API_KEY` 环境变量：

```bash echo $MATON_API_KEY ```

2. 通过列出连接来验证 API 密钥是否有效：

```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ```

### 故障排除：应用名称无效

1. 确保您的 URL 路径以 `manychat` 开头。例如：

- 正确：`https://gateway.maton.ai/manychat/fb/page/getInfo` - 错误：`https://gateway.maton.ai/fb/page/getInfo`

## 资源

- [ManyChat API 文档](https://api.manychat.com/swagger) - [ManyChat API 密钥生成指南](https://help.manychat.com/hc/en-us/articles/14959510331420) - [ManyChat 开发者计划](https://help.manychat.com/hc/en-us/articles/14281269835548) - [Maton 社区](https://discord.com/invite/dBfFAcefs2) - [Maton 支持](mailto:[email protected])

返回

更多产品

Agent Browser

浏览器与自动化

一款基于 Rust 的快速无头浏览器自动化 CLI，具备 Node.js 回退机制，支持 AI 智能体通过结构化命令导航网页、点击、输入和获取页面快照。

22.4K

Brave Search

浏览器与自动化

通过 Brave Search API 进行网络搜索和内容提取。用于搜索文档、事实或任何网络内容。轻量级，无需浏览器。

9K

Desktop Control

浏览器与自动化

具有鼠标、键盘和屏幕控制功能的高级桌面自动化。

6.3K