API
1MSG CLI: usa la API desde la línea de comandos
Es una nueva forma de usar WABA. Ejecuta métodos desde tu pipeline: un terminal, un job de CI o un servidor.
Nikita L ·
Puedes llamar a la API de WhatsApp Business desde bash, zsh o cualquier terminal que uses — como git o curl. Pon ese comando en CI, cron u otro pipeline. Es la misma API que el SDK y MCP.
¿Para qué sirve la CLI?
CLI es una interfaz de línea de comandos: convierte los métodos HTTP de la API de WhatsApp Business en comandos que ejecutas en un terminal. Se comunica con la API a través del SDK de 1MSG e incluye @1msg/sdk como dependencia — las mismas peticiones que harías en código, ejecutadas como comando.
Ejecutas 1msg con flags en lugar de armar cada llamada HTTP a mano: URL, token, encabezados, JSON, entrecomillado. El host y el token salen de la configuración o de variables de entorno, así que el comando se queda corto. Hazlo funcionar una vez y reutiliza la misma línea. No vuelves a montar esa petición en cada llamada, como con curl.
Ese mismo comando es el que ejecutas en una terminal, añades como paso de CI, pones en cron o usas por SSH en un servidor remoto. En interactivo, en un pipeline, programado, en una máquina sin tu portátil — un cliente, no un curl nuevo para cada sitio.
HTTP, SDK, MCP, CLI: ¿cuándo usar qué?
La API es HTTP: llamas a 1MSG con peticiones — cualquier lenguaje, cualquier cliente, sin capa extra. Ese camino siempre está y no compite con las herramientas siguientes. El SDK, MCP y CLI se apoyan todos en ella.
Entre esos tres, la CLI es para trabajar desde el terminal. Como es un comando, puedes meterlo en un pipeline, montar automatización a partir de él y llamar a la API en un servidor remoto. Los agentes pueden usarla en lugar de MCP cuando ya sabes qué ejecutar y quieres ahorrar tokens.
Usa el SDK cuando estés construyendo una integración. La API tiene que estar en tu aplicación, en tu lenguaje, en tu stack. Llamas a los métodos desde el código porque WhatsApp forma parte del producto, no es una llamada puntual.
Usa MCP cuando el trabajo pasa por un agente de IA: diseñas el flujo en el asistente o no escribes el código tú. El agente habla con la API por ti.
Instala y configura 1MSG CLI
Necesitas Node.js 18 o más reciente. Ejecuta el paquete con npx, o instala el binario 1msg:
npx -y @1msg/cli --help
npm i -g @1msg/cliLuego ejecuta 1msg init. Te pedirá el id de instancia y el token y escribirá una configuración local, para no pegar credenciales en cada comando. Elige live si estás en un canal de producción, o sandbox si quieres probarlo en un canal de prueba gratuito.
Después ejecuta 1msg status para comprobar el canal. Para enviar un mensaje, usa 1msg send o 1msg template send. Si aún no tienes un canal, crea un canal de prueba en el panel de 1MSG y ejecuta init en sandbox.
Prueba la CLI en el repositorio de GitHub: instala, ejecuta init, ejecuta un comando.
