Blu CLI: envie mensagens e campanhas de WhatsApp direto do terminal

Se você vive no terminal, sabe a dor: toda vez que precisa mandar um aviso para um cliente, um alerta para a equipe ou uma campanha para uma lista, tem que sair do fluxo, abrir o celular ou o navegador e clicar em meia dúzia de telas.

O Blu CLI resolve isso. É a linha de comando oficial do Blu: você conecta seu número pelo QR code uma vez e depois faz tudo por comandos. Enviar mensagem, criar campanha, ler conversas, aquecer chip. Funciona em scripts, em cron, em pipelines de CI e, principalmente, dentro de agentes de código como Claude Code, Codex e Gemini CLI.

Instalação em 30 segundos

npm install -g @blu/cli
blu login

O comando blu login abre o navegador para você entrar na sua conta do Blu. Se o número ainda não estiver conectado, ele mostra o QR code direto no terminal:

blu connect
# Escaneie o QR code abaixo com o WhatsApp do número que deseja conectar
# ▄▄▄▄▄▄▄ ▄▄ ▄ ▄▄▄▄▄▄▄
# █ ▄▄▄ █ ▀▄▀▄ █ ▄▄▄ █
# ...
# ✔ Número +55 11 99999-0000 conectado

Pronto. Não precisa de API oficial da Meta, de aprovação de template nem de servidor rodando na sua máquina. O número fica conectado na infraestrutura do Blu e o CLI só fala com ela.

Os comandos que você vai usar todo dia

Enviar uma mensagem

blu send 5511999990000 "Oi João, seu pedido sai amanhã pela manhã."

Com mídia:

blu send 5511999990000 --file ./boleto.pdf --caption "Segue o boleto de setembro"

Enviar para vários contatos

blu send --to-file ./numeros.txt "Lembrete: reunião hoje às 15h"

O CLI aplica automaticamente o intervalo seguro entre envios que o Blu usa no painel, para não colocar seu número em risco.

Criar e disparar uma campanha

blu campaign create \
  --name "Renovação setembro" \
  --contacts ./clientes.csv \
  --message "Oi {{nome}}, sua renovação vence em {{vencimento}}. Renove com 15% de desconto: {{link}}" \
  --schedule "2026-09-15 09:00"

As colunas do CSV viram variáveis na mensagem. O comando devolve o ID da campanha e você acompanha com:

blu campaign status ren-set-2026
# Enviadas: 412 / 500   Entregues: 398   Lidas: 271   Respostas: 34

Ler conversas

blu chats --unread
blu chat 5511999990000 --last 20

Saída em JSON para encaixar no jq ou em qualquer script:

blu chats --unread --json | jq '.[] | .name'

Aquecer um chip novo

blu warmup start 5511988880000
blu warmup status 5511988880000

O mesmo aquecimento de chip do Blu que você já conhece, sem sair do terminal.

Gerenciar agentes de IA

blu agents list
blu agents attach suporte-n1 --number 5511999990000

Liga e desliga os agentes de atendimento do Blu em um comando.

O CLI é feito para agentes de código

Esse é o motivo pelo qual construímos o Blu CLI agora. Ferramentas como Claude Code, Codex, Gemini CLI e Cursor já sabem usar qualquer programa de linha de comando. Basta o CLI estar instalado e ter uma boa ajuda embutida, e o agente aprende sozinho.

Na prática, você abre o Claude Code e escreve:

"Pega os clientes que compraram nos últimos 7 dias no banco, monta uma mensagem de agradecimento personalizada e envia pelo blu com intervalo de 40 segundos."

O agente roda a query, escreve o CSV, chama blu campaign create e te mostra o resultado. Sem integração, sem SDK, sem código de cola.

Para isso funcionar bem, o CLI tem:

• blu --help e blu <comando> --help detalhados, com exemplos.
• Saída --json em todos os comandos.
• Códigos de saída previsíveis: 0 sucesso, 1 erro de uso, 2 erro de rede, 3 número desconectado.
• Modo --dry-run para o agente mostrar o que faria antes de enviar.
• Um arquivo AGENTS.md gerado por blu init com instruções para o agente do seu projeto.

Automação com cron e CI

Relatório diário de conversas não respondidas, todo dia às 8h:

0 8 * * * blu chats --unread --json | ./gera-relatorio.sh | blu send 5511977770000 --stdin

Aviso no WhatsApp da equipe quando o deploy quebra:

# .github/workflows/deploy.yml
- name: Avisar time no WhatsApp
  if: failure()
  run: blu send --group "Time Dev" "Deploy de produção falhou: ${{ github.run_url }}"
  env:
    BLU_TOKEN: ${{ secrets.BLU_TOKEN }}

Em ambientes sem navegador, use um token gerado no painel em vez do blu login:

export BLU_TOKEN=blu_live_xxxxxxxxxxxx

Segurança

• Tokens com escopo. Um token pode ser só leitura, só envio individual ou completo. Use o mínimo necessário em cada máquina.
• Limites herdados. O CLI respeita os mesmos limites de volume e intervalo do seu plano. Não tem flag para desligar.
• Confirmação em massa. Qualquer comando que envie para mais de 20 contatos pede confirmação, a menos que você passe --yes. Útil para não deixar um agente disparar sem querer.
• Histórico. Tudo que sai pelo CLI aparece no histórico do painel, marcado como origem "CLI".

CLI, MCP ou API?

Os três usam o mesmo número conectado pelo QR code e o mesmo painel.

Quanto custa

O Blu CLI está incluído em todos os planos pagos, sem custo adicional por mensagem. Os limites são os do seu plano.

Como começar

Estamos liberando o Blu CLI em ondas para quem pedir acesso:

Quero acesso ao Blu CLI →

Perguntas frequentes

Funciona no Windows?
Sim. Windows, macOS e Linux. Precisa de Node 20 ou superior.

Preciso deixar o computador ligado para a campanha sair?
Não. O CLI só cria a campanha; quem envia é a infraestrutura do Blu. Pode fechar o terminal.

Posso usar o número da empresa e o meu pessoal na mesma máquina?
Sim. Use blu use <numero> para trocar o número padrão ou passe --from <numero> em qualquer comando.

Corre risco de bloqueio?
O mesmo do envio pelo painel. O CLI não deixa você passar do ritmo seguro, e o aquecimento de chip continua valendo para números novos.

Tem SDK para Node ou Python?
O CLI é escrito em cima da API do Blu. Se você prefere código, veja o post sobre a API.

Usa o terminal para algo que não está aqui? Conta pra gente.