Comando hermes whatsapp-cloud — Referência Completa e Exemplos

Visão Geral

hermes whatsapp-cloud configura o adaptador oficial da Meta WhatsApp Business Cloud API. Diferente do hermes whatsapp — a ponte Baileys para contas pessoais — este usa a Cloud API hospedada pela Meta e exige uma conta Business e uma URL de webhook pública. É um assistente interativo: não há subcomandos.

hermes whatsapp-cloud

Requer um TTY: o assistente solicita entradas de forma interativa.

O que o assistente aborda

Credenciais da Meta — Phone Number ID, Access Token e App Secret, além dos IDs opcionais de App e WABA (WhatsApp Business Account).
Configuração do webhook — configure o endpoint que a Meta usa para entregar mensagens recebidas.
Validação — validadores de formato de campos detectam erros comuns de configuração, como colar um número de telefone no campo Phone Number ID.

Pré-requisitos

Uma conta Business da Meta com um número de telefone do WhatsApp Business
Uma URL de webhook pública acessível pela internet
Um app da Meta com o produto WhatsApp habilitado

Exemplos

hermes whatsapp-cloud
# O assistente interativo solicita:
#   - Phone Number ID
#   - Access Token
#   - App Secret
#   - IDs opcionais de App / WABA
#   - Configuração do webhook

# Verifique a conectividade após a configuração
hermes status

Dicas

Os dois adaptadores do WhatsApp são complementares, não alternativos: hermes whatsapp pareia uma conta pessoal via código QR; hermes whatsapp-cloud usa a API oficial da Meta Business Cloud para cargas de produção.
É necessária uma URL de webhook pública e acessível pela internet — para testes locais, exponha seu servidor com um túnel.
As credenciais são validadas durante a digitação, então erros como um número de telefone no campo errado são detectados imediatamente.