steipete/twilio-sms

CLI Twilio SMS : acheter/lister/conserver des numéros, envoyer/vérifier des messages, routage des identifiants.

Qu'est-ce que twilio-sms ?

L'agent technique Twilio SMS automatise la gestion des numéros de téléphone et des messages SMS via l'API Twilio. Il permet d'acheter de nouveaux numéros, de lister les numéros possédés, de les étiqueter pour les conserver, d'envoyer des SMS et de vérifier les messages entrants et sortants. La compétence gère de manière sécurisée les identifiants Twilio (Account SID, Auth Token) en vérifiant d'abord les variables d'environnement, puis en utilisant 1Password via des appels 'op' avec un routage spécifique pour les coffres restreints. Elle utilise soit la CLI Twilio officielle (via `npx -y twilio-cli` si nécessaire), soit directement l'API REST lorsque la CLI ne dispose pas des options requises. La compétence inclut des mesures de sécurité strictes : ne jamais afficher les secrets, ne pas stocker de données sensibles dans ses propres fichiers, et utiliser des appels `env -u OP_SERVICE_ACCOUNT_TOKEN op ...` pour accéder à 1Password depuis le bureau si nécessaire.

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

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Twilio SMS

Utilisez pour le travail sur les numéros de téléphone et les SMS Twilio : créez/achetez des numéros, listez les numéros possédés, conservez/étiquetez les numéros, envoyez des textos et vérifiez les messages entrants/sortants.

Sécurité

  • N'affichez jamais les SID de compte, les jetons d'authentification, les secrets d'API, les codes TOTP ou le JSON complet d'un élément 1Password.
  • Ne stockez pas les vrais numéros de téléphone, SID, noms ou identifiants d'élément spécifiques au compte dans cette compétence.
  • Utilisez $one-password pour les lectures de secrets. op reste réservé à tmux.
  • Si l'accès à 1Password depuis le bureau est nécessaire, désactivez l'authentification par compte de service pour ces commandes : env -u OP_SERVICE_ACCOUNT_TOKEN op ....
  • Affichez uniquement la forme des identifiants : champ présent, longueur, classe de préfixe si utile.
  • Écritures ou journaux publics : évitez de divulguer le corps des messages sauf si l'utilisateur a demandé à lire/vérifier un SMS.

Routage des identifiants

  1. Vérifiez la CLI/profil Twilio :
    • twilio --version ou npx -y twilio-cli --version
    • twilio profiles:list ou npx -y twilio-cli profiles:list
  2. Vérifiez uniquement la présence exacte des variables d'environnement :
    • TWILIO_ACCOUNT_SID
    • TWILIO_AUTH_TOKEN
    • Variables facultatives de clé API/secret
  3. Si seules des variables d'environnement partielles existent, recherchez d'abord les métadonnées 1Password.
  4. Préférez un élément dont les champs correspondent à :
    • TWILIO_ACCOUNT_SID
    • TWILIO_AUTH_TOKEN
    • TWILIO_FROM_NUMBER facultatif
  5. Si op ne voit qu'un coffre restreint, réessayez les lectures avec l'authentification du bureau en utilisant env -u OP_SERVICE_ACCOUNT_TOKEN.
  6. Vérifiez l'authentification avant tout achat/envoi :
curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID.json"

Configuration CLI

La création d'un profil CLI Twilio nécessite le jeton d'authentification du compte, pas seulement les identifiants de clé 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

Utilisez npx -y twilio-cli lorsque twilio n'est pas installé.

Numéros

Listez les numéros possédés :

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

Recherchez l'inventaire local américain compatible SMS :

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

Si la forme de la CLI est maladroite ou si des options manquent, utilisez 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"

Achetez un candidat :

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"

Vérifiez la propriété/les capacités après achat. Twilio JSON utilise des clés en minuscules :

capabilities.sms
capabilities.mms
capabilities.voice

Marquez les numéros que l'utilisateur souhaite conserver :

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

Règle de conservation : un numéro est conservé tant qu'il reste dans le compte Twilio et que la facturation est saine. Ne libérez/supprimez que si demandé explicitement.

SMS

Envoyez :

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

Récupérez le statut :

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

Vérifiez les messages entrants vers un numéro :

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

Vérifiez les messages sortants d'un numéro :

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

Le JSON de la CLI Twilio peut renvoyer un tableau pour les commandes à ressource unique. Analysez de manière défensive :

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

Remarques

  • Les SMS internationaux peuvent afficher un expéditeur alphanumérique ou par opérateur au lieu du numéro américain acheté.
  • Les SMS américains peuvent être soumis à des restrictions de conformité. Si l'envoi vers des destinataires américains échoue, vérifiez l'état d'enregistrement A2P/10DLC avant de réessayer aveuglément.
  • Les comptes d'essai peuvent restreindre les destinataires.

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 associés