CLI

npm install -g @gethookmyapp/cli

hookmyapp login
hookmyapp logout

# List workspaces
hookmyapp workspace list

# Switch active workspace
hookmyapp workspace use acme

# Show active workspace
hookmyapp workspace current

# Connect a Page (opens the dashboard picker and waits for the new channel)
hookmyapp channels connect facebook

# List connected channels
hookmyapp channels list

# Show channel details, including the Page id
hookmyapp channels show ch_xxxxxxxx

# Enable forwarding
hookmyapp channels enable ch_xxxxxxxx

# Disable forwarding
hookmyapp channels disable ch_xxxxxxxx

# Disconnect channel
hookmyapp channels disconnect ch_xxxxxxxx

# Print channel token
hookmyapp channels token ch_xxxxxxxx

# Health check: webhook and channel status
hookmyapp channels health ch_xxxxxxxx

# Send text
hookmyapp facebook messages send --channel ch_xxxxxxxx --to <psid> --text "hi"

# Send outside the 24-hour window with a tag
hookmyapp facebook messages send --channel ch_xxxxxxxx --to <psid> --text "Your order shipped" --tag POST_PURCHASE_UPDATE

# Send a complete body verbatim
hookmyapp facebook messages send --channel ch_xxxxxxxx --body @msg.json

# Mark a thread as seen
hookmyapp facebook messages read --channel ch_xxxxxxxx --to <psid>

# Threads, most recently updated first
hookmyapp facebook threads --channel ch_xxxxxxxx --limit 25

# The messages in one thread
hookmyapp facebook threads --channel ch_xxxxxxxx --thread <thread-id> --after <cursor>

# List posts
hookmyapp facebook posts --channel ch_xxxxxxxx

# Publish text, link, photo, video or reel
hookmyapp facebook publish --channel ch_xxxxxxxx --message "We are open today"
hookmyapp facebook publish --channel ch_xxxxxxxx --link https://example.com/new --message "New this week"
hookmyapp facebook publish --channel ch_xxxxxxxx --photo https://example.com/photo.jpg --message "New drop"
hookmyapp facebook publish --channel ch_xxxxxxxx --video https://example.com/clip.mp4 --description "Behind the scenes"
hookmyapp facebook publish --channel ch_xxxxxxxx --reel https://example.com/clip.mp4 --description "Behind the scenes"

# Delete a post
hookmyapp facebook delete-post --channel ch_xxxxxxxx --post <page-id>_<post-id>

# List comments on a post
hookmyapp facebook comments list --channel ch_xxxxxxxx --post <page-id>_<post-id>

# Reply publicly
hookmyapp facebook comments reply --channel ch_xxxxxxxx --comment <comment-id> --message "Thanks!"

# Reply privately over Messenger
hookmyapp facebook comments private-reply --channel ch_xxxxxxxx --comment <comment-id> --message "Sent you a DM"

# Hide, unhide, delete
hookmyapp facebook comments hide --channel ch_xxxxxxxx --comment <comment-id>
hookmyapp facebook comments unhide --channel ch_xxxxxxxx --comment <comment-id>
hookmyapp facebook comments delete --channel ch_xxxxxxxx --comment <comment-id>

# Page insights, default metrics, per day
hookmyapp facebook insights --channel ch_xxxxxxxx

# Chosen metrics, per week
hookmyapp facebook insights --channel ch_xxxxxxxx --metric page_follows page_views_total --period week

# One post
hookmyapp facebook insights --channel ch_xxxxxxxx --post <page-id>_<post-id>

# Page profile: name, category, followers, link
hookmyapp facebook profile --channel ch_xxxxxxxx

# Listen on your laptop
hookmyapp channels listen ch_xxxxxxxx --path /webhook/facebook

# Set deployed webhook URL
hookmyapp channels webhook set ch_xxxxxxxx \
  --url https://api.acme.com/facebook/webhook \
  --verify-token $(openssl rand -hex 32)

# Show webhook URL
hookmyapp channels webhook show ch_xxxxxxxx

# Clear webhook URL
hookmyapp channels webhook clear ch_xxxxxxxx

# Show the HMAC signing secret (used to verify X-HookMyApp-Signature-256)
hookmyapp channels webhook hmac show ch_xxxxxxxx

# List delivery history
hookmyapp channels logs list ch_xxxxxxxx

# Show delivery details
hookmyapp channels logs show <delivery-id>

# Start Facebook sandbox
hookmyapp sandbox start facebook

# List sandbox sessions
hookmyapp sandbox status

# Write sandbox env values
hookmyapp sandbox env --session ssn_xxxxxxxx --write .env

# Listen for sandbox messages
hookmyapp sandbox listen --session ssn_xxxxxxxx --path /webhook/facebook

# Send sandbox test message
hookmyapp sandbox send --session ssn_xxxxxxxx --message "hello from my app"

# List sandbox deliveries
hookmyapp sandbox logs --session ssn_xxxxxxxx

# Stop sandbox session
hookmyapp sandbox stop --session ssn_xxxxxxxx

hookmyapp customers onboarding-links create --label "Acme Facebook" --channel-type facebook