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
- 仅检查确切的env变量是否存在:
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKEN- 可选的API密钥/密钥变量
- 如果仅存在部分env,首先搜索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"
购买一个候选号码:
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'
备注
- 国际短信可能显示字母数字或运营商发送者,而非购买的美国号码。
- 美国短信可能受合规限制。如果向美国接收方发送失败,请在盲目重试前检查A2P/10DLC注册状态。
- 试用账户可能限制接收方。