Sendblue CLI

Visão Geral

@sendblue/cli é uma CLI Node que cria uma conta Sendblue, provisiona um número habilitado para iMessage e envia mensagens. É a maneira mais rápida de enviar SMS de um shell, script ou hook do Claude Code — sem cliente de API, sem servidor webhook, sem credenciais em variáveis de ambiente. As credenciais ficam em ~/.sendblue/credentials.json (modo 600) e o Node.js 18+ é necessário.

Quando Usar Esta Habilidade

• Use quando o usuário quiser enviar SMS para um número de telefone a partir de um script, shell, hook ou turno de agente (por exemplo, "me avise por SMS quando X terminar", "ping meu telefone", "notificar na conclusão").
• Use quando o usuário mencionar sendblue como uma CLI/binário ou pedir para configurar o pacote @sendblue/cli.
• Prefira esta habilidade em vez de [[sendblue-api]] quando o trabalho ocorrer em um contexto de shell, script único, job cron ou hook de agente.
• Opte por [[sendblue-api]] em vez disso ao escrever código de aplicação que integra Sendblue, recebendo webhooks de entrada ou precisando de recursos que a CLI não expõe (estilos de envio, reações, mensagens em grupo, callbacks de status, uploads de mídia).

Como Funciona

Passo 1: Instalar

npm install -g @sendblue/cli       # global, exposes `sendblue`
# or one-shot:
npx @sendblue/cli <command>

Passo 2: Configurar uma conta

sendblue setup é executado interativamente por padrão. Para CI/scripts, execute-o em duas fases — a primeira chamada envia um código de verificação de 8 dígitos por e-mail, a segunda o consome.

sendblue setup --email you@example.com                                       # sends code
sendblue setup --email you@example.com --code 12345678 \
               --company my-co --contact +15551234567                        # completes setup

Passo 3: Enviar mensagens

sendblue send +15551234567 'Hello from Sendblue!'
sendblue messages --inbound --limit 20

Os números de telefone devem estar no formato E.164 (+ + código do país + dígitos, sem espaços ou hifens).

Passo 4: Gerenciar contatos e plano

No plano gratuito, um contato deve enviar uma mensagem para o seu número Sendblue uma vez antes que os envios de saída para esse contato funcionem. Após sendblue setup ... --contact +15551234567, peça a esse contato para enviar qualquer mensagem para o número Sendblue impresso, e então execute sendblue contacts para confirmar a verificação.

Referência de Comandos

Exemplos

Exemplo 1: Notificar quando uma tarefa longa terminar

long_running_thing && sendblue send +15551234567 "✅ done: $(date)"

Exemplo 2: Ler mensagens de entrada recentes para um contato específico

sendblue messages -n +15551234567 --inbound --limit 50

Exemplo 3: Verificar se as credenciais estão boas antes de um envio em lote

sendblue whoami || sendblue login

Exemplo 4: Conectar a um hook do Claude Code Stop

Para enviar uma mensagem para si mesmo ao final de cada turno do agente, registre um hook Stop em settings.json que execute um shell para sendblue send. Deixe a conexão real do hook para [[update-config]] e a lógica de gatilho para [[sendblue-notify]] — esta habilidade apenas gerencia a invocação da CLI.

Melhores Práticas

• ✅ Use números E.164 em todos os lugares. +15551234567, nunca 5551234567 ou (555) 123-4567.
• ✅ Execute sendblue whoami antes de lotes não supervisionados para falhar rapidamente em credenciais desatualizadas ou ausentes.
• ✅ Reexecute setup como o mesmo usuário do SO que possui ~/.sendblue/credentials.json.
• ❌ Não sudo — isso grava credenciais na home do root e a próxima execução sem sudo não as verá.
• ❌ Não incorpore credenciais em variáveis de ambiente quando a CLI já as lê do arquivo de credenciais por usuário.

Limitações

• Saída primeiro: não há servidor webhook integrado para entrada. Use os webhooks [[sendblue-api]] para tratamento completo de entrada.

…