steipete/twilio-sms

CLI de Twilio SMS: comprar/listar/mantener números, enviar/verificar mensajes, enrutamiento de credenciales.

¿Qué es twilio-sms?

Esta habilidad proporciona una interfaz de línea de comandos para gestionar números de teléfono y SMS de Twilio. Permite comprar, listar y etiquetar números, así como enviar mensajes de texto y consultar el estado de mensajes entrantes y salientes. Es especialmente útil para desarrolladores que necesitan automatizar la gestión de comunicaciones por SMS a través de la API de Twilio. La habilidad incluye un proceso de enrutamiento de credenciales que verifica la presencia de variables de entorno como `TWILIO_ACCOUNT_SID` y `TWILIO_AUTH_TOKEN`, y busca en 1Password si es necesario, garantizando la seguridad de las credenciales. Soporta tanto la CLI de Twilio como llamadas REST directas para mayor flexibilidad.

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

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Twilio SMS

Úsalo para trabajo con números de teléfono y SMS de Twilio: crear/comprar números, listar números propios, mantener/etiquetar números, enviar textos y consultar mensajes entrantes y salientes.

Seguridad

  • Nunca imprimas SIDs de cuenta, tokens de autenticación, secretos de API, códigos TOTP ni JSON completo de elementos de 1Password.
  • No almacenes números de teléfono reales, SIDs, nombres o IDs de elementos específicos de cuentas en esta habilidad.
  • Usa $one-password para leer secretos. op permanece solo en tmux.
  • Si se necesita acceso a 1Password de escritorio, desactiva la autenticación de cuenta de servicio para esos comandos: env -u OP_SERVICE_ACCOUNT_TOKEN op ....
  • Imprime solo la forma de la credencial: campo presente, longitud, clase de prefijo si es útil.
  • Escrituras o registros públicos: evita filtrar cuerpos de mensajes a menos que el usuario lo solicite para leer/verificar SMS.

Ruta de Credenciales

  1. Verifica la CLI/perfil de Twilio:
    • twilio --version o npx -y twilio-cli --version
    • twilio profiles:list o npx -y twilio-cli profiles:list
  2. Verifica solo la presencia exacta de variables de entorno:
    • TWILIO_ACCOUNT_SID
    • TWILIO_AUTH_TOKEN
    • variables opcionales de clave/secret de API
  3. Si solo existen variables de entorno parciales, primero busca metadatos en 1Password.
  4. Prefiere un elemento con campos que coincidan con:
    • TWILIO_ACCOUNT_SID
    • TWILIO_AUTH_TOKEN
    • TWILIO_FROM_NUMBER opcional
  5. Si op solo ve un vault restringido, reintenta lecturas respaldadas por escritorio con env -u OP_SERVICE_ACCOUNT_TOKEN.
  6. Verifica la autenticación antes de cualquier compra/envío:
curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID.json"

Configuración CLI

La creación del perfil CLI de Twilio requiere el token de autenticación de la cuenta, no solo las credenciales de clave 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

Usa npx -y twilio-cli cuando twilio no esté instalado.

Números

Listar números propios:

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

Buscar inventario local de EE. UU. con capacidad SMS:

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

Si la forma de la CLI es incómoda o faltan banderas, usa 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 un 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"

Verificar propiedad/capacidades después de la compra. Twilio JSON usa claves en minúsculas:

capabilities.sms
capabilities.mms
capabilities.voice

Marcar números que el usuario desea mantener:

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

Regla de retención: un número se mantiene mientras permanezca en la cuenta de Twilio y la facturación sea saludable. No liberes/elimines a menos que se solicite explícitamente.

SMS

Enviar:

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

Obtener estado:

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

Consultar mensajes entrantes a un número:

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

Consultar mensajes salientes desde un número:

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

Twilio CLI JSON puede devolver un array para comandos de recurso único. Analiza de forma defensiva:

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

Notas

  • El SMS internacional puede mostrar un remitente alfanumérico o de operador en lugar del número estadounidense comprado.
  • El SMS en EE. UU. puede estar sujeto a cumplimiento normativo. Si el envío a destinatarios en EE. UU. falla, verifica el estado de registro A2P/10DLC antes de reintentar ciegamente.
  • Las cuentas de prueba pueden restringir los destinatarios.

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.

Skills relacionados