Twilio SMS
Verwenden für Twilio-Telefonnummern und SMS-Arbeiten: Nummern erstellen/kaufen, eigene Nummern auflisten, Nummern behalten/beschriften, Texte senden sowie eingehende und ausgehende Nachrichten überprüfen.
Sicherheit
- Gib niemals Account-SIDs, Auth-Tokens, API-Secrets, TOTP-Codes oder vollständige 1Password-Element-JSONs aus.
- Speichere keine echten Telefonnummern, SIDs, Namen oder accountspezifischen Element-IDs in diesem Skill.
- Verwende
$one-passwordfür das Lesen von Geheimnissen.opbleibt tmux-exklusiv. - Falls Desktop-1Password-Zugriff benötigt wird, entferne die Service-Account-Authentifizierung für diese Befehle:
env -u OP_SERVICE_ACCOUNT_TOKEN op .... - Gib nur die Form der Credentials aus: Feld vorhanden, Länge, Präfixklasse falls nützlich.
- Öffentliche Schreibvorgänge oder Logs: Vermeide das Preisgeben von Nachrichteninhalten, es sei denn, der Benutzer hat darum gebeten, SMS zu lesen/zu prüfen.
Credential-Route
- Überprüfe Twilio-CLI/Profil:
twilio --versionodernpx -y twilio-cli --versiontwilio profiles:listodernpx -y twilio-cli profiles:list
- Überprüfe nur die genaue Anwesenheit von Umgebungsvariablen:
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKEN- optionale API-Key/Secret-Variablen
- Falls nur teilweise Umgebungsvariablen vorhanden sind, durchsuche zuerst 1Password-Metadaten.
- Bevorzuge ein Element mit Feldern, die Folgendem entsprechen:
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKEN- optional
TWILIO_FROM_NUMBER
- Falls
opnur einen eingeschränkten Tresor sieht, wiederhole Desktop-gestützte Lesevorgänge mitenv -u OP_SERVICE_ACCOUNT_TOKEN. - Verifiziere die Authentifizierung vor jedem Kauf/Versand:
curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
"https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID.json"
CLI-Einrichtung
Die Erstellung eines Twilio-CLI-Profils erfordert das Account-Auth-Token, nicht nur API-Key-Credentials:
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
Verwende npx -y twilio-cli, wenn twilio nicht installiert ist.
Nummern
Eigene Nummern auflisten:
npx -y twilio-cli api:core:incoming-phone-numbers:list \
--properties phoneNumber,friendlyName,capabilities
US-lokale, SMS-fähige Bestände durchsuchen:
npx -y twilio-cli api:core:available-phone-numbers:local:list \
--country-code US --sms-enabled --voice-enabled --limit 5
Falls die CLI-Form unhandlich ist oder Flags fehlen, verwende 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"
Einen Kandidaten kaufen:
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"
Besitz/Fähigkeiten nach dem Kauf überprüfen. Twilio-JSON verwendet Kleinbuchstaben-Schlüssel:
capabilities.sms
capabilities.mms
capabilities.voice
Nummern, die der Benutzer behalten möchte, markieren:
npx -y twilio-cli api:core:incoming-phone-numbers:update \
--sid "$PHONE_NUMBER_SID" \
--friendly-name "KEEP - <zweck>"
Aufbewahrungsregel: Eine Nummer wird behalten, solange sie sich im Twilio-Konto befindet und die Abrechnung in Ordnung ist. Nicht freigeben/löschen, es sei denn, es wird ausdrücklich darum gebeten.
SMS
Senden:
npx -y twilio-cli api:core:messages:create \
--from "$FROM_NUMBER" \
--to "$TO_NUMBER" \
--body "$BODY" \
-o json
Status abrufen:
npx -y twilio-cli api:core:messages:fetch --sid "$MESSAGE_SID" -o json
Eingehende Nachrichten an eine Nummer prüfen:
npx -y twilio-cli api:core:messages:list \
--to "$NUMBER" --limit 20 -o json
Ausgehende Nachrichten von einer Nummer prüfen:
npx -y twilio-cli api:core:messages:list \
--from "$NUMBER" --limit 20 -o json
Das Twilio-CLI-JSON kann für Einzelressourcen-Befehle ein Array zurückgeben. Defensiv parsen:
jq 'if type=="array" then .[0] else . end'
Hinweise
- Internationale SMS können einen alphanumerischen oder Carrier-Absender anstelle der gekauften US-Nummer anzeigen.
- US-SMS kann compliance-technisch eingeschränkt sein. Falls das Senden an US-Empfänger fehlschlägt, überprüfe den A2P/10DLC-Registrierungsstatus, bevor du blind wiederholst.
- Testkonten können die Empfänger einschränken.