Commande hermes whatsapp — Référence Complète & Exemples

Vue d’ensemble

hermes whatsapp configure le pont WhatsApp (Baileys) et l’appaire à votre compte WhatsApp via un code QR. C’est un assistant interactif — il n’y a pas de sous-commandes. L’assistant vous guide dans le choix du mode, la configuration des utilisateurs autorisés, l’installation des dépendances du pont et le scan d’un code QR. Une fois appairé, vous pouvez discuter avec Hermes via WhatsApp comme avec n’importe quel autre contact.

hermes whatsapp

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

Ce que fait l’assistant

1. Choisir un mode — un numéro de bot séparé (recommandé) ou votre numéro personnel (self-chat).
2. Définir les utilisateurs autorisés — les numéros de téléphone autorisés à écrire à l’agent (séparés par des virgules, ou * pour tout le monde).
3. Installer les dépendances du pont — exécute npm install dans le répertoire du pont la première fois (cela peut prendre quelques minutes).
4. Vérifier une session existante — si creds.json existe déjà, conserver l’appairage actuel ou ré-appairer.
5. Appairer via un code QR — ouvrir WhatsApp (ou WhatsApp Business) sur le téléphone avec le numéro du bot, aller dans Appareils liés et scanner le code QR affiché dans le terminal.
6. Démarrer le gateway — une fois appairé, exécutez hermes gateway pour recevoir des messages.

Exemples

hermes whatsapp
# 1. Choisir le mode : 1) numéro de bot séparé (recommandé)  2) numéro personnel (self-chat)
# 2. Saisir les numéros autorisés (séparés par des virgules, ou * pour tout le monde)
# 3. Les dépendances du pont s'installent automatiquement
# 4. Scanner le QR avec WhatsApp → Appareils liés → Lier un appareil
# 5. Démarrer le gateway : hermes gateway

# Réexécuter l'assistant avec une session existante
hermes whatsapp
# ✓ Session WhatsApp existante trouvée — Ré-appairer ? [y/N]
# Répondez 'n' pour conserver l'appairage actuel, 'y' pour le supprimer et scanner un nouveau QR

Conseils

• WhatsApp n’est activé qu’après un appairage réussi. Si vous abandonnez l’assistant en cours de route, le pont reste désactivé et le gateway ne tentera pas de le démarrer.
• La session (creds.json) est stockée sous ~/.hermes/whatsapp/session/ — sauvegardez-la pour éviter de ré-appairer.
• Pour un bot de production sur l’API officielle de Meta, utilisez hermes whatsapp-cloud — les deux adaptateurs sont complémentaires, pas alternatifs.