테스트 번호로 Telegram 로그인 코드를 받기 전 점검 체크리스트

Telegram 번호를 주문하기 전에 무엇을 준비해야 하나요?

먼저 이 목록을 확인하세요. 실패하는 Telegram 테스트의 대부분은 아래 항목 중 하나에서 원인이 나옵니다.

• 명확한 목적. 자사 팀이 운영하는 봇, Mini App, 로그인 위젯 또는 지원 워크플로를 테스트하는 것이며, 어느 직원의 개인 휴대폰에도 묶이지 않은 새 Telegram 계정이 필요합니다.
• 대상 국가. 계정이 어느 시장에 속하는 것처럼 보일지 정하세요. 기본 언어와 일부 온보딩 화면은 번호의 국가를 따릅니다.
• 지갑 잔액 또는 샌드박스. 충전된 선불 지갑, 또는 리허설을 위해 지원팀이 샌드박스로 전환한 개발 계정이 필요합니다.
• 자동화한다면 API 키. 개발자 콘솔에서 접두사 or_live_로 시작하는 키를 만드세요.
• 깨끗한 기기 또는 에뮬레이터. Telegram은 이미 로그인된 세션이 있으면 앱 내부로 코드를 보내므로, 세션이 없는 기기를 쓰면 SMS 경로를 예측하기 쉽습니다.
• 시간. 활성화는 20분간 열려 있으므로, 테스터가 번호를 입력할 준비가 되기 전에는 시작하지 마세요.

Telegram은 언제 실제로 SMS 코드를 보내나요?

Telegram은 모든 계정을 전화번호로 식별합니다. 새 계정을 등록할 때와 기존 계정이 새 기기에서 로그인할 때 코드를 요구합니다. 해당 계정이 이미 다른 곳에서 활성 상태라면 Telegram은 보통 SMS가 아니라 기존 세션에 메시지로 로그인 코드를 보냅니다. 그래서 새 기기에서 신규 번호를 쓰는 것이 SMS 단계를 테스트하는 가장 깔끔한 방법입니다. 잠시 기다린 뒤 통화나 재전송을 제안할 수도 있습니다.

Telegram의 2단계 인증은 앱 안에서 설정하는 별도의 클라우드 비밀번호입니다. SMS 요소가 아니므로, 테스트 계정에서 이를 켠다면 그 비밀번호는 팀의 시크릿 매니저에 보관하세요.

Telegram은 어떤 국가를 고를 수 있고, 왜 중요한가요?

telegram 서비스는 현재 199개국에 등록되어 있으며, 인도, 독일, 브라질, 나이지리아, 인도네시아를 비롯해 영국, 우크라이나, 카자흐스탄, 우즈베키스탄, 튀르키예, 스페인, 멕시코, 필리핀, 베트남, 이집트 등이 포함됩니다.

국가는 테스트 케이스에 맞추세요. 포르투갈어로 응답하는 봇은 브라질 계정에서 시험해야 하고, 중앙아시아를 담당하는 지원팀이라면 카자흐스탄 번호가 필요할 수 있습니다. Telegram은 일부 국가의 번호를 다른 국가보다 더 신중하게 다루기도 하므로, 한 경로가 계속 실패하면 인접 시장이 합리적인 대안입니다. 실시간 가용성은 하루 동안 바뀌므로 저장해 둔 목록 대신 API에서 읽으세요.

API로 Telegram 코드를 자동화하려면 어떻게 하나요?

1. 필요하면 GET /api/v1/prices?country=<id>&service=telegram으로 비용을 먼저 확인합니다.
2. 주문을 생성합니다. POST /api/v1/activations에 {"service": "telegram", "country": "<id>"}를 보내며, 국가 ID는 GET /api/v1/countries에서 가져옵니다(예: br, de).
3. 반환된 번호를 테스트 러너에 넘겨 Telegram 클라이언트 또는 에뮬레이터에 입력하게 합니다.
4. 코드를 기다립니다. 웹훅을 쓴다면 activation.sms_received를 수신하고, 그렇지 않으면 적절한 간격으로 GET /api/v1/activations/{id}를 폴링합니다.
5. 실행이 중단되면 POST /api/v1/activations/{id}/cancel로 정리합니다.

웹훅에서는 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 다시 계산해 X-OTPRoute-Signature를 검증하고, 오래된 타임스탬프는 거부하며, 처리한 활성화 ID를 기록해 다시 전달된 이벤트는 무시하세요. 계정당 웹훅 엔드포인트는 최대 5개, 요청은 분당 300건까지 사용할 수 있습니다. 병렬 실행은 CI 파이프라인 가이드에서 다룹니다.

대시보드에서 같은 단계를 직접 할 수 있나요?

네. 로그인해 OTP Gateway를 열고 Telegram과 국가를 선택한 뒤 가격을 확인하고 주문하세요. 번호를 Telegram의 전화번호 화면에 복사하고, 해당 국가 코드를 선택한 다음 코드를 요청합니다. SMS가 도착하면 주문 옆에 표시되므로 바로 붙여넣을 수 있습니다.

Telegram 코드가 오지 않았습니다. 무엇을 점검해야 하나요?

• 기존 세션이 있나요? 번호를 이전에 쓴 적이 있다면 Telegram이 코드를 앱 안으로 보냈을 수 있습니다. 새 활성화를 만들면 이를 피할 수 있습니다.
• 시간이 끝났나요? 20분 타이머가 끝까지 돌도록 두세요. 코드가 도착했을 때만 비용이 청구되며, 만료되거나 취소되면 전액이 자동으로 환불됩니다.
• 해당 경로가 받아들여지나요? Telegram은 일부 가상 번호를 거부할 수 있습니다. 이는 저희가 통제할 수 없는 부분이며 바로 그래서 환불 규칙이 있습니다.
• 간격을 두고 재시도하세요. 나중에 또는 다른 국가에서 다시 주문하세요. 빠른 반복문으로 재주문하면 전송에도 요청 한도에도 도움이 되지 않습니다.
• 기기의 국가 코드를 확인하세요. 선택한 국가와 번호가 맞지 않는 것은 수동 테스트에서 흔한 실수입니다.

Telegram에는 언제 Dedicated Number가 더 적합한가요?

일회용 OTP Gateway 번호는 가입 테스트에 적합합니다. 하지만 다음 달에 Telegram 계정이 다시 로그인해야 한다면, 예를 들어 지원 채널을 운영하는 팀 계정이나 봇의 관리자 로그인이라면 팀이 계속 통제하는 전화번호가 필요합니다. 미국과 캐나다의 Dedicated Number는 월 $1.95부터이며, 갱신되는 동안 계속 내 번호로 유지되고 수신 SMS를 대시보드와 웹훅(number.sms_received)으로 전달합니다. 장단점은 임시 번호와 전용 번호 비교 글에 정리되어 있습니다.

책임 있는 Telegram 테스트란 어떤 모습인가요?

Telegram의 서비스 약관을 지키세요. 실제 개인 또는 사업 목적당 계정 하나만 만들고, 자사 제품, 봇, 운영에만 사용하며, 스팸이나 대량 계정 생성, 차단 우회에는 절대 쓰지 마세요. 주문하는 모든 Telegram 활성화에는 OTP Route 이용 정책(Acceptable Use Policy)도 적용됩니다. Telegram은 해당 소유자의 상표이며, OTP Route는 Telegram과 제휴 관계가 없습니다.

자주 묻는 질문

개인 휴대폰 없이 Telegram 인증 코드를 받을 수 있나요?

네. OTP Route OTP Gateway에서 Telegram 번호를 주문해 앱에 입력하고, 대시보드나 API에서 SMS 코드를 확인하세요.

API에서 Telegram의 서비스 ID는 무엇인가요?

telegram입니다. 활성화를 만들 때 GET /api/v1/countries의 국가 ID와 함께 사용하세요.

테스트용 Telegram SMS 인증은 비용이 얼마인가요?

코드당 $0.20부터이며, 정확한 가격은 국가에 따라 다르고 가격 엔드포인트가 실시간으로 반환합니다.

Telegram이 SMS 대신 앱 안으로 코드를 보낸 이유는 무엇인가요?

Telegram은 기존 세션이 있으면 그곳으로 로그인 코드를 보냅니다. SMS 경로를 테스트하려면 새 번호와 로그인된 세션이 없는 기기를 사용하세요.

일회용 번호를 다시 써서 나중에 Telegram에 로그인할 수 있나요?

아니요. OTP Gateway 번호는 코드 한 번 전용입니다. 반복 로그인에는 미국 또는 캐나다의 Dedicated Number를 사용하세요.

Telegram이 번호를 거부하면 요금이 청구되나요?

아니요. 20분 안에 번호로 코드가 도착하지 않거나 직접 취소하면 전액이 지갑으로 돌아옵니다.

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