Comando hermes whatsapp — Referencia Completa y Ejemplos

Resumen

hermes whatsapp configura el puente de WhatsApp (Baileys) y lo vincula con tu cuenta de WhatsApp mediante un código QR. Es un asistente interactivo — no tiene subcomandos. El asistente te guía para elegir un modo, configurar los usuarios permitidos, instalar las dependencias del puente y escanear un código QR. Una vez vinculado, puedes chatear con Hermes a través de WhatsApp como con cualquier otro contacto.

hermes whatsapp

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

Qué hace el asistente

1. Elegir un modo — un número de bot separado (recomendado) o tu número personal (self-chat).
2. Configurar usuarios permitidos — los números de teléfono autorizados para escribir al agente (separados por comas, o * para cualquiera).
3. Instalar dependencias del puente — ejecuta npm install en el directorio del puente la primera vez (puede tardar unos minutos).
4. Comprobar una sesión existente — si creds.json ya existe, conserva el vínculo actual o vuelve a vincular.
5. Vincular con código QR — abre WhatsApp (o WhatsApp Business) en el teléfono con el número del bot, ve a Dispositivos vinculados y escanea el código QR del terminal.
6. Iniciar el gateway — una vez vinculado, ejecuta hermes gateway para recibir mensajes.

Ejemplos

hermes whatsapp
# 1. Elige modo: 1) número de bot separado (recomendado)  2) número personal (self-chat)
# 2. Introduce los números permitidos (separados por comas, o * para cualquiera)
# 3. Las dependencias del puente se instalan automáticamente
# 4. Escanea el QR con WhatsApp → Dispositivos vinculados → Vincular un dispositivo
# 5. Inicia el gateway: hermes gateway

# Reejecutar el asistente con una sesión existente
hermes whatsapp
# ✓ Sesión de WhatsApp existente — ¿Volver a vincular? [y/N]
# Responde 'n' para conservar el vínculo actual, 'y' para borrarlo y escanear un nuevo QR

Consejos

• WhatsApp solo se habilita tras un vínculo correcto. Si abortas el asistente antes de tiempo, el puente permanece desactivado y el gateway no intentará iniciarlo.
• La sesión (creds.json) se guarda en ~/.hermes/whatsapp/session/ — haz una copia de seguridad para evitar volver a vincular.
• Para un bot de producción con la API oficial de Meta, usa hermes whatsapp-cloud — los dos adaptadores son complementarios, no alternativos.