Twilio SMS
Twilioの電話番号とSMSに関する作業に使用します: 番号の作成/購入、所有番号の一覧表示、番号の保持/ラベル付け、テキスト送信、受信/送信メッセージの確認。
安全性
- アカウントSID、認証トークン、APIシークレット、TOTPコード、完全な1PasswordアイテムJSONを決して出力しないでください。
- 実際の電話番号、SID、名前、アカウント固有のアイテムIDをこのスキル内に保存しないでください。
- シークレットの読み取りには
$one-passwordを使用してください。opはtmux専用です。 - デスクトップの1Passwordアクセスが必要な場合は、それらのコマンドでサービスアカウント認証を解除してください:
env -u OP_SERVICE_ACCOUNT_TOKEN op ...。 - 認証情報の形状のみ出力: フィールドが存在するか、長さ、プレフィックス(有用な場合のみ)。
- 公開書き込みやログ: ユーザーがSMSの読み取り/確認を明示的に要求しない限り、メッセージ本文を漏洩させないでください。
認証情報ルート
- Twilio CLI/プロファイルを確認:
twilio --versionまたはnpx -y twilio-cli --versiontwilio profiles:listまたはnpx -y twilio-cli profiles:list
- 環境変数の有無のみ正確に確認:
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKEN- 任意: APIキー/シークレット変数
- 環境変数が部分的にしか存在しない場合、まず1Passwordのメタデータを検索してください。
- 以下のフィールドに一致するアイテムを優先:
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKEN- 任意:
TWILIO_FROM_NUMBER
opが制限されたボルトしか認識できない場合、env -u OP_SERVICE_ACCOUNT_TOKENを使用してデスクトップ経由の読み取りを再試行してください。- 購入/送信の前に認証を確認:
curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
"https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID.json"
CLIセットアップ
Twilio CLIプロファイルの作成には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
twilio がインストールされていない場合は npx -y twilio-cli を使用してください。
番号
所有番号の一覧表示:
npx -y twilio-cli api:core:incoming-phone-numbers:list \
--properties phoneNumber,friendlyName,capabilities
米国内のSMS対応番号を検索:
npx -y twilio-cli api:core:available-phone-numbers:local:list \
--country-code US --sms-enabled --voice-enabled --limit 5
CLIの形状が扱いにくい場合やフラグがない場合は、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"
候補を1つ購入:
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"
購入後に所有権/機能を確認。Twilio JSONは小文字のキーを使用:
capabilities.sms
capabilities.mms
capabilities.voice
ユーザーが保持したい番号をマーク:
npx -y twilio-cli api:core:incoming-phone-numbers:update \
--sid "$PHONE_NUMBER_SID" \
--friendly-name "KEEP - <purpose>"
保持ルール: 番号はTwilioアカウントに残り、課金が正常である限り保持されます。明示的に要求されない限り、リリース/削除しないでください。
SMS
送信:
npx -y twilio-cli api:core:messages:create \
--from "$FROM_NUMBER" \
--to "$TO_NUMBER" \
--body "$BODY" \
-o json
ステータス取得:
npx -y twilio-cli api:core:messages:fetch --sid "$MESSAGE_SID" -o json
番号への受信メッセージを確認:
npx -y twilio-cli api:core:messages:list \
--to "$NUMBER" --limit 20 -o json
番号からの送信メッセージを確認:
npx -y twilio-cli api:core:messages:list \
--from "$NUMBER" --limit 20 -o json
Twilio CLI JSONは単一リソースコマンドでも配列を返す場合があります。防御的にパース:
jq 'if type=="array" then .[0] else . end'
注意事項
- 国際SMSでは、購入した米国番号の代わりに英数字またはキャリア送信者として表示される場合があります。
- 米国SMSはコンプライアンスの対象となる場合があります。米国の受信者への送信に失敗した場合は、盲目的に再試行する前にA2P/10DLC登録状況を確認してください。
- トライアルアカウントでは受信者が制限される場合があります。