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-passwordpour les lectures de secrets.opreste 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
- Vérifiez la CLI/profil Twilio :
twilio --versionounpx -y twilio-cli --versiontwilio profiles:listounpx -y twilio-cli profiles:list
- Vérifiez uniquement la présence exacte des variables d'environnement :
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKEN- Variables facultatives de clé API/secret
- Si seules des variables d'environnement partielles existent, recherchez d'abord les métadonnées 1Password.
- Préférez un élément dont les champs correspondent à :
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKENTWILIO_FROM_NUMBERfacultatif
- Si
opne voit qu'un coffre restreint, réessayez les lectures avec l'authentification du bureau en utilisantenv -u OP_SERVICE_ACCOUNT_TOKEN. - 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.