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"
후보 번호 구매:
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 등록 상태를 확인하세요.
- 평가판 계정은 수신자를 제한할 수 있습니다.