steipete/twilio-sms

CLI do Twilio SMS: comprar/listar/manter números, enviar/verificar mensagens, roteamento de credenciais.

O que é twilio-sms?

Esta skill fornece uma interface de linha de comando (CLI) para gerenciar números de telefone e mensagens SMS do Twilio. Ela permite comprar novos números, listar números já possuídos, marcar números para retenção, enviar mensagens de texto e verificar mensagens recebidas e enviadas. A skill é útil para desenvolvedores que precisam interagir programaticamente com a API do Twilio através de ferramentas de IA como Claude Code, Cursor ou Codex, automatizando tarefas comuns de comunicação. Ela prioriza segurança ao nunca imprimir tokens de autenticação ou IDs de conta, e implementa um roteamento de credenciais inteligente: verifica primeiro as variáveis de ambiente, depois busca no 1Password, e pode alternar entre autenticação via service account e desktop conforme necessário. A skill usa comandos `npx twilio-cli` quando o Twilio CLI não está instalado globalmente, e oferece fallbacks com chamadas REST diretas para situações onde o CLI é inconveniente. Inclui regras de retenção de números e orientações sobre conformidade de SMS nos EUA (A2P/10DLC) e limitações de contas trial.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/twilio-sms

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Twilio SMS

Use para trabalho com números de telefone e SMS do Twilio: criar/comprar números, listar números possuídos, manter/rotular números, enviar textos e verificar mensagens recebidas e enviadas.

Segurança

  • Nunca imprima Account SIDs, auth tokens, segredos de API, códigos TOTP ou JSON completo de itens do 1Password.
  • Não armazene números de telefone reais, SIDs, nomes ou IDs de itens específicos da conta nesta skill.
  • Use $one-password para leitura de segredos. op permanece apenas no tmux.
  • Se for necessário acesso ao 1Password desktop, desative a autenticação do service account para esses comandos: env -u OP_SERVICE_ACCOUNT_TOKEN op ....
  • Imprima apenas a forma da credencial: campo presente, comprimento, classe do prefixo se útil.
  • Escritas ou logs públicos: evite vazar corpos de mensagem a menos que o usuário tenha pedido para ler/verificar SMS.

Roteamento de Credenciais

  1. Verifique Twilio CLI/profile:
    • twilio --version ou npx -y twilio-cli --version
    • twilio profiles:list ou npx -y twilio-cli profiles:list
  2. Verifique apenas a presença exata de envs:
    • TWILIO_ACCOUNT_SID
    • TWILIO_AUTH_TOKEN
    • opcionais vars de chave/segredo API
  3. Se apenas env parcial existir, pesquise metadados do 1Password primeiro.
  4. Prefira um item com campos correspondentes a:
    • TWILIO_ACCOUNT_SID
    • TWILIO_AUTH_TOKEN
    • opcional TWILIO_FROM_NUMBER
  5. Se op só vir um cofre restrito, tente novamente leituras com suporte desktop usando env -u OP_SERVICE_ACCOUNT_TOKEN.
  6. Verifique a autenticação antes de qualquer compra/envio:
curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID.json"

Configuração CLI

A criação de perfil do Twilio CLI requer o auth token da conta, não apenas credenciais de chave de API:

npx -y twilio-cli profiles:create "$TWILIO_ACCOUNT_SID" \
  --auth-token "$TWILIO_AUTH_TOKEN" \
  --profile default --force --silent
npx -y twilio-cli profiles:use default

Use npx -y twilio-cli quando twilio não estiver instalado.

Números

Listar os possuídos:

npx -y twilio-cli api:core:incoming-phone-numbers:list \
  --properties phoneNumber,friendlyName,capabilities

Pesquisar inventário local de números dos EUA com capacidade SMS:

npx -y twilio-cli api:core:available-phone-numbers:local:list \
  --country-code US --sms-enabled --voice-enabled --limit 5

Se a forma do CLI for estranha ou faltarem flags, use REST:

curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/AvailablePhoneNumbers/US/Local.json?SmsEnabled=true&VoiceEnabled=true&PageSize=5"

Comprar um candidato:

curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json" \
  --data-urlencode "PhoneNumber=$PHONE_NUMBER"

Verifique propriedade/capacidades após a compra. O JSON do Twilio usa chaves minúsculas:

capabilities.sms
capabilities.mms
capabilities.voice

Marque números que o usuário deseja manter:

npx -y twilio-cli api:core:incoming-phone-numbers:update \
  --sid "$PHONE_NUMBER_SID" \
  --friendly-name "KEEP - <propósito>"

Regra de retenção: um número é mantido enquanto permanecer na conta Twilio e o faturamento estiver saudável. Não libere/exclua a menos que explicitamente solicitado.

SMS

Enviar:

npx -y twilio-cli api:core:messages:create \
  --from "$FROM_NUMBER" \
  --to "$TO_NUMBER" \
  --body "$BODY" \
  -o json

Obter status:

npx -y twilio-cli api:core:messages:fetch --sid "$MESSAGE_SID" -o json

Verificar recebidas de um número:

npx -y twilio-cli api:core:messages:list \
  --to "$NUMBER" --limit 20 -o json

Verificar enviadas de um número:

npx -y twilio-cli api:core:messages:list \
  --from "$NUMBER" --limit 20 -o json

O JSON do Twilio CLI pode retornar um array para comandos de recurso único. Analise defensivamente:

jq 'if type=="array" then .[0] else . end'

Notas

  • SMS internacional pode mostrar um remetente alfanumérico ou da operadora em vez do número comprado nos EUA.
  • SMS nos EUA pode estar sujeito a conformidade. Se o envio para destinatários nos EUA falhar, verifique o estado de registro A2P/10DLC antes de tentar novamente cegamente.
  • Contas trial podem restringir destinatários.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas