API
1MSG CLI: use a API pelo terminal
É uma nova maneira de usar WABA. Chame métodos do seu pipeline — um terminal, um trabalho de CI ou um servidor.
Nikita L ·
Você pode chamar a WhatsApp Business API a partir do bash, zsh ou de qualquer terminal que você usar — como git ou curl. Coloque esse comando no CI, cron ou em outro pipeline. É a mesma API que o SDK e o MCP.
Para que serve a CLI
CLI é uma interface de linha de comando: transforma os métodos HTTP da WhatsApp Business API em comandos que você executa em um terminal. Ele se comunica com a API através do 1MSG SDK e puxa @1msg/sdk como uma dependência — as mesmas requisições que você faria em código, invocadas como um comando.
Você executa 1msg com flags em vez de montar cada chamada HTTP você mesmo: URL, token, cabeçalhos, JSON, aspas. Host e token vêm da configuração ou variáveis de ambiente, então o comando permanece curto. Faça funcionar uma vez, depois reutilize a mesma linha. Você não reconstrói essa solicitação para cada chamada como faz com curl.
Esse mesmo comando é o que você executa em um terminal, adiciona como um passo de CI, coloca no cron ou usa via SSH em um servidor remoto. Interativo, em um pipeline, em um cronograma, em um computador que não é seu laptop — um cliente, não um novo curl para cada lugar.
HTTP, SDK, MCP, CLI: quando usar o que?
A API é HTTP: você chama 1MSG com requisições — qualquer linguagem, qualquer cliente, sem intermediário. Esse caminho está sempre presente e não compete com as ferramentas abaixo. O SDK, MCP e CLI se apoiam nela.
Entre esses três, a CLI é para trabalhar a partir do terminal. Como é um comando, você pode colocá-lo em um pipeline, construir automação em torno dele e chamar a API em um servidor remoto. Os agentes podem usá-la em vez do MCP quando você já sabe o que executar e quer economizar tokens.
Use o SDK ao construir uma integração. A API deve estar integrada à sua aplicação, na sua linguagem, no seu stack. Você chama métodos a partir do código porque o WhatsApp é parte do produto, e não um comando isolado.
Use MCP quando o trabalho passa por um agente de IA: você está projetando o fluxo no assistente, ou você não está escrevendo o código você mesmo. O agente conversa com a API por você.
Instale e configure o 1MSG CLI
Você precisa do Node.js 18 ou mais recente. Execute o pacote com npx ou instale o binário 1msg:
npx -y @1msg/cli --help
npm i -g @1msg/cliEntão execute 1msg init. Ele pede o seu id de instância e token e escreve uma configuração local, para que você não precise colar as credenciais em cada comando. Escolha live se estiver em um canal de produção, ou sandbox se quiser experimentar em um canal de teste gratuito.
Depois disso, execute 1msg status para verificar o canal. Para enviar uma mensagem, use 1msg send ou 1msg template send. Se você ainda não tiver um canal, crie um Canal de Teste no painel do 1MSG e execute init no sandbox.
Experimente a CLI no repositório do GitHub: instale, execute init, chame um comando.
