프로그래밍 방식으로 Truecaller SMS 코드 받기

Truecaller의 API 호출 순서는 어떻게 되나요?

Truecaller의 서비스 ID는 truecaller이며, 아래의 모든 호출은 or_live_ 접두사의 Bearer 키로 https://otproute.com/api/v1에 요청합니다.

1. GET /api/v1/countries로 국가 ID를 가져옵니다. 캐시해 두세요.
2. GET /api/v1/prices?country=<id>&service=truecaller는 실시간 가격과 지금 경로가 열려 있는지를 반환합니다.
3. POST /api/v1/activations에 {"service": "truecaller", "country": "in"}(또는 다른 국가 ID)을 보내 번호를 예약하고 활성화 ID를 받습니다.
4. 테스트 기기의 Truecaller 앱에 그 번호를 입력하고 인증을 요청합니다.
5. 코드는 activation.sms_received 웹훅 이벤트로 도착하며, GET /api/v1/activations/{id}를 폴링해도 됩니다.
6. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel이 즉시 환불합니다.

한 계정은 API 키 10개, 웹훅 엔드포인트 5개, 분당 300회 요청을 지원합니다. 재시도와 타임아웃은 API 연동 가이드에서 다룹니다.

웹훅 핸들러는 Truecaller 이벤트를 어떻게 처리해야 하나요?

모든 전송에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 타임스탬프, 점, 원본 요청 본문에 대한 HMAC-SHA256을 다시 계산해 상수 시간으로 비교하고, 너무 오래된 타임스탬프는 거부하세요.

모든 처리를 활성화 ID 기준으로 하세요. 웹훅은 재시도될 수 있으므로 코드를 두 번 저장하거나 테스트를 두 번 진행시키는 핸들러는 불안정한 결과를 낳습니다. 동작하기 전에 활성화가 이미 완료로 표시되었는지 확인하세요. activation.expired와 activation.cancelled는 테스트 러너에 대기를 멈추라고 알리는 종료 상태로 취급하세요. 공개 엔드포인트가 없는 로컬 개발에서는 폴링이 대체 수단이 됩니다.

Truecaller는 왜 전화번호를 요구하나요?

Truecaller는 발신자 표시 및 스팸 차단 앱이며, 전화번호가 곧 계정입니다. 등록 과정에서는 프로필이 만들어지기 전에 사용자가 그 번호를 통제하는지 확인하고, 앱을 재설치하거나 새 기기로 옮길 때 이 확인이 반복됩니다. 일부 기기에서는 앱이 SMS 대신 전화로 인증을 시도할 수 있습니다. OTP Gateway 번호는 SMS만 수신하므로 전화 기반 확인으로는 활성화에 코드가 생기지 않으며, 제한 시간이 그냥 끝나고 지갑으로 환불됩니다.

팀이 Truecaller 계정을 인증하는 정당한 이유로는 특정 시장 사람들에게 회사의 발신 지원 번호나 배송 번호가 어떻게 표시되는지 확인하는 것, 발신자 식별을 연동한 앱의 QA, 개인 휴대폰과 분리된 업무용 프로필이 필요한 운영 직원 등이 있습니다.

어느 국가에 Truecaller 경로가 있나요?

실시간 스냅샷에는 인도, 파키스탄, 방글라데시, 나이지리아, 케냐, 이집트, 인도네시아, 스리랑카, 네팔, 사우디아라비아, 아랍에미리트, 브라질, 멕시코, 남아프리카공화국, 영국, 미국을 포함해 198개국의 Truecaller 경로가 올라 있습니다.

테스트 케이스에 맞는 국가를 고르세요. 발신자 라벨, 스팸 신고, 앱의 언어는 시장을 따르므로, 라고스 지원 회선이 어떻게 표시되는지 확인하려면 가장 저렴한 경로가 아니라 나이지리아 경로를 써야 합니다. 가용 상태는 하루 중에도 바뀌므로 실행할 때마다 가격 엔드포인트를 조회하세요.

개발자가 아니어도 대시보드에서 할 수 있나요?

네. 로그인해서 OTP Gateway를 열고 Truecaller와 국가를 선택한 다음 표시된 가격을 확인하면, 활성화 카드에 번호가 나타납니다. Truecaller에 입력하고 코드를 요청하면 SMS가 도착했을 때 같은 카드에 코드가 표시됩니다. 20분의 제한 시간도 카드에서 볼 수 있습니다. 코드가 오지 않거나 취소하면 전액이 자동으로 지갑에 돌아옵니다. 지갑 충전은 카드 또는 USDT/USDC로 할 수 있으며 충전마다 PDF 인보이스가 이메일로 발송됩니다. 요금 페이지를 참고하세요.

Truecaller 코드가 도착하지 않는 이유는 무엇일까요?

흔한 원인은 다음과 같습니다.

• Truecaller가 번호를 가상으로 간주해 거부했습니다. 일부 서비스는 그렇게 하며, 이것이 환불해 드리는 이유입니다.
• 앱이 SMS 대신 전화 기반 인증을 선택했습니다.
• 경로가 잠시 혼잡했습니다. 나중에 다시 시도하거나 테스트에 맞는 다른 국가를 사용하세요.
• 번호를 국가 코드 없이 입력했거나 불필요한 트렁크 0과 함께 입력했습니다.

주문 엔드포인트를 반복문으로 계속 호출하지 마세요. 시도 사이에 간격을 두고 각 활성화 ID를 기록하면 패턴을 확인할 수 있습니다.

Truecaller에는 언제 전용 번호가 더 알맞나요?

일회용 번호는 활성화가 끝나면 사라집니다. Truecaller 프로필을 나중에 다시 인증해야 한다면, 예를 들어 초기화되는 지원팀의 업무용 기기라면 전용 번호(Dedicated Number)를 사용하세요. 전용 번호는 미국과 캐나다에서 월 $1.95부터 즉시 이용할 수 있고, 대시보드와 number.sms_received 웹훅으로 SMS를 받으며, 해지할 때까지 지갑에서 갱신됩니다. 가상 번호를 참고하세요.

OTP Route는 자사의 정당한 계정과 제품에만 사용하세요. 실제 개인 또는 사업체당 계정 하나를 유지하고, 다른 사람의 번호에 대한 신고나 라벨 변경에 쓰지 말며, Truecaller의 이용약관과 OTP Route의 허용 가능한 사용 정책(Acceptable Use Policy)을 충분히 존중해야 합니다. Truecaller는 해당 소유자의 상표이며, OTP Route는 Truecaller와 제휴 관계가 없습니다.

자주 묻는 질문

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

truecaller입니다. GET /api/v1/prices와 POST /api/v1/activations 본문에서 국가 ID와 함께 사용하세요.

가상 번호로 Truecaller OTP를 받을 수 있나요?

대체로 가능하지만 항상 그렇지는 않습니다. Truecaller가 가상으로 분류한 번호를 거부할 수 있으며, 20분 안에 코드가 도착하지 않으면 요금은 자동으로 환불됩니다.

Truecaller가 SMS를 보내지 않고 전화를 건 이유는 무엇인가요?

일부 기기에서는 앱이 전화 기반 인증을 선택할 수 있습니다. OTP Gateway 번호는 SMS만 수신하므로, 앱이 SMS 옵션을 제공한다면 그것을 요청하세요.

Truecaller SMS 인증 테스트에는 어느 국가를 골라야 하나요?

테스트가 다루는 시장을 고르세요. 발신자 라벨과 언어가 번호의 국가를 따르기 때문입니다. 먼저 가격 엔드포인트로 실시간 가용 상태를 확인하세요.

나중의 로그인을 위해 같은 Truecaller 전화번호를 계속 유지할 수 있나요?

네, 미국 또는 캐나다의 전용 번호(월 $1.95부터)로 가능합니다. 일회용 Gateway 번호는 재사용할 수 없습니다.

중복된 웹훅 전송이 테스트를 망치지 않게 하려면 어떻게 하나요?

활성화 ID 기준으로 핸들러를 멱등하게 만들고, 페이로드로 무엇이든 하기 전에 서명부터 검증하세요.

OTP Route는 Truecaller와 제휴 관계인가요?

아니요. Truecaller는 해당 소유자의 상표이며, OTP Route는 테스트와 정당한 자사 계정 운영을 위한 번호를 제공합니다.

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