Cómo recibir códigos SMS de Zoho para pruebas y cuentas de empresa

La situación: una pantalla de Zoho pide un número de móvil

Los equipos se topan con este paso de formas bastante previsibles. Un desarrollador de integraciones necesita una cuenta de Zoho nueva para probar una conexión OAuth con CRM, Books o Desk. Una agencia configura Zoho Mail y Zoho One para un cliente y no quiere que el teléfono personal de un empleado quede vinculado al inicio de sesión de administrador. Un responsable de QA tiene que demostrar que el flujo de registro se comporta igual para un usuario en Dubái que para uno en Sídney. En cada caso el obstáculo es el mismo mensaje de texto, y quien lo necesita rara vez tiene a mano una SIM del país correcto.

OTP Route convierte ese mensaje en algo que tus herramientas pueden solicitar, esperar y leer.

¿Dónde exige Zoho la verificación telefónica?

Zoho suele pedir un número móvil cuando se crea una cuenta nueva, y puede usar el SMS como segundo factor al iniciar sesión, junto a su app de autenticación. Un número verificado también sirve para recuperar la cuenta cuando se pierde la contraseña. El momento exacto en que se solicita un código depende del producto, de la región de la cuenta y de los ajustes de seguridad que haya elegido un administrador, así que diseña pruebas que toleren que el aviso aparezca o no.

Cómo elegir el país para un número de Zoho

El servicio zoho está enrutado actualmente en 198 países. Ajusta el número al mercado de la cuenta que estás creando o probando, porque el país afecta al prefijo telefónico que espera Zoho, al idioma del mensaje y, a veces, al centro de datos regional donde acaba la cuenta.

Las rutas que se eligen con frecuencia incluyen India, Estados Unidos, Reino Unido, Emiratos Árabes Unidos, Australia y Alemania. Otras de la lista son Canadá, Brasil, México, Singapur, Arabia Saudita, Sudáfrica, Países Bajos, España, Francia, Japón, Indonesia, Malasia y Kenia. La disponibilidad cambia a lo largo del día, así que léela desde GET /api/v1/countries al empezar la ejecución.

Cómo integrar la API de códigos de verificación de Zoho en tus pruebas

Las llamadas van a https://otproute.com/api/v1 con una clave Bearer de la consola de desarrollador.

1. Obtén el precio con GET /api/v1/prices?country=<id>&service=zoho.
2. Crea la activación: POST /api/v1/activations con {"service": "zoho", "country": "<id>"}.
3. Haz que tu automatización del navegador escriba el número devuelto en el formulario de Zoho y solicite el código.
4. Espera el evento activation.sms_received, identificado por el id de activación, en tu endpoint de webhook.

Dos hábitos hacen fiable el handler. Primero, comprueba X-OTPRoute-Signature calculando un HMAC-SHA256 sobre "<t>.<raw body>" con el secreto del endpoint, y rechaza las marcas de tiempo caducadas. Segundo, haz el handler idempotente: registra el id de activación e ignora una entrega repetida, para que el código no se envíe dos veces. Si tu ejecutor de pruebas no puede recibir tráfico entrante, haz polling a GET /api/v1/activations/{id} y mantente por debajo de 300 solicitudes por minuto. La guía de captura por webhook muestra ambos patrones.

Hacerlo a mano desde el panel

Para configuraciones puntuales, abre el OTP Gateway, elige Zoho, selecciona el país, revisa el precio mostrado y confirma. Copia el número en Zoho, pulsa el botón que envía el código y mantén la activación abierta. El código aparece en pantalla cuando llega. Tienes 20 minutos; si no llega nada, o si cancelas, el importe completo vuelve a tu monedero.

Por qué puede no llegar un OTP de Zoho

Un código ausente suele tener una causa corriente:

• Zoho puede rechazar números virtuales en algunas regiones o para ciertos tipos de cuenta. Es decisión suya, y es la razón de que los reembolsos sean automáticos.
• La ruta de ese país puede estar saturada en ese momento. Reintenta más tarde o con otro país que encaje con la prueba.
• Zoho puede limitar por su cuenta las solicitudes repetidas desde una misma sesión del navegador, así que espacia los intentos.
• Crear activaciones nuevas en un bucle rápido no ayuda y consume tu presupuesto de API.

Deja que expire la ventana antes de concluir que una ruta ha fallado.

Cuándo conviene más un número dedicado

Una activación de un solo uso es lo adecuado para crear y probar cuentas. Es la herramienta equivocada para un inicio de sesión de administrador que volverá a pedirte un SMS el mes que viene, porque ese número ya no será tuyo. Para ese caso, un número dedicado desde $1.95/month te da una línea de EE. UU. o Canadá que conservas mientras se renueve, con SMS entrantes en el panel y reenviados a tu webhook. Las líneas dedicadas se ofrecen solo en esos dos países. Más información sobre números virtuales.

Uso responsable de los números de Zoho

Cumple las condiciones de Zoho. Crea una cuenta por persona real o empresa y usa OTP Route para probar y operar tus propios productos y cuentas de clientes legítimos, nunca para fabricar registros en masa. OTP Route no está afiliado a Zoho, cuyo nombre es una marca registrada de su titular, y la Política de Uso Aceptable se aplica a cada activación. Las agencias que gestionan varios clientes pueden leer la página de soluciones para agencias.

Preguntas frecuentes

¿Cómo recibo un OTP de Zoho a través de una API?

Crea una activación con el id de servicio zoho y el país que elijas, y lee el código desde el webhook activation.sms_received o haciendo polling a la activación.

¿Puedo usar un número virtual para la verificación por SMS de Zoho en pruebas?

A menudo sí, pero Zoho puede rechazar los números virtuales en algunos casos. Si no llega ningún código en 20 minutos, el cargo se reembolsa.

¿Cuánto cuesta un número de teléfono de Zoho para un código?

Desde $0.20 por código. El precio en tiempo real por país lo devuelve el endpoint de precios y se muestra en el panel.

¿Qué país debo elegir para una cuenta de prueba de Zoho?

Elige el país del usuario o del mercado que estás probando, para que el prefijo telefónico y el idioma del mensaje coincidan con el caso real.

¿Puedo conservar el mismo número para futuros inicios de sesión en Zoho?

No con una activación de un solo uso. Un número dedicado de EE. UU. o Canadá es la opción para una cuenta que deba verificarse de nuevo más adelante.

¿Puedo probar el flujo sin gastar fondos del monedero?

Sí. Una cuenta de desarrollo puede pasarse a sandbox bajo petición, lo que devuelve números y códigos simulados. Consulta la documentación para más detalles.

Los nombres de los servicios son marcas registradas de sus respectivos propietarios. OTP Route no está afiliado a ellos. Usa los números de forma lícita y respeta las condiciones de cada servicio y nuestra Política de Uso Aceptable.