meta-businessSkill for the Meta Business CLI. Complete WhatsApp, Instagram, Facebook Pages, and Messenger automation via the Graph API. Supports messaging, media, templat...
Install via ClawdBot CLI:
clawdbot install adolago/meta-businessUse meta for WhatsApp, Instagram, Facebook Pages, and Messenger automation via the Graph API.
# 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 doctorOr use --token YOUR_TOKEN with any command to skip OAuth (e.g. System User tokens).
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 credentialsmeta 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 valuesConfig stored at ~/.meta-cli/config.json.
# Text
meta wa send "+1234567890" --text "Hello" --json
# Markdown (converts to WhatsApp formatting)
meta wa send "+1234567890" --text "**bold** and _italic_" --markdown --json
# Chunked (splits long text into multiple messages)
meta wa send "+1234567890" --text "very long message..." --chunk --json
# Image
meta wa send "+1234567890" --image "https://example.com/photo.jpg" --caption "Look" --json
# Video
meta wa send "+1234567890" --video "https://example.com/video.mp4" --caption "Watch" --json
# Document
meta wa send "+1234567890" --document "https://example.com/file.pdf" --json
# Local file (auto-uploads)
meta wa send "+1234567890" --document ./report.pdf --caption "Q4 report" --json
# Audio
meta wa send "+1234567890" --audio "https://example.com/note.ogg" --json
# Voice note (renders as playable voice note, requires OGG/Opus)
meta wa send "+1234567890" --audio "./recording.ogg" --voice --json
# Template
meta wa send "+1234567890" --template "hello_world" --template-lang en_US --json
# Mark as read
meta wa read WAMID --json| Type | Max Size |
|------|----------|
| Image | 5 MB |
| Video | 16 MB |
| Document | 100 MB |
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 templatemeta 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 mediameta wa analytics --days 30 --granularity DAY --jsonmeta wa phone list --json # List numbers
meta wa phone get --json # Get active number details
meta wa phone select PHONE_NUMBER_ID # Select active numbermeta wa allowlist list # List allowed numbers
meta wa allowlist add "+1234567890" # Add number
meta wa allowlist remove "+1234567890" # Remove numberWhen the allowlist is non-empty, meta wa send only delivers to listed numbers.
# 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 # DeleteInstagram publish requires a public URL for images/videos (not local files).
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 insightsmeta 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 conversationMessenger messaging outside the 24h window requires a message tag.
# 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" --jsonSet webhook.forwardUrl in config to POST inbound messages to an external service.
The webhook auto-sends read receipts and acknowledges reactions for inbound messages.
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# Bash
meta completion >> ~/.bashrc
# Zsh (add to .zshrc)
meta completion >> ~/.zshrcmeta doctor --jsonChecks config, credentials, token validity, Graph API connectivity, permissions, and surface-specific asset access. Run before first use.
| 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 |
--json for structured output when automating.Generated Mar 1, 2026
Businesses can automate responses to common customer inquiries on WhatsApp and Messenger, using templates for quick replies and sending documents like invoices or guides. This reduces response time and frees up human agents for complex issues, improving overall customer satisfaction.
Marketing teams can schedule and publish posts, reels, and videos across Instagram and Facebook Pages directly from the CLI, while tracking engagement metrics through analytics. This streamlines content distribution and performance monitoring, enabling data-driven marketing decisions.
Companies can send automated order confirmations, shipping updates, and appointment reminders via WhatsApp using pre-approved templates, ensuring timely and reliable communication with customers. This enhances operational efficiency and reduces manual notification efforts.
Sales teams can use the CLI to send personalized messages and media to potential leads on WhatsApp and Instagram, with analytics to track engagement and allowlist features to manage outreach lists. This automates initial contact and follow-ups, increasing conversion rates.
Social media managers can monitor and moderate comments on Instagram posts, hiding or deleting inappropriate content and replying to user queries automatically. This helps maintain brand reputation and fosters positive community interactions with minimal manual intervention.
Offer a subscription-based service where businesses pay monthly fees to access the CLI for automating their Meta platform communications, with tiered pricing based on usage volume and features like analytics. Revenue is generated through recurring subscriptions and potential add-ons for premium support.
Marketing or customer support agencies use the CLI to manage client accounts on Meta platforms, charging per campaign or on a retainer basis for services like automated messaging, social media posting, and analytics reporting. Revenue comes from service fees and performance-based bonuses.
Freelancers provide setup, configuration, and ongoing maintenance services for businesses using the CLI, offering one-time setup fees and hourly rates for custom automation scripts and troubleshooting. Revenue is generated through project-based payments and ongoing support contracts.
💬 Integration Tip
Integrate with existing CRM or marketing tools by using webhooks to forward inbound messages and automate responses, ensuring seamless data flow and enhanced automation capabilities.
Fetch and read transcripts from YouTube videos. Use when you need to summarize a video, answer questions about its content, or extract information from it.
Fetch and summarize YouTube video transcripts. Use when asked to summarize, transcribe, or extract content from YouTube videos. Handles transcript fetching via residential IP proxy to bypass YouTube's cloud IP blocks.
Browse, search, post, and moderate Reddit. Read-only works without auth; posting/moderation requires OAuth setup.
Interact with Twitter/X — read tweets, search, post, like, retweet, and manage your timeline.
LinkedIn automation via browser relay or cookies for messaging, profile viewing, and network actions.
Search YouTube videos, get channel info, fetch video details and transcripts using YouTube Data API v3 via MCP server or yt-dlp fallback.