Una mano interactúa con una representación digital del logo de WhatsApp en una pantalla con código fuente de fondo
Automatiza tus mensajes de WhatsApp. ¡Descubre cómo hacerlo desde tu terminal!
Android
·5 Minutos de lectura

Enviar un Mensaje de WhatsApp desde la Línea de Comandos (Shell)

Puedes usar el cliente de consola Mudslide para enviar mensajes a WhatsApp directamente desde la línea de comandos o un script en Windows, Mac, o Linux. Los operadores de sistemas (sysops) lo utilizan frecuentemente para enviar notificaciones a WhatsApp desde scripts de shell, sistemas de monitoreo, y otros escenarios de automatización.

El proyecto Mudslide (https://github.com/robvanderleek/mudslide) está basado en la librería de código abierto Baileys, una API no oficial para interactuar con WhatsApp mediante WebSockets. Este artículo explica cómo instalar y usar Mudslide en Windows, Mac, y Linux para enviar mensajes desde la terminal o scripts.

Advertencia: Mudslide utiliza Baileys, una librería no oficial. El uso de APIs no oficiales puede violar los términos de servicio de WhatsApp y, en casos raros, resultar en la suspensión de la cuenta. Úsalo bajo tu propio riesgo.

Tabla de Contenido

Requisitos Previos

Mudslide requiere Node.js (con el gestor de paquetes npm) instalado. Opcionalmente, Git es necesario si descargas el código fuente o binarios desde GitHub. A continuación, los pasos para instalar estos requisitos en cada sistema operativo:

Windows

  • Node.js: Descarga e instala desde https://nodejs.org (elige la versión recomendada).
  • Git: Instala desde https://git-scm.com/download/win o con WinGet:
winget install --id Git.Git -e --source winget

Mac

  • Node.js: Instala usando Homebrew (recomendado) o descarga desde https://nodejs.org:
brew install node

Verifica la instalación:

node -v
npm -v
  • Git: Viene preinstalado en macOS, pero puedes actualizarlo con Homebrew:
brew install git

Linux

Node.js: Instala según tu distribución:

Ubuntu/Debian:

sudo apt update sudo apt install -y nodejs npm

O usa nvm (Node Version Manager) para mayor control:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash nvm install node

CentOS/RHEL:

sudo dnf install -y nodejs

Git:

Ubuntu/Debian:

sudo apt install -y git

CentOS/RHEL:

sudo dnf install -y git

Instalar Mudslide

Instala Mudslide globalmente con npm (funciona igual en Windows, Mac, y Linux):

npm install -g mudslide
Captura de pantalla de una terminal macOS mostrando los comandos npm install -g mudslide y npx mudslide -v para instalar y verificar la versión de Mudslide.
Instala Mudslide en tu Mac fácilmente con estos sencillos comandos. Simplifica la gestión de WhatsApp desde tu terminal.

Si prefieres usar un binario compilado (sin instalar Node.js), puedes descargarlo desde las releases de GitHub (https://github.com/robvanderleek/mudslide/releases).

Autenticación

Mudslide debe autenticarse como un dispositivo adicional en tu cuenta de WhatsApp. Ejecuta:

npx mudslide login
Código QR mostrado en una terminal macOS tras una conexión exitosa de WhatsApp con Mudslide. Mensaje de "Conexión exitosa".
¡Conexión exitosa! Así se ve la pantalla de tu terminal después de conectar WhatsApp con Mudslide en macOS.

Escanea el código QR que aparece en la terminal desde WhatsApp en tu teléfono (Ajustes -> Dispositivos Vinculados -> Vincular un dispositivo). Si la autenticación es exitosa, verás:

Success: Logged in

Comandos de Mudslide

Usa npx mudslide para ejecutar Mudslide (o simplemente mudslide si usas el binario). Lista las opciones disponibles:

npx mudslide --help
Captura de pantalla de una terminal mostrando la ayuda (--help) del comando mudslide, listando las opciones y comandos disponibles.
Consulta esta guía de referencia rápida para dominar los comandos y opciones de Mudslide y controlar WhatsApp desde tu terminal.

Enviar un mensaje

(En caso no ejecute el comando, intenta con mudslide@latest en lugar de mudslide)

  • A tu propio número:
npx mudslide send me "Hola Esgeeks"
  • A un número específico (usa el formato internacional con código de país, por ejemplo, +51):
npx mudslide send +519277XX1X8 "Hola Esgeeks"
  • Con saltos de línea:
npx mudslide send +519277XX1X8 "Hola\nEsgeeks"
Captura de pantalla de una terminal mostrando el envío de mensajes de WhatsApp usando el comando mudslide send en macOS.
Automatiza tus mensajes de WhatsApp. Aprende a enviar mensajes, archivos, y más desde tu terminal con Mudslide.
Captura de pantalla de la aplicación WhatsApp mostrando mensajes enviados desde la terminal usando Mudslide.
¡Funciona! Confirma el correcto funcionamiento de Mudslide con esta comprobación de mensajes enviados y recibidos a través de WhatsApp.

Enviar a un grupo

  • Obtén los IDs de tus grupos:
npx mudslide groups
  • Envía un mensaje a un grupo (usa el ID, por ejemplo, 12345678910-987654321@g.us):
npx mudslide send-group 12345678910-987654321@g.us "Hola Grupo"

Enviar archivos

  • Imagen (formatos PNG, JPG, GIF):
npx mudslide send-image +5499XX654XX188 /ruta/a/imagen.jpg
  • En Windows, usa la ruta con formato Windows (por ejemplo, C:\src\image.jpg).
  • En Mac/Linux, usa rutas absolutas o relativas (por ejemplo, /home/user/image.jpg).
  • Archivo (por ejemplo, PDF):
npx mudslide send-file +549XX3654XX188 /ruta/al/archivo.pdf

Enviar una ubicación

  • Coordenadas GPS:
npx mudslide send-location me 48.153731 11.564668

Comprobar estado de autenticación

  • Verifica si estás autenticado:
npx mudslide me

Cerrar sesión

  • Elimina el token y cookies de WhatsApp:
npx mudslide logout

Consideraciones

  • Rutas de archivos: Asegúrate de usar rutas correctas según el sistema operativo:
  • Windows: C:\ruta\al\archivo
  • Mac/Linux: /ruta/al/archivo
  • Terminales: En Mac, usa Terminal o iTerm2. En Linux, usa cualquier terminal (por ejemplo, GNOME Terminal, Konsole). En Windows, usa PowerShell, Command Prompt, o WSL.
  • Binarios compilados: Si usas binarios en Mac o Linux, verifica la compatibilidad con tu arquitectura (x64, ARM, etc.) en las releases de GitHub.
  • PowerShell en Windows: Los comandos con \n funcionan, pero usa comillas dobles (") para mensajes con caracteres especiales.

Si Mudslide no da ninguna salida o no se comporta como se espera, intenta eliminar la carpeta de caché local, luego desconecta el cliente usando tu aplicación móvil de WhatsApp e inicia sesión de nuevo.

Para ver lo que sucede con más detalle, la verbosidad de Mudslide se puede aumentar con la opción global -v. Usa -vvv para el mayor nivel de detalle:

npx mudslide@latest -vvv me

Mi Carro Close (×)

Tu carrito está vacío
Ver tienda