Meta Business CLI

使用 meta 命令行工具，通过 Graph API 实现 WhatsApp、Instagram、Facebook Pages 和 Messenger 的自动化操作。

初始化配置

# 1. 配置应用凭据
meta config set app.id YOUR_APP_ID
meta config set app.secret YOUR_APP_SECRET

# 2. 认证（OAuth PKCE 流程，自动打开浏览器）
meta auth login

# 3. 配置 WhatsApp（从 API Setup 页面获取参数）
meta config set whatsapp.phoneNumberId YOUR_PHONE_NUMBER_ID
meta config set whatsapp.businessAccountId YOUR_WABA_ID

# 4. 验证所有配置是否正常工作
meta doctor

也可在任意命令后添加 --token YOUR_TOKEN 参数跳过 OAuth 流程（例如使用 System User token）。

认证

meta auth login                              # OAuth PKCE 流程（自动打开浏览器）
meta auth login --token YOUR_ACCESS_TOKEN    # 使用已有访问令牌
meta auth login --scopes "whatsapp_business_messaging,instagram_basic,pages_show_list"
meta auth status                             # 显示令牌有效性及已授权权限范围
meta auth logout                             # 清除本地存储的凭据

配置

meta config set app.id YOUR_APP_ID           # 应用 ID（纯数字）
meta config set app.secret YOUR_APP_SECRET   # 应用密钥
meta config set whatsapp.phoneNumberId ID    # WhatsApp 电话号码 ID
meta config set whatsapp.businessAccountId ID  # WhatsApp 商业账号 ID
meta config set instagram.accountId ID       # Instagram 账号 ID
meta config set pages.pageId ID              # Facebook Page ID
meta config set webhook.forwardUrl URL       # 将入站消息转发至指定 URL
meta config get                         # 获取某项配置值
meta config list                             # 列出全部配置项

配置文件存储于 ~/.meta-cli/config.json。

WhatsApp

发送消息

# 纯文本
meta wa send "+1234567890" --text "Hello" --json

# Markdown（自动转换为 WhatsApp 支持的格式）
meta wa send "+1234567890" --text "**bold** and _italic_" --markdown --json

# 分块发送（将长文本自动拆分为多条消息）
meta wa send "+1234567890" --text "very long message..." --chunk --json

# 图片
meta wa send "+1234567890" --image "https://example.com/photo.jpg" --caption "Look" --json

# 视频
meta wa send "+1234567890" --video "https://example.com/video.mp4" --caption "Watch" --json

# 文档
meta wa send "+1234567890" --document "https://example.com/file.pdf" --json

# 本地文件（自动上传）
meta wa send "+1234567890" --document ./report.pdf --caption "Q4 report" --json

# 音频
meta wa send "+1234567890" --audio "https://example.com/note.ogg" --json

# 语音便签（以可播放语音便签形式呈现，需为 OGG/Opus 格式）
meta wa send "+1234567890" --audio "./recording.ogg" --voice --json

# 模板消息
meta wa send "+1234567890" --template "hello_world" --template-lang en_US --json

# 标记为已读
meta wa read WAMID --json

媒体文件大小限制

模板管理

meta wa template list --json                 # 列出全部模板
meta wa template get TEMPLATE_NAME --json    # 获取指定模板详情
meta wa template delete TEMPLATE_NAME --json # 删除指定模板

媒体管理

meta wa media upload ./photo.jpg --json      # 上传媒体文件
meta wa media url MEDIA_ID --json            # 获取媒体文件 URL
meta wa media download MEDIA_ID ./output.jpg # 下载媒体文件

分析数据

meta wa analytics --days 30 --granularity DAY --json

电话号码管理

meta wa phone list --json                    # 列出所有号码
meta wa phone get --json                     # 获取当前激活号码详情
meta wa phone select PHONE_NUMBER_ID         # 切换激活号码

白名单（防范提示注入攻击）

meta wa allowlist list                       # 列出已允许号码
meta wa allowlist add "+1234567890"          # 添加号码
meta wa allowlist remove "+1234567890"       # 移除号码

当白名单非空时，meta wa send 仅向白名单中列出的号码发送消息。

Instagram

# 发布图片
meta ig publish --image "https://example.com/photo.jpg" --caption "My post" --json

# 发布视频
meta ig publish --video "https://example.com/video.mp4" --caption "Watch this" --json

# 发布 Reel
meta ig publish --video "https://example.com/reel.mp4" --reel --caption "New reel" --json

# 账号数据洞察
meta ig insights --period day --days 30 --json

# 媒体数据洞察
meta ig insights --media-id MEDIA_ID --json

# 评论管理
meta ig comments list MEDIA_ID --json        # 列出评论
meta ig comments reply COMMENT_ID "Thanks!" --json  # 回复评论
meta ig comments hide COMMENT_ID --json      # 隐藏评论
meta ig comments delete COMMENT_ID --json    # 删除评论

Instagram 发布功能要求图片/视频必须通过公开 URL 提供（不支持本地文件）。

Facebook Pages

meta fb post --message "Hello from the CLI" --json           # 创建帖子
meta fb post --message "Check this" --link "https://example.com" --json  # 创建带链接的帖子
meta fb list --limit 10 --json                               # 列出最近帖子
meta fb insights --period day --days 30 --json               # 查看数据洞察

Messenger

meta messenger send PSID --text "Hello" --json               # 发送文本
meta messenger send PSID --image "https://example.com/photo.jpg" --json  # 发送图片
meta messenger send PSID --text "Update" --type MESSAGE_TAG --tag HUMAN_AGENT --json  # 在 24 小时窗口外发送（需指定消息标签）
meta messenger receive --json                                # 列出会话列表
meta messenger receive --conversation-id CONV_ID --json      # 查看指定会话

在 24 小时窗口外向用户发送 Messenger 消息时，必须指定 MESSAGE_TAG 类型及有效标签。

Webhook

# 启动监听服务
meta webhook listen --port 3000 --verify-token TOKEN --app-secret SECRET

# 本地验证 Webhook 签名
meta webhook verify --verify-token TOKEN --json

# 订阅事件
meta webhook subscribe 
  --object whatsapp_business_account 
  --fields messages 
  --callback-url "https://example.com/webhook" --json

在配置中设置 webhook.forwardUrl 后，系统将把接收到的入站消息以 POST 方式转发至外部服务。 Webhook 服务会自动为入站消息发送已读回执，并确认用户对消息的反应（reactions）。

Webhook 服务（systemd）

meta service install                         # 安装 systemd 用户级服务
meta service start                           # 启动 Webhook 服务
meta service stop                            # 停止服务
meta service restart                         # 重启服务
meta service status                          # 查看服务状态
meta service logs                            # 查看服务日志
meta service uninstall                       # 卸载 systemd 服务

Shell 补全

# Bash
meta completion >> ~/.bashrc

# Zsh（添加到 .zshrc）
meta completion >> ~/.zshrc

诊断检查

meta doctor --json

检查配置、凭据、令牌有效性、Graph API 连通性、权限以及各平台专属资源的访问能力。首次使用前建议运行该命令。

全局参数

注意事项

• 自动化场景下，请始终使用 --json 参数以获得结构化输出。
• 所有命令在提供必需参数（以 flag 形式传入）时均可非交互式运行。
• 语音便签需为 OGG/Opus 格式，才能在 WhatsApp 中正确渲染为可播放形式。
• 超出尺寸限制的文件将被拒绝，并返回明确的错误提示。
• 对于大尺寸文件，请托管于公开 URL 并直接传递该 URL。