Cómo llevar los códigos SMS etíopes (+251) a tu pipeline de pruebas

¿Qué llamadas de API obtienen un código de verificación etíope?

El enrutamiento OTP para Etiopía se reduce a cinco llamadas HTTP sencillas contra https://otproute.com/api/v1. Autentica cada una con una clave Bearer que empiece por or_live_, generada en la consola de desarrolladores; una cuenta puede tener hasta 10 claves, así que CI, staging y un portátil local pueden funcionar con credenciales separadas.

1. GET /api/v1/countries lista todas las rutas, y Etiopía aparece con el id et.
2. GET /api/v1/services devuelve los ids de servicio, mientras que GET /api/v1/prices?country=et&service=<id> informa del precio y la disponibilidad actuales del par que piensas probar.
3. POST /api/v1/activations con {"service": "telegram", "country": "et"} reserva un número +251 y devuelve un id de activación.
4. Escribe ese número en el campo de teléfono del producto que pruebas y dispara su SMS.
5. Lee el código desde un evento de webhook o consultando GET /api/v1/activations/{id}, y abandona una ejecución limpiamente con POST /api/v1/activations/{id}/cancel.

El inventario se mueve durante el día, así que llama al endpoint de precios en tiempo de ejecución en lugar de fijar nada en el código. Un rápido GET /api/v1/balance antes de iniciar la suite permite que un trabajo se detenga pronto cuando el monedero se queda corto. Los formatos de solicitud y respuesta de esta API de verificación por SMS están en la documentación para desarrolladores.

¿Cómo configuro un webhook firmado para activaciones +251?

Consultar sirve para una sola prueba, pero los trabajos en paralelo son más fáciles de razonar cuando los eventos te llegan empujados. Registra hasta 5 endpoints de webhook por cuenta y suscríbete a activation.sms_received, activation.expired y activation.cancelled.

Cada solicitud lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcula HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, compara el resultado con v1 mediante una comprobación en tiempo constante y rechaza la llamada si la marca de tiempo es antigua. Verifica sobre los bytes sin procesar antes de que ningún analizador JSON los toque.

Asume que un evento puede entregarse más de una vez: usa el id de activación como clave del manejador y descarta las repeticiones, para que un evento reintentado nunca rellene dos veces un campo OTP. Si te quedas con la consulta periódica, un intervalo de unos pocos segundos encaja cómodamente dentro del límite de 300 solicitudes por minuto. Nuestra guía sobre cómo proteger los webhooks OTP con HMAC incluye un manejador de referencia.

¿Qué servicios pueden recibir códigos SMS OTP de Etiopía ahora mismo?

La ruta de Etiopía lista actualmente más de 1,700 servicios. Entre las entradas populares de la instantánea en vivo están WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, imo y Netflix.

Toma esa lista como una instantánea. La disponibilidad de cada servicio puede cambiar en cuestión de horas, y por eso la API la informa en vivo en lugar de una tabla estática. Consulta los endpoints de países y precios al inicio de cada ejecución, y busca en el catálogo completo del panel si necesitas algo menos común.

¿Qué deben saber los equipos de QA sobre los formatos +251 y el idioma de los SMS?

Un número etíope en E.164 es +251 seguido de nueve dígitos. En el ámbito nacional se marca un 0 inicial delante de esos nueve dígitos, así que los usuarios suelen escribir 09… en tu formulario. Quita ese cero troncal, antepón +251 y guarda la cadena E.164 canónica, mostrando el estilo local solo en la interfaz. Cubre ambas entradas, además de espacios y guiones, porque la validación del campo de teléfono es donde se esconden muchos errores de registro.

El amhárico es la lengua federal de trabajo y se escribe en escritura etiópica (ge'ez), mientras que el afaan oromo, el tigriña y el somalí se usan ampliamente en sus regiones. La mayoría de los servicios internacionales envían los códigos en inglés, pero una plantilla localizada puede llegar en amhárico. Extrae los dígitos con un patrón en lugar de buscar las palabras circundantes y asegúrate de que tus registros guardan UTF-8 sin problemas.

Los equipos suelen probar esta ruta al lanzar una app para usuarios etíopes, al revisar una localización en amhárico o al atender a clientes de la diáspora que se registran con un número de su país. Si tu producto muestra fechas, el calendario propio de Etiopía es un caso de localización aparte que merece añadirse. La página de pruebas de QA muestra cómo otros equipos estructuran estas suites.

¿Puede una persona no desarrolladora obtener un número de verificación de Etiopía desde el panel?

Sí. Los responsables de producto y el personal de soporte pueden ejecutar el mismo flujo sin escribir código:

1. Crea una cuenta con tu correo y un código de 6 dígitos, o con el inicio de sesión de Google, y activa después la verificación en dos pasos TOTP.
2. Añade fondos al monedero.
3. Elige Etiopía, selecciona el servicio y revisa el precio mostrado antes de confirmar.
4. Pega el número +251 en la app que estás verificando.
5. Mantén abierta la activación; el código se muestra allí en cuanto se recibe.

Muchos equipos usan esta vía para comprobaciones puntuales mientras los ingenieros recorren la misma ruta por la API.

¿Qué pasa cuando el código +251 nunca aparece?

Cada activación permanece abierta 20 minutos. Solo pagas si llega el código; si la ventana se cierra sin SMS, o cancelas, el importe completo vuelve automáticamente al monedero.

Cuando no llega nada:

• Deja correr la ventana antes de darlo por fallido, ya que el tiempo depende del servicio y de la ruta.
• Reintenta más tarde, o cambia a otra ruta de servicio si tu caso de prueba lo permite.
• Confirma que el servicio acepta números virtuales. Algunos los rechazan, y el reembolso existe precisamente para esa situación.
• No repitas el pedido en bucle rápido. Espacia los reintentos y registra cada id de activación para que los patrones se hagan visibles.

El artículo sobre cómo reducir las entregas de OTP fallidas enumera más comprobaciones.

¿Existe una línea etíope de largo plazo y cómo se gestiona la facturación?

OTP Route no tiene un número de largo plazo con autoservicio en Etiopía. Los Números Dedicados, líneas que conservas mientras se renuevan, son un producto de Estados Unidos y Canadá desde $1.95/month. Si tu equipo necesita una línea +251 duradera, escribe a [email protected] para preguntar; la disponibilidad depende de la normativa local y no está garantizada.

Las activaciones en Etiopía se cargan a un único monedero prepago en USD, sin cuota mensual ni plan que elegir. Recárgalo con tarjeta o con stablecoins USDT/USDC; tras cada recarga llega una factura en PDF a tu bandeja de entrada. Antes de gastar fondos reales en una integración nueva, solicita el modo sandbox para una cuenta de desarrollo: devuelve números y códigos simulados para que puedas ejercitar todo el flujo de extremo a extremo.

Los números de prueba etíopes de OTP Route sirven para verificar productos y cuentas que tu organización posee de verdad; los términos de cada servicio siguen aplicándose, igual que nuestra Política de Uso Aceptable.

Preguntas frecuentes

¿Puedo probar el registro etíope de mi app sin una SIM local?

Sí. Pide un número +251 para tu servicio en el OTP Gateway, introdúcelo en tu app y lee el código en el panel o mediante la API. Solo se te cobra si llega el código.

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

Es et. Envía et como campo country al crear una activación etíope y al consultar precios.

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

Los códigos empiezan desde $0.20 por código. El importe exacto de cada servicio lo devuelve GET /api/v1/prices y se muestra en el panel antes de pedir.

¿Debo guardar los números etíopes con el cero inicial?

No. Conserva la forma E.164, +251 más nueve dígitos, y elimina el 0 nacional siempre que un usuario lo escriba. Aplica el formato local solo en pantalla.

¿Llegarán los textos de verificación etíopes en amhárico?

Normalmente llegan en inglés, aunque un servicio puede usar una plantilla en amhárico con escritura etiópica. Extrae los dígitos y no las palabras, para que valgan ambas versiones.

¿Puedo conservar un número etíope para inicios de sesión posteriores?

No mediante autoservicio, porque un número de un solo uso cubre un único código. Para una cuenta que deba volver a iniciar sesión, encaja un Número Dedicado de EE. UU. o Canadá, o puedes escribir a soporte para preguntar por Etiopía.

¿Hay forma de probar la API OTP de Etiopía sin gastar fondos del monedero?

Sí. Pide el modo sandbox en una cuenta de desarrollo y devolverá números y códigos simulados, para que pruebes la integración de extremo a extremo.

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.