Twilio SMS
用於 Twilio 電話號碼和 SMS 工作:創建/購買號碼、列出已擁有的號碼、保留/標記號碼、發送簡訊,以及檢查傳入/傳出訊息。
安全
- 絕不打印 Account SID、auth token、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 設定檔需要帳戶認證 token,不僅是 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"
購買一個候選號碼:
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 - <用途>"
保留規則:只要號碼仍在 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 註冊狀態。
- 試用帳戶可能限制收件者。