Probar registros con +994 cuando nadie en el equipo tiene una SIM azerbaiyana

Nuestro producto sale en Bakú y el paso de verificación bloquea todas las pruebas. ¿Qué opciones hay?

Es un punto habitual para los equipos que añaden Azerbaiyán a una app existente. La pantalla del teléfono acepta +994, el texto localizado está listo, y entonces QA se detiene porque la única SIM azerbaiyana pertenece a un colaborador en otra zona horaria. Tomar prestado el teléfono personal de un compañero funciona una vez, pero vincula una cuenta de prueba a un número privado y no puede ejecutarse dentro de un pipeline.

OTP Gateway elimina ese cuello de botella. Pides un número +994 para un único código, lo usas en tu propia pantalla de registro o inicio de sesión y recoges el SMS sin que nadie tenga hardware. Cada número sirve para una verificación, lo que mantiene limpios los datos de prueba y los teléfonos personales fuera de las cuentas de empresa. Los equipos que lo hacen cada sprint suelen combinarlo con el flujo de pruebas de QA.

¿Qué apps pueden entregar códigos a una ruta de Azerbaiyán ahora mismo?

La instantánea en vivo de Azerbaiyán lista más de 1.600 servicios. Entre los populares están WhatsApp, Telegram, Viber, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Signal y Amazon.

La disponibilidad no es fija. Las rutas se abren y se cierran durante el día a medida que nuestros socios de red rotan la capacidad, así que un servicio visible por la mañana puede faltar por la tarde. En lugar de fijar una lista en el código, léela de la API antes de cada ejecución y omite sin errores las combinaciones que no se ofrezcan.

¿Cómo integramos la API OTP de Azerbaiyán en una suite automatizada?

Todas las llamadas van a https://otproute.com/api/v1 con una clave Bearer de la consola de desarrollador; las claves empiezan por or_live_, y una cuenta puede tener hasta 10. El id de país de Azerbaiyán es az.

1. Obtén el catálogo con GET /api/v1/services y GET /api/v1/countries, y luego confirma la combinación con GET /api/v1/prices?country=az&service=<id>.
2. Crea el pedido con POST /api/v1/activations y un cuerpo como {"service": "viber", "country": "az"}. Guarda el id de activación de la respuesta.
3. Escribe el número +994 devuelto en la compilación bajo prueba.
4. Espera activation.sms_received en tu webhook, o sondea GET /api/v1/activations/{id} si el trabajo se ejecuta donde el tráfico entrante está bloqueado.
5. Libera lo que se abandone con POST /api/v1/activations/{id}/cancel.

Las llamadas de webhook llevan X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcula HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, compara en tiempo constante y descarta las marcas de tiempo antiguas; la guía de seguridad de webhooks lo explica paso a paso. El límite de 300 solicitudes por minuto deja mucho margen para trabajos en paralelo.

¿Puede alguien ajeno a ingeniería obtener un código +994 a mano?

Sí. Los responsables de producto, los traductores y los líderes de soporte suelen necesitar un solo código para revisar una pantalla, y el panel lo cubre sin ninguna clave de API:

• Inicia sesión y abre OTP Gateway.
• Elige Azerbaiyán, luego el servicio que estás probando, y lee el precio en vivo.
• Pide el número y pégalo en tu app.
• Mantén abierta la página de la activación; el SMS aparece ahí en cuanto se entrega.

Si la prueba se cancela, cancela la activación y el importe vuelve directo al monedero.

¿Cómo debe almacenar y normalizar nuestro backend los números +994?

Guarda cada número en formato E.164, por ejemplo +994 seguido del número nacional de nueve dígitos. Dentro del país se marca un 0 troncal antes del código del operador, así que un formulario de registro recibirá ambos estilos. Elimina espacios, guiones y ese 0 nacional, y luego antepón el código de país antes de guardar. Una biblioteca de análisis mantenida es más segura que una expresión regular escrita a mano.

El azerbaiyano es el idioma oficial y usa un alfabeto latino con letras como ə, ğ, ı, ş y ç; el ruso también se entiende ampliamente. Según el servicio y la configuración regional del dispositivo, un código puede llegar en azerbaiyano, ruso o inglés. Eso hace que las rutas +994 sean útiles para comprobar que tus propias plantillas de SMS muestran bien los caracteres especiales y que un analizador de códigos no depende de redacciones en inglés.

El código no apareció. ¿Qué probamos antes de escalar?

Empieza dejando que la activación corra sus 20 minutos completos; algunos emisores ponen los mensajes en cola. Si no llega nada, el pedido expira, se dispara activation.expired y el importe completo se reembolsa automáticamente, así que solo pagas si llega el código.

Después repasa las causas habituales:

• Algunos servicios rechazan los números virtuales en ciertos flujos. Confirma que el servicio los acepta antes de culpar a la ruta.
• Inténtalo de nuevo más tarde, o cambia a otra ruta de servicio que ejercite la misma pantalla.
• Evita volver a pedir en un bucle rápido; espera entre intentos para que una ráfaga de fallos no sature la cola.

La lista de comprobación de entregas fallidas cubre más diagnósticos.

¿Hay una línea azerbaiyana de larga duración y cómo se factura el uso?

No existe un número dedicado de autoservicio para Azerbaiyán. Los números dedicados son un producto de Estados Unidos y Canadá desde $1.95/mes; si necesitas una línea +994 permanente, escribe a [email protected] y el equipo comprobará qué permite la normativa local, sin ninguna promesa de disponibilidad. Para cuentas que necesitan inicios de sesión repetidos, una línea de EE. UU. o Canadá es la alternativa.

Para las pruebas en Bakú, el gasto sale de un único monedero prepago en USD; no hay nivel de suscripción ni cargo mensual. Recarga con tarjeta o con USDT o USDC, y cada recarga genera una factura en PDF por correo; las tarifas actuales están en la página de precios. Una cuenta de desarrollo puede pasarse a sandbox a petición, devolviendo números y códigos simulados para que la integración se pruebe de extremo a extremo antes de gastar fondos reales. La Política de uso aceptable de OTP Route y las condiciones de cada servicio se aplican a todos los pedidos.

Preguntas frecuentes

¿Puedo probar el flujo de registro azerbaiyano de mi app sin una SIM local?

Sí. Pide un número +994 en OTP Gateway, introdúcelo en tu app y lee el código en el panel o mediante la API, sin ninguna SIM física.

¿Cuál es el id de país de Azerbaiyán en la API de OTP Route?

Usa az en el campo country de POST /api/v1/activations y en las consultas de precio.

¿Cuánto cuesta un número +994 para pruebas?

Los códigos empiezan en $0.20 por código; el importe exacto depende del servicio y GET /api/v1/prices lo devuelve antes de que te comprometas.

¿Me cobran si el SMS azerbaiyano nunca llega?

No. Si no llega ningún código en 20 minutos, o cancelas antes, el importe completo se devuelve a tu monedero automáticamente.

¿Debemos guardar los números azerbaiyanos con el cero inicial?

No. Elimina el 0 troncal nacional y guarda el número en formato E.164 que empiece por +994.

¿Puedo conservar el mismo número de verificación de Azerbaiyán para inicios de sesión posteriores?

No mediante OTP Gateway, que emite un número por código. Las líneas de larga duración de autoservicio existen solo en EE. UU. y Canadá; consulta a soporte sobre Azerbaiyán.

¿En qué idioma llegarán los mensajes de verificación de Azerbaiyán?

Depende del emisor y de la configuración del dispositivo; el azerbaiyano, el ruso y el inglés son todos habituales.

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.