Comando hermes whatsapp-cloud — Referencia Completa y Ejemplos

Resumen

hermes whatsapp-cloud configura el adaptador oficial de Meta WhatsApp Business Cloud API. A diferencia de hermes whatsapp — el puente Baileys para cuentas personales — este usa la Cloud API alojada por Meta y requiere una cuenta Business y una URL de webhook pública. Es un asistente interactivo: no tiene subcomandos.

hermes whatsapp-cloud

Requiere un TTY: el asistente solicita datos de forma interactiva.

Qué cubre el asistente

Credenciales de Meta — Phone Number ID, Access Token y App Secret, además de los IDs opcionales de App y WABA (WhatsApp Business Account).
Configuración del webhook — configura el endpoint que Meta usa para entregar los mensajes entrantes.
Validación — los validadores de formato de campos detectan errores comunes, como pegar un número de teléfono en el campo Phone Number ID.

Requisitos previos

Una cuenta Business de Meta con un número de teléfono de WhatsApp Business
Una URL de webhook pública accesible desde internet
Una app de Meta con el producto WhatsApp habilitado

Ejemplos

hermes whatsapp-cloud
# El asistente interactivo solicita:
#   - Phone Number ID
#   - Access Token
#   - App Secret
#   - IDs opcionales de App / WABA
#   - Configuración del webhook

# Verifica la conectividad tras la configuración
hermes status

Consejos

Los dos adaptadores de WhatsApp son complementarios, no alternativos: hermes whatsapp vincula una cuenta personal con código QR; hermes whatsapp-cloud usa la API oficial de Meta Business Cloud para cargas de producción.
Se requiere una URL de webhook pública accesible desde internet — para pruebas locales, expón tu servidor con un túnel.
Las credenciales se validan mientras las introduces, así que errores como un teléfono mal colocado se detectan al instante.