직원 휴대폰 없이 WhatsApp 인증 코드를 받는 방법

아무도 개인적으로 소유하지 않은 WhatsApp 번호가 왜 필요할까요?

흔히 겪는 상황입니다. 제품팀이 WhatsApp 기반 고객 지원 흐름을 만들거나 앱에서 채팅으로 사용자를 연결하는 과정을 테스트하려면 누군가 계정을 등록해야 합니다. 가장 빠른 방법은 동료의 개인 휴대폰을 쓰는 것입니다. 하지만 그러면 업무용 설정이 한 직원의 SIM에 묶이고, 테스트 트래픽이 사적인 대화와 섞이며, 그 직원이 퇴사하는 날 모든 것이 끊어집니다.

고객사를 대신해 WhatsApp을 설정하는 에이전시도 같은 벽에 부딪히고, 특정 시장의 현지 온보딩 흐름을 확인하려는 QA 엔지니어도 마찬가지입니다. OTP Gateway의 WhatsApp 전화번호를 쓰면 이런 작업이 누구의 개인 회선에도 의존하지 않습니다. 국가를 고르고, 가입 코드를 받고, 다음 작업으로 넘어가면 됩니다.

WhatsApp은 언제 전화번호 인증 코드를 요구하나요?

WhatsApp은 전화번호로 계정을 식별하므로, 몇 가지 시점에 일회용 코드로 해당 번호를 직접 사용하고 있는지 확인합니다.

• 가입: 새 계정은 SMS로 6자리 코드를 받으며, WhatsApp이 음성 통화를 대안으로 제시할 수도 있습니다.
• 새 기기: 앱을 다시 설치하거나 다른 휴대폰으로 옮기면 같은 확인을 다시 거치고, 이전 휴대폰은 로그아웃됩니다.
• 비즈니스 계정: 번호에 WhatsApp Business 앱을 설정할 때도 같은 단계를 거칩니다.
• 2단계 인증: 사용자가 직접 정하는 선택형 PIN입니다. SMS로는 전송되지 않지만, 활성화되어 있으면 코드와 함께 요구됩니다.

테스트 관점에서 핵심은 단순합니다. SMS는 그 시점에 해당 번호를 보유하고 있음을 증명하므로, 더 이상 보유하지 않은 번호로는 나중에 계정을 인증할 수 없습니다.

WhatsApp 인증 코드 API 흐름은 어떻게 동작하나요?

서비스 ID whatsapp과 테스트 대상 시장의 국가 ID(예: in, br, us)를 함께 사용합니다. 개발자 콘솔에서 발급한 Bearer 키로 다음 순서를 따르세요.

1. GET /api/v1/prices?country=<id>&service=whatsapp는 실시간 가격과 해당 경로가 지금 열려 있는지를 알려 줍니다.
2. POST /api/v1/activations에 {"service": "whatsapp", "country": "<id>"}를 보내면 번호가 예약되고 20분의 활성화 시간이 시작됩니다.
3. WhatsApp 가입 화면에 번호를 입력하고 SMS를 요청합니다.
4. 코드는 activation.sms_received 웹훅 이벤트로 전달되며, GET /api/v1/activations/{id}를 몇 초 간격으로 폴링해도 됩니다.
5. 실행을 중단한다면 POST /api/v1/activations/{id}/cancel로 금액을 지갑에 돌려받을 수 있습니다.

본문을 신뢰하기 전에 X-OTPRoute-Signature를 검증하세요. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 계산해 v1 값과 비교하고, 너무 오래된 타임스탬프는 거부합니다. 그런 다음 이벤트를 활성화 ID에 기록해 같은 전달이 반복되어도 아무것도 바뀌지 않게 하세요. 테스트 러너가 공개 URL을 열 수 없다면 폴링이 더 간단한 선택이며, 개발자 문서에서 두 방식을 모두 설명합니다.

어떤 국가에서 WhatsApp 번호를 받을 수 있고, 국가 선택이 중요한가요?

WhatsApp 경로는 현재 198개국에서 이용할 수 있으며, 인도, 브라질, 인도네시아, 나이지리아, 독일을 비롯해 멕시코, 영국, 미국, 파키스탄, 필리핀, 이집트, 케냐, 스페인, 튀르키예, 남아프리카공화국 등이 포함됩니다. 전체 목록은 국가 페이지에서 확인할 수 있습니다.

국가는 목적에 맞게 고르세요. 온보딩 흐름이 브라질 사용자를 겨냥한다면 +55 번호로 앱이 현지 번호를 어떻게 포맷하고 검증하고 표시하는지 볼 수 있습니다. 비즈니스 계정이 한 시장만 담당한다면 그 시장에 맞추세요. 아무 국가나 고르면 얻는 것이 없고 테스트 결과가 무의미해질 수도 있습니다.

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

WhatsApp은 어떤 번호로 코드를 보낼지 스스로 결정하며, WhatsApp 가입에 가상 번호를 아예 거부할 수도 있습니다. 그러면 활성화에 아무것도 도착하지 않고 시간이 끝나며 전액이 지갑으로 돌아옵니다. 코드가 실제로 도착했을 때만 비용을 내는 구조입니다. 그 밖의 원인은 더 평범합니다. 경로가 혼잡하거나, WhatsApp이 다른 코드를 요청하기 전에 기다리라고 하거나, SMS 대신 음성 통화로 코드를 요청한 경우입니다.

대처 방법은 다음과 같습니다.

• 1분 만에 취소하지 말고 활성화를 제한 시간 끝까지 열어 두세요.
• 가입 화면에서 통화가 아닌 SMS를 요청했는지 확인하세요.
• 나중에 다시 시도하거나, 계정의 시장이 허용한다면 다른 국가 경로를 써 보세요.
• 시도 간격을 두세요. 빠른 반복문으로 코드를 연달아 요청하면 오히려 상황이 나빠지기 쉽습니다.

오래 쓸 WhatsApp 계정에는 전용 번호를 써야 할까요?

대체로 그렇습니다. OTP Gateway 번호는 코드 한 번을 위한 것이어서, 휴대폰 교체나 재설치 후 계정을 다시 인증해야 한다면 같은 번호가 다시 필요합니다. 지원 회선, 공유 비즈니스 계정, 테스터가 몇 달간 재사용하는 QA 계정에는 Dedicated Virtual Number(전용 가상 번호)가 더 적합합니다. 이 번호는 미국과 캐나다에서 월 $1.95부터 즉시 구매할 수 있고, 지갑에서 갱신되며, 수신 SMS를 number.sms_received로 웹훅에 전달하고, 언제든 해지할 수 있습니다. 두 국가 밖에서는 셀프서비스 장기 회선이 없으므로 [email protected]으로 문의해 주세요. 자세한 내용은 가상 번호 페이지에 있습니다.

API 없이 대시보드만으로도 가능한가요?

네. 로그인해서 카드 또는 USDT/USDC로 지갑을 충전하고, WhatsApp과 국가를 선택한 뒤 표시된 가격을 확인하고 주문하면 됩니다. 번호를 WhatsApp에 입력하면 코드가 수신되는 대로 활성화 페이지에 나타납니다. 월 이용료나 요금제는 없고, 충전할 때마다 PDF 인보이스가 이메일로 발송되며, 환불 규칙도 API와 같습니다. 연동을 먼저 연습하고 싶은 개발자는 지원팀에 개발 계정을 샌드박스로 전환해 달라고 요청할 수 있습니다. 샌드박스에서는 시뮬레이션된 번호와 코드로 자금을 쓰지 않고 웹훅을 검증할 수 있습니다.

WhatsApp 번호를 책임 있게 사용한다는 것은 무엇인가요?

OTP Route는 자사의 합법적인 제품과 계정을 테스트하고 운영하기 위한 서비스입니다. WhatsApp의 서비스 약관을 지키고, 실제 개인 또는 사업체당 계정 하나만 유지하며, 계정을 대량 등록하거나 원치 않는 메시지를 보내거나 차단된 뒤 다시 돌아오는 용도로 경로를 사용하지 마세요. OTP Route의 이용 정책(Acceptable Use Policy)은 모든 활성화에 적용됩니다. WhatsApp은 해당 소유자의 상표이며, OTP Route는 WhatsApp과 제휴 관계가 없습니다.

자주 묻는 질문

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

네. OTP Gateway 번호가 WhatsApp 가입 SMS를 수신해 코드를 대시보드에 표시하거나 웹훅으로 전달하므로 실물 SIM이 필요 없습니다.

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

GET /api/v1/prices와 POST /api/v1/activations에서 서비스로 whatsapp을 사용하고, in이나 us 같은 국가 ID와 함께 보내세요.

WhatsApp은 모든 가상 번호를 받아 주나요?

아니요. WhatsApp이 가상 번호를 거부할 수 있으며, 그래서 코드를 받지 못한 활성화는 전액 지갑으로 환불됩니다.

나중에 같은 번호로 WhatsApp 계정에 다시 로그인할 수 있나요?

게이트웨이 번호로는 불가능합니다. 코드 한 번만 처리하기 때문입니다. 계정을 다시 인증해야 한다면 미국 또는 캐나다의 Dedicated Virtual Number를 쓰세요.

WhatsApp 인증 번호는 얼마인가요?

가격은 코드당 $0.20부터 시작하며 국가에 따라 다릅니다. 주문 전에 대시보드와 가격 엔드포인트에서 실시간 가격을 확인할 수 있습니다.

CI 파이프라인에서도 WhatsApp SMS 인증 테스트가 가능한가요?

네, 자사 테스트 계정에 한해 가능합니다. 개발 중에는 샌드박스로 구축하고, 실제 경로는 시도 간 백오프를 두어 아껴서 호출하세요.

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