Commande hermes whatsapp-cloud — Référence Complète et Exemples

Vue d’ensemble

hermes whatsapp-cloud configure l’adaptateur officiel de l’API Meta WhatsApp Business Cloud. Contrairement à hermes whatsapp — le pont Baileys pour les comptes personnels — il utilise l’API Cloud hébergée par Meta et exige un compte Business et une URL de webhook publique. C’est un assistant interactif : il n’y a pas de sous-commandes.

hermes whatsapp-cloud

Nécessite un TTY : l’assistant demande des saisies de façon interactive.

Ce que couvre l’assistant

Identifiants Meta — Phone Number ID, Access Token et App Secret, plus les ID facultatifs d’App et de WABA (WhatsApp Business Account).
Configuration du webhook — configurer l’endpoint que Meta utilise pour livrer les messages entrants.
Validation — des validateurs de format de champs détectent les erreurs de configuration courantes, comme coller un numéro de téléphone dans le champ Phone Number ID.

Prérequis

Un compte Business Meta avec un numéro de téléphone WhatsApp Business
Une URL de webhook publique accessible depuis Internet
Une app Meta avec le produit WhatsApp activé

Exemples

hermes whatsapp-cloud
# L'assistant interactif demande :
#   - Phone Number ID
#   - Access Token
#   - App Secret
#   - ID facultatifs App / WABA
#   - Configuration du webhook

# Vérifier la connectivité après la configuration
hermes status

Conseils

Les deux adaptateurs WhatsApp sont complémentaires, pas alternatifs : hermes whatsapp apparie un compte personnel via un code QR ; hermes whatsapp-cloud utilise l’API officielle Meta Business Cloud pour les charges de production.
Une URL de webhook publique, accessible depuis Internet, est requise — pour les tests locaux, exposez votre serveur via un tunnel.
Les identifiants sont validés à la saisie, donc une faute de frappe comme un numéro de téléphone mal placé est détectée immédiatement.