대시보드나 파이프라인에서 탄자니아(+255) SMS OTP 수신하기

동아프리카 진출 팀은 왜 +255 번호로 테스트하나요?

탄자니아는 동아프리카에서 가장 큰 모바일 시장 중 하나이며, 메시징부터 모바일 머니까지 많은 사람들에게 휴대전화가 온라인 서비스에 접속하는 주된 수단입니다. 스와힐리어와 영어가 모두 공용어로 쓰이며 일상 대화에서는 스와힐리어가 우세하기 때문에, 이 시장에 진출하는 제품은 보통 영어와 함께 스와힐리어 인터페이스를 제공합니다.

테스트용으로 +255 번호를 주문하는 대표적인 이유는 다음과 같습니다.

• 스와힐리어 온보딩 화면, 오류 메시지, SMS 안내문이 함께 자연스럽게 읽히는지 확인.
• 마케팅을 시작하기 전에 다르에스살람의 관점에서 출시 전 점검 수행.
• 직원의 개인 SIM을 노출하지 않고 지역 지원 데스크용 회사 비즈니스 계정 인증.

팀들이 이런 점검을 구성하는 방법은 모바일 앱 인증 노트에 설명되어 있습니다.

현재 탄자니아에는 어떤 서비스가 라우팅되나요?

현재 탄자니아에는 OTP Gateway에서 1,600개가 넘는 서비스를 이용할 수 있습니다. 자주 쓰이는 경로로는 WhatsApp, Telegram, Facebook, Instagram, TikTok, Snapchat, X (Twitter), Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, imo, Uber, ChatGPT (OpenAI)가 있습니다.

OTP 라우팅은 서비스별, 국가별로 결정되고 풀은 하루 동안 계속 바뀌므로, 캐시된 목록을 믿지 말고 API에 물어보세요.

API로 탄자니아 코드를 가져오려면 어떻게 하나요?

클라이언트가 https://otproute.com/api/v1을 향하게 하고, Developer 콘솔에서 생성한 or_live_ 접두사의 Bearer 키를 보냅니다. 탄자니아의 국가 id는 tz입니다.

• 조회: GET /api/v1/countries와 GET /api/v1/services로 id를 얻고 캐시해 두세요.
• 가격: GET /api/v1/prices?country=tz&service=<id>는 해당 조합의 실시간 가격을 반환합니다.
• 주문: {"service": "telegram", "country": "tz"}와 함께 POST /api/v1/activations를 호출하면 activation id와 +255 번호가 반환됩니다.
• 수신: activation.sms_received 웹훅을 수신하거나 GET /api/v1/activations/{id}를 폴링하세요.
• 정리: 실행을 중단하면 POST /api/v1/activations/{id}/cancel을 호출하세요.

병렬 CI 작업에서는 공격적인 폴링보다 웹훅이 분당 300회 한도에 더 여유롭습니다. 핸들러는 activation id 기준으로 멱등하게 만들고, 본문을 신뢰하기 전에 X-OTPRoute-Signature HMAC를 검증하세요. 웹훅 캡처 글에서 단계별로 안내합니다. 이 탄자니아 OTP API 흐름은 다른 모든 국가에 쓰이는 SMS 인증 API와 같습니다.

코드를 작성하지 않고는 어떻게 하나요?

대시보드에서 OTP Gateway로 이동해 탄자니아와 서비스를 선택하고 표시된 가격을 확인하세요. +255 번호를 테스트 중인 앱에 복사하면, SMS가 수신되는 즉시 주문 옆에 코드가 나타나고 타이머가 20분 중 남은 시간을 보여 줍니다. 한 달에 한 번 회사 계정을 인증하는 운영 담당자는 보통 이 방법을 씁니다. 브라우저와 충전된 지갑만 있으면 되고, 생성하거나 교체할 API 키도 없기 때문입니다.

탄자니아 전화번호는 어떻게 표기하나요?

탄자니아 국내에서 휴대전화 번호는 트렁크 0을 붙여 다이얼하므로, 현지에서는 07… 또는 06… 뒤에 여덟 자리가 더 이어지는 형태입니다. 국제 형식에서는 0이 빠지고 +255 뒤에 아홉 자리가 오며, 예를 들어 +2557로 시작하는 번호가 됩니다.

E.164 형식으로 저장하고 사용자가 입력하는 값은 정규화하세요. 공백을 제거하고, 앞의 0을 +255로 바꾸고, 00255는 +255로 처리합니다. 한 테이블에 형식이 섞여 있으면 중복 계정과 조회 실패가 생깁니다. 인증 문자는 대부분의 국제 플랫폼에서는 영어로, 일부 현지 발신자나 계정 언어를 스와힐리어로 설정한 경우에는 스와힐리어로 올 것으로 예상하세요.

+255 코드가 도착하지 않았습니다. 이제 어떻게 하나요?

침묵에 대해서는 요금이 청구되지 않습니다. SMS 없이 20분의 시간이 끝나거나 취소하면 전액이 지갑으로 돌아옵니다. 다시 시도하기 전에 흔한 원인을 생각해 보세요. 서비스가 가상 번호를 거부하거나, 그 순간 탄자니아로의 전달이 느리거나, 해당 번호가 그 플랫폼에 맞지 않을 수 있습니다. 시간이 끝날 때까지 기다리고, 나중에 또는 다른 서비스 경로로 다시 시도하되, 빠르게 재주문하는 것은 삼가세요. 전달 실패 가이드에 더 긴 체크리스트가 있습니다.

장기 번호, 지갑, 샌드박스

OTP Route에는 셀프 서비스 방식의 탄자니아 장기 번호가 없습니다. 전용 번호(Dedicated Numbers)는 미국과 캐나다에 한정되며 월 $1.95부터입니다. 지속적인 +255 회선이 필요하면 [email protected]으로 이메일을 보내 주세요. 제공 여부는 현지 규정에 따라 달라집니다.

모든 것은 요금제도 월 요금도 없는 하나의 선불 USD 지갑으로 결제됩니다. 카드와 USDT/USDC 충전을 받으며, 각각 PDF 인보이스가 이메일로 발송됩니다. 개발 계정은 요청 시 샌드박스로 전환할 수 있어, 시뮬레이션된 번호와 코드로 먼저 연동을 테스트할 수 있습니다.

자주 묻는 질문

탄자니아 밖에서도 탄자니아 계정을 인증할 수 있나요?

네. +255 번호는 온라인으로 발급되며, 팀이 어디에 있든 코드는 대시보드에 표시되거나 서버로 전달됩니다.

API는 탄자니아에 어떤 국가 코드를 요구하나요?

가격 조회와 POST /api/v1/activations에서 국가 id로 tz를 사용하세요.

탄자니아 SMS OTP를 받는 데 비용이 얼마나 드나요?

코드당 $0.20부터입니다. 정확한 가격은 서비스에 따라 다르며 GET /api/v1/prices가 실시간으로 반환합니다.

저장하는 번호에 앞자리 0을 남겨야 하나요?

아니요. +255와 아홉 자리 국내 번호를 저장하고, 0으로 시작하는 입력은 들어오는 시점에 변환하세요.

스와힐리어 가입 흐름을 테스트할 수 있나요?

네. 앱이나 테스트 기기를 스와힐리어로 설정하고 OTP Gateway의 +255 번호로 등록한 뒤, 앱이 트리거한 코드를 읽으세요.

코드가 끝내 오지 않으면 돈이 환불되나요?

네. 20분 후 만료되거나 취소된 활성화는 전액 지갑으로 환불됩니다.

탄자니아의 모든 서비스가 이 번호와 호환되나요?

모두는 아닙니다. 일부 플랫폼은 가상 번호를 거부하며, 각 서비스의 약관과 OTP Route Acceptable Use Policy를 준수하셔야 합니다.

지원 팀을 위한 월 단위 탄자니아 회선을 받을 수 있나요?

셀프 서비스로는 안 됩니다. 월 단위 전용 번호는 미국과 캐나다에서만 제공되며, 탄자니아는 팀에 이메일로 문의하세요.

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