테스트와 비즈니스 계정을 위한 Zoho SMS 코드 수신

상황: Zoho 화면이 휴대폰 번호를 요구합니다

팀은 몇 가지 정해진 방식으로 이 단계를 만납니다. 연동 개발자는 CRM, Books, Desk에 대한 OAuth 연결을 테스트하려고 새 Zoho 계정이 필요합니다. 에이전시는 고객을 위해 Zoho Mail과 Zoho One을 설정하면서 직원의 개인 휴대폰이 관리자 로그인에 묶이는 것을 원하지 않습니다. QA 리드는 두바이 사용자와 시드니 사용자에게 가입 흐름이 똑같이 동작함을 증명해야 합니다. 어느 경우든 장애물은 같은 문자 메시지 하나이고, 그 메시지가 필요한 사람은 알맞은 국가의 SIM을 손에 쥐고 있는 경우가 드뭅니다.

OTP Route는 그 메시지를 도구가 요청하고, 기다리고, 읽을 수 있는 것으로 바꿔 줍니다.

Zoho는 어디에서 전화번호 인증에 의존하나요?

Zoho는 보통 새 계정을 만들 때 휴대폰 번호를 요구하며, 로그인 시 인증 앱과 함께 두 번째 요소로 SMS를 사용할 수 있습니다. 인증된 번호는 비밀번호를 잃었을 때 계정 복구에도 사용됩니다. 코드를 요청하는 정확한 시점은 제품, 계정의 지역, 관리자가 선택한 보안 설정에 따라 다르므로, 프롬프트가 나타나거나 나타나지 않아도 견디는 테스트를 설계하세요.

Zoho 번호의 국가 고르기

zoho 서비스는 현재 198개 국가에서 라우팅됩니다. 만들거나 테스트하는 계정의 시장에 번호를 맞추세요. 국가는 Zoho가 기대하는 국가 번호, 메시지 언어, 때로는 계정이 배치되는 지역 데이터 센터에 영향을 주기 때문입니다.

자주 선택되는 경로로는 인도, 미국, 영국, 아랍에미리트, 호주, 독일이 있습니다. 목록에는 캐나다, 브라질, 멕시코, 싱가포르, 사우디아라비아, 남아프리카공화국, 네덜란드, 스페인, 프랑스, 일본, 인도네시아, 말레이시아, 케냐도 있습니다. 가용성은 하루 중에도 바뀌므로 실행을 시작할 때 GET /api/v1/countries에서 읽어 오세요.

Zoho 인증 코드 API를 테스트에 연결하기

호출은 https://otproute.com/api/v1로 보내며, Developer 콘솔에서 발급한 Bearer 키를 사용합니다.

1. GET /api/v1/prices?country=<id>&service=zoho로 가격을 조회합니다.
2. activation을 만듭니다: POST /api/v1/activations에 {"service": "zoho", "country": "<id>"}를 보냅니다.
3. 브라우저 자동화가 반환된 번호를 Zoho 양식에 입력하고 코드를 요청하게 합니다.
4. 웹훅 엔드포인트에서 activation id를 키로 하는 activation.sms_received 이벤트를 기다립니다.

핸들러를 안정적으로 만드는 습관이 두 가지 있습니다. 첫째, 엔드포인트 시크릿으로 "<t>.<raw body>"에 대한 HMAC-SHA256을 계산해 X-OTPRoute-Signature를 확인하고 오래된 타임스탬프는 거부하세요. 둘째, 핸들러를 멱등하게 만드세요. activation id를 기록하고 반복 전송은 무시하여 코드가 두 번 제출되지 않게 합니다. 테스트 러너가 인바운드 트래픽을 받을 수 없다면 대신 GET /api/v1/activations/{id}를 폴링하되 분당 300건 이하로 유지하세요. 웹훅 수집 가이드에서 두 패턴을 모두 보여 줍니다.

대시보드에서 직접 처리하기

일회성 설정이라면 OTP Gateway를 열고 Zoho를 선택한 뒤 국가를 고르고, 표시된 가격을 확인하고 확정하세요. 번호를 Zoho에 복사하고 코드를 보내는 버튼을 누른 다음 activation을 열어 둡니다. 코드가 도착하면 화면에 나타납니다. 20분의 시간이 있으며, 아무것도 오지 않거나 취소하면 전액이 지갑으로 돌아옵니다.

Zoho OTP가 도착하지 않을 수 있는 이유

코드가 없는 데는 대개 평범한 원인이 있습니다.

• Zoho는 일부 지역이나 계정 유형에서 가상 번호를 거부할 수 있습니다. 이는 Zoho의 결정이며 환불이 자동인 이유입니다.
• 해당 국가의 경로가 그 순간 혼잡할 수 있습니다. 나중에 다시 시도하거나 테스트에 맞는 다른 국가를 쓰세요.
• 한 브라우저 세션의 반복 요청은 Zoho 자체에서 속도 제한을 받을 수 있으니 시도 간격을 두세요.
• 새 activation을 빠르게 반복 주문해도 도움이 되지 않고 API 사용량만 소모됩니다.

경로가 실패했다고 결론 내리기 전에 창이 만료되도록 기다리세요.

전용 번호가 더 나은 선택인 경우

일회용 activation은 계정을 만들고 테스트하는 데 알맞습니다. 다음 달에 다시 SMS를 요구할 관리자 로그인에는 맞지 않으며, 그 번호는 나중에 내 번호가 아니기 때문입니다. 그런 경우 월 $1.95부터 시작하는 전용 번호는 갱신되는 동안 계속 보유하는 미국 또는 캐나다 번호를 제공하며, 수신 SMS는 대시보드에 표시되고 웹훅으로도 전달됩니다. 전용 번호는 이 두 나라에서만 제공됩니다. 자세한 내용은 가상 번호를 참고하세요.

Zoho 번호를 책임 있게 사용하기

Zoho의 약관을 따르세요. 실제 사람 또는 사업체당 계정 하나를 만들고, OTP Route는 본인의 정당한 제품과 고객 계정을 테스트하고 운영하는 데만 사용하며 가입을 대량 생산하는 데 쓰지 마세요. OTP Route는 Zoho와 제휴 관계가 없고 Zoho라는 이름은 해당 소유자의 상표이며, 모든 activation에는 Acceptable Use Policy가 적용됩니다. 여러 고객을 관리하는 에이전시는 에이전시 솔루션 페이지를 참고하세요.

자주 묻는 질문

API로 Zoho OTP를 받으려면?

서비스 id zoho와 선택한 국가로 activation을 만든 뒤, activation.sms_received 웹훅이나 activation 폴링으로 코드를 읽으세요.

Zoho SMS 인증 테스트에 가상 번호를 써도 되나요?

대체로 가능하지만 경우에 따라 Zoho가 가상 번호를 거부할 수 있습니다. 20분 안에 코드가 오지 않으면 요금이 환불됩니다.

코드 하나를 받는 Zoho 전화번호는 얼마인가요?

코드당 $0.20부터입니다. 국가별 실시간 가격은 가격 엔드포인트가 반환하고 대시보드에도 표시됩니다.

Zoho 테스트 계정에는 어느 국가를 고르면 되나요?

테스트하는 사용자나 시장의 국가를 고르세요. 그러면 국가 번호와 메시지 언어가 실제 사례와 일치합니다.

앞으로의 Zoho 로그인에 같은 번호를 계속 쓸 수 있나요?

일회용 activation으로는 불가능합니다. 나중에 다시 인증해야 하는 계정에는 미국 또는 캐나다 전용 번호가 맞는 선택입니다.

지갑 잔액을 쓰지 않고 흐름을 테스트할 수 있나요?

가능합니다. 요청하면 개발 계정을 샌드박스로 전환해 시뮬레이션된 번호와 코드를 받을 수 있습니다. 자세한 내용은 문서를 참고하세요.

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