X(Twitter) SMS 코드 받기: 제품 및 QA 팀을 위한 체크리스트

X는 무엇 때문에 전화번호를 요구하나요?

X는 잘 알려진 몇 곳에서 전화번호를 사용합니다. 가입할 때 이메일의 대안으로, 기존 계정에 번호를 추가할 때, 평소와 다른 활동 때문에 발생하는 로그인 확인 때, 비밀번호 재설정, 그리고 문자 메시지 기반 2단계 인증입니다. X는 몇 년에 걸쳐 SMS 2단계 인증을 사용할 수 있는 계정을 좁혀 왔고 인증 앱을 대안으로 제공하므로, 테스트하는 계정의 현재 설정을 확인하세요. 이 흐름은 모두 짧은 숫자 코드를 보내며, 제품이 X 계정과 연동되거나 이를 관리한다면 각각 점검해 볼 가치가 있습니다. 브랜드 계정을 온보딩하는 소셜 미디어 도구, 공유 팀 로그인으로 고객 프로필을 운영하는 에이전시, 사용자가 X 프로필을 연결한 뒤 자사 앱의 동작을 점검하는 QA 스위트가 대표적인 사례입니다.

X(Twitter) SMS 인증 테스트를 위한 사전 점검 체크리스트

• 소유권. 계정은 본인, 소속 회사 또는 관리를 의뢰한 고객의 것이어야 합니다. 실제 개인 또는 사업체당 계정 하나입니다.
• 약관. 전화번호와 자동화에 대한 X의 규칙을 읽어 보세요. 저희 이용 정책(Acceptable Use Policy)에 더해 적용됩니다.
• 국가. 주문하기 전에 계정이 대표할 시장을 정하세요.
• 서비스 ID. OTP Route에서 X의 서비스 ID는 twitter입니다.
• 연동. Bearer 키(or_live_)와 폴링 루프 또는 웹훅 엔드포인트가 필요합니다.
• 수명. 이 계정이 한 달 뒤에 다시 로그인해야 하나요? 그렇다면 시작하기 전에 전용 회선 섹션을 읽으세요.

198개국 중 어느 국가의 번호를 써야 하나요?

X 경로는 미국, 캐나다, 영국, 독일, 프랑스, 인도, 인도네시아, 필리핀, 일본, 브라질, 멕시코, 튀르키예, 사우디아라비아, 케냐, 나이지리아, 가나 등 198개국을 포함합니다. 계정이 서비스하는 시장이나 증명하려는 테스트 케이스에 번호를 맞추세요. 지역 브랜드 계정은 해당 지역의 번호를 써야 하고, 현지화 테스트에는 그 국가의 언어와 번호 형식이 필요합니다. 번호, IP 위치, 프로필이 서로 맞지 않는 것은 X 쪽에서 추가 확인을 유발할 수 있는 신호이기도 합니다.

단계: API로 X용 번호 주문하기

기본 URL은 https://otproute.com/api/v1입니다.

1. GET /api/v1/prices?country=<id>&service=twitter로 해당 조합의 가격을 조회합니다. 실시간 가용성도 함께 확인됩니다.
2. 주문을 생성합니다. POST /api/v1/activations에 {"service": "twitter", "country": "<id>"}를 보내고 활성화 ID를 저장하세요.
3. 반환된 번호를 X의 전화번호 입력란에 입력합니다.
4. 웹훅 이벤트에서 코드를 받거나, 나타날 때까지 GET /api/v1/activations/{id}를 폴링합니다.
5. X가 번호를 거부하면 POST /api/v1/activations/{id}/cancel로 해제합니다.

국가 ID는 GET /api/v1/countries에서 가져오며, 요청과 응답 형식은 API 문서에 있습니다.

웹훅 수신기는 어떻게 만들어야 하나요?

activation.sms_received, activation.expired, activation.cancelled를 구독하세요. 모든 전달에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 타임스탬프, 점, 원본 본문에 대한 HMAC-SHA256을 계산해 상수 시간으로 비교하고, 오래된 타임스탬프는 거부하세요. 전달이 반복될 수 있으므로 처리한 활성화 ID를 저장해 중복은 무시합니다. 소규모 스위트라면 분당 300건 한도 안에서 폴링도 좋은 대안입니다. HMAC 가이드에 실제 예제가 있습니다.

클릭이 더 편하신가요? 대시보드에서 OTP Gateway를 열고 X와 국가를 선택해 표시된 가격을 확인한 뒤, 번호를 X에 붙여넣으면 주문 옆에 코드가 나타납니다.

문제 해결: X가 코드를 보내지 않았을 때

• 번호가 거부되었습니다. X는 가상 번호를 거부할 수 있으며, 번호를 사용할 수 없다는 메시지가 표시되기도 합니다. 취소한 뒤 나중에 또는 다른 국가로 재시도하세요.
• 아직 도착하지 않았습니다. 바로 재주문하지 말고 20분의 시간을 열어 두세요.
• X가 제한하고 있습니다. 한 계정에서 반복된 요청은 X 자체의 한도를 유발할 수 있으니 시도 간격을 두세요.
• 내 핸들러가 놓쳤습니다. 로그에서 서명 실패와 오류를 확인하세요.
• 계정에 플래그가 걸렸습니다. X가 계정 자체를 제한했다면 새 번호로도 달라지지 않으니, X의 공식 지원 채널로 해결하세요.

환불 규칙 덕분에 실패 비용은 없습니다. 코드가 도착했을 때만 비용을 내며, 만료되거나 취소된 활성화는 전액이 지갑으로 돌아갑니다.

미국 또는 캐나다 전용 회선이 더 적합한 때는 언제인가요?

일회용 활성화는 한 번의 인증에 맞습니다. 몇 달 뒤 로그인 확인을 통과하거나 접근 권한을 복구해야 하는 회사 계정에는 계속 유지되는 번호가 필요합니다. Dedicated Number는 미국과 캐나다에서 월 $1.95부터 이를 제공하며, 대시보드와 number.sms_received 웹훅으로 수신 SMS를 받고 발신 SMS와 브라우저 통화도 지원합니다. 두 상품은 가상 번호에서 비교하세요. OTP Route는 모든 비용을 카드 또는 USDT/USDC로 충전하는 하나의 선불 지갑에서 청구하며 PDF 인보이스를 발급합니다.

자주 묻는 질문

OTP Route API에서 X(Twitter)의 서비스 ID는 무엇인가요?

twitter입니다. 가격 요청과 활성화 본문에 사용하세요.

SIM 카드 없이 X OTP를 받을 수 있나요?

네, 198개국 중 어느 곳의 OTP Gateway 번호로도 가능하며, 코드는 대시보드에 표시되거나 웹훅으로 전송됩니다.

X가 이 전화번호는 사용할 수 없다고 하는 이유는 무엇인가요?

X가 일부 가상 번호를 거부할 수 있습니다. 활성화를 취소해 환불받고 다른 국가나 나중에 다시 시도하세요.

X 인증 코드는 얼마인가요?

코드당 $0.20부터이며, 정확한 가격은 국가에 따라 다르고 주문 전에 표시됩니다.

나중에 X에 로그인할 때 같은 번호를 다시 쓸 수 있나요?

일회용 활성화는 코드 한 번만 받습니다. 반복 로그인에는 미국 또는 캐나다의 전용 번호를 사용하세요.

OTP Route로 X 계정을 많이 만들 수 있나요?

아니요. X의 약관에 따라 자사의 합법적인 계정과 제품을 테스트하고 운영하기 위한 서비스입니다.

연동을 구축할 샌드박스가 있나요?

네. 요청하면 개발 계정을 샌드박스로 전환해 시뮬레이션된 번호와 코드를 받을 수 있습니다.

서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.