hermes whatsapp-cloud Command — Complete Reference & Examples

Overview

hermes whatsapp-cloud configures the official Meta WhatsApp Business Cloud API adapter. Unlike hermes whatsapp — the Baileys bridge for personal accounts — this uses Meta’s hosted Cloud API and requires a Business account and a public webhook URL. It is an interactive wizard: there are no subcommands.

hermes whatsapp-cloud

Requires a TTY: the wizard prompts interactively.

What the Wizard Walks Through

1. Meta credentials — Phone Number ID, Access Token, and App Secret, plus optional App and WABA (WhatsApp Business Account) IDs.
2. Webhook configuration — set up the endpoint Meta uses to deliver incoming messages.
3. Validation — field-shape validators catch common setup mistakes, such as pasting a phone number into the Phone Number ID field.

Prerequisites

• A Meta Business account with a WhatsApp Business phone number
• A public webhook URL reachable from the internet
• A Meta app with the WhatsApp product enabled

Examples

hermes whatsapp-cloud
# The interactive wizard prompts for:
#   - Phone Number ID
#   - Access Token
#   - App Secret
#   - Optional App / WABA IDs
#   - Webhook configuration

# Verify connectivity after setup
hermes status

Tips

• The two WhatsApp adapters are complementary, not alternatives: hermes whatsapp pairs a personal account via QR code; hermes whatsapp-cloud uses the official Meta Business Cloud API for production workloads.
• A public, internet-reachable webhook URL is required — for local testing, expose your server with a tunnel.
• Credentials are validated as you enter them, so typos such as a misplaced phone number are caught immediately.