meta-business

name	meta-business
description	Skill for the Meta Business CLI. Complete WhatsApp, Instagram, Facebook Pages, and Messenger automation via the Graph API. Supports messaging, media, templates, analytics, webhooks, and systemd service management.

Meta Business CLI

Use meta for WhatsApp, Instagram, Facebook Pages, and Messenger automation via the Graph API.

Setup

# 1. Configure app credentials
meta config set app.id YOUR_APP_ID
meta config set app.secret YOUR_APP_SECRET

# 2. Authenticate (OAuth PKCE, opens browser)
meta auth login

# 3. Configure WhatsApp (from API Setup page)
meta config set whatsapp.phoneNumberId YOUR_PHONE_NUMBER_ID
meta config set whatsapp.businessAccountId YOUR_WABA_ID

# 4. Verify everything works
meta doctor

Or use --token YOUR_TOKEN with any command to skip OAuth (e.g. System User tokens).

Authentication

meta auth login                              # OAuth PKCE flow (opens browser)
meta auth login --token YOUR_ACCESS_TOKEN    # Use existing token
meta auth login --scopes "whatsapp_business_messaging,instagram_basic,pages_show_list"
meta auth status                             # Show token validity and scopes
meta auth logout                             # Remove stored credentials

Configuration

meta config set app.id YOUR_APP_ID           # App ID (numeric)
meta config set app.secret YOUR_APP_SECRET   # App secret
meta config set whatsapp.phoneNumberId ID    # WhatsApp phone number ID
meta config set whatsapp.businessAccountId ID  # WhatsApp business account ID
meta config set instagram.accountId ID       # Instagram account ID
meta config set pages.pageId ID              # Facebook Page ID
meta config set webhook.forwardUrl URL       # Forward inbound messages to URL
meta config get <key>                        # Get a config value
meta config list                             # Show all config values

Config stored at ~/.meta-cli/config.json.

WhatsApp

Sending Messages

# Text
meta wa send "[phone]" --text "Hello" --json

# Markdown (converts to WhatsApp formatting)
meta wa send "[phone]" --text "**bold** and _italic_" --markdown --json

# Chunked (splits long text into multiple messages)
meta wa send "[phone]" --text "very long message..." --chunk --json

# Image
meta wa send "[phone]" --image "https://example.com/photo.jpg" --caption "Look" --json

# Video
meta wa send "[phone]" --video "https://example.com/video.mp4" --caption "Watch" --json

# Document
meta wa send "[phone]" --document "https://example.com/file.pdf" --json

# Local file (auto-uploads)
meta wa send "[phone]" --document ./report.pdf --caption "Q4 report" --json

# Audio
meta wa send "[phone]" --audio "https://example.com/note.ogg" --json

# Voice note (renders as playable voice note, requires OGG/Opus)
meta wa send "[phone]" --audio "./recording.ogg" --voice --json

# Template
meta wa send "[phone]" --template "hello_world" --template-lang en_US --json

# Mark as read
meta wa read WAMID --json

Media File Size Limits

Type	Max Size
Image	5 MB
Video	16 MB
Document	100 MB

Templates

meta wa template list --json                 # List all templates
meta wa template get TEMPLATE_NAME --json    # Get template details
meta wa template delete TEMPLATE_NAME --json # Delete template

Media

meta wa media upload ./photo.jpg --json      # Upload media
meta wa media url MEDIA_ID --json            # Get media URL
meta wa media download MEDIA_ID ./output.jpg # Download media

Analytics

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

Phone Number Management

meta wa phone list --json                    # List numbers
meta wa phone get --json                     # Get active number details
meta wa phone select PHONE_NUMBER_ID         # Select active number

Allowlist (Prompt Injection Protection)

meta wa allowlist list                       # List allowed numbers
meta wa allowlist add "[phone]"          # Add number
meta wa allowlist remove "[phone]"       # Remove number

When the allowlist is non-empty, meta wa send only delivers to listed numbers.

Instagram

# Publish image
meta ig publish --image "https://example.com/photo.jpg" --caption "My post" --json

# Publish video
meta ig publish --video "https://example.com/video.mp4" --caption "Watch this" --json

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

# Account insights
meta ig insights --period day --days 30 --json

# Media insights
meta ig insights --media-id MEDIA_ID --json

# Comments
meta ig comments list MEDIA_ID --json        # List comments
meta ig comments reply COMMENT_ID "Thanks!" --json  # Reply
meta ig comments hide COMMENT_ID --json      # Hide
meta ig comments delete COMMENT_ID --json    # Delete

Instagram publish requires a public URL for images/videos (not local files).

Facebook Pages

meta fb post --message "Hello from the CLI" --json           # Create post
meta fb post --message "Check this" --link "https://example.com" --json  # Link post
meta fb list --limit 10 --json                               # List posts
meta fb insights --period day --days 30 --json               # View insights

Messenger

meta messenger send PSID --text "Hello" --json               # Send text
meta messenger send PSID --image "https://example.com/photo.jpg" --json  # Send image
meta messenger send PSID --text "Update" --type MESSAGE_TAG --tag HUMAN_AGENT --json  # Outside 24h window
meta messenger receive --json                                # List conversations
meta messenger receive --conversation-id CONV_ID --json      # View conversation

Messenger messaging outside the 24h window requires a message tag.

Webhooks

# Start listener
meta webhook listen --port 3000 --verify-token TOKEN --app-secret SECRET

# Test verification locally
meta webhook verify --verify-token TOKEN --json

# Subscribe to events
meta webhook subscribe \
  --object whatsapp_business_account \
  --fields messages \
  --callback-url "https://example.com/webhook" --json

Set webhook.forwardUrl in config to POST inbound messages to an external service. The webhook auto-sends read receipts and acknowledges reactions for inbound messages.

Webhook Service (systemd)

meta service install                         # Install systemd user service
meta service start                           # Start the webhook service
meta service stop                            # Stop the service
meta service restart                         # Restart the service
meta service status                          # Show service status
meta service logs                            # Show service logs
meta service uninstall                       # Remove systemd service

Shell Completion

# Bash
meta completion >> ~/.bashrc

# Zsh (add to .zshrc)
meta completion >> ~/.zshrc

Diagnostics

meta doctor --json

Checks config, credentials, token validity, Graph API connectivity, permissions, and surface-specific asset access. Run before first use.

Global Flags

Flag	Description
--json	Structured output for scripting and agent use
--verbose	Print debug logs to stderr
--token TOKEN	Override stored credentials
--api-version v22.0	Pin a specific Graph API version

Notes

• Always use --json for structured output when automating.
• All commands work non-interactively when required args are passed as flags.
• Voice notes require OGG/Opus format to render correctly in WhatsApp.
• Files exceeding size limits are rejected with an actionable error.
• For larger files, host at a URL and pass the URL directly.