Cómo elegir una ruta +55 para la verificación por SMS en Brasil

¿Una prueba en Brasil debe usar el OTP Gateway o una línea de largo plazo?

Empieza por la forma del trabajo, porque ella decide el producto. Una prueba de verificación en Brasil suele necesitar un código, una sola vez: una pantalla de registro en portugués, un desafío de inicio de sesión, un paso de cambio de teléfono. Eso es exactamente para lo que está hecho el OTP Gateway. Eliges un servicio y Brasil, recibes un número +55 para un único código, y la activación se cierra a los 20 minutos o cuando llega el SMS.

Una línea de largo plazo es otra historia. Los Dedicated Numbers son un producto de Estados Unidos y Canadá, que se venden al instante desde el panel desde $1.95/mes, con SMS entrantes, SMS salientes y llamadas desde el navegador. No existe un número +55 de largo plazo en autoservicio. Si tu equipo de verdad necesita una línea brasileña que pueda conservar, escribe a [email protected] y describe el caso de uso; que sea posible depende de la normativa local, y no se promete nada.

Una regla práctica rápida:

• Un código por caso de prueba, con estado limpio en cada ejecución: OTP Gateway con br.
• Una cuenta de staging que debe iniciar sesión de nuevo el mes que viene: un Dedicated Number de EE. UU. o Canadá, si el servicio lo acepta.
• Si dudas: lee números temporales frente a dedicados antes de comprar nada.

¿Qué apps pueden enviar códigos a un número brasileño ahora mismo?

La ruta de Brasil cubre actualmente más de 2,900 servicios, y entre los populares de la instantánea en vivo están WhatsApp, Telegram, Google (Gmail y YouTube), Instagram, Facebook, TikTok, Uber, Discord, Microsoft y Outlook, LinkedIn, Netflix, Airbnb, Shopee y AliExpress.

Trata esa lista como una instantánea y no como un contrato. La disponibilidad cambia durante el día a medida que nuestros socios de operadoras añaden y rotan rutas, así que un pipeline debería preguntar a la API en lugar de fiarse de una lista fija. El directorio de países muestra los mismos datos en vivo para quienes prefieren un navegador.

¿Cómo es en la práctica la secuencia de la API OTP de Brasil?

Cada llamada va a https://otproute.com/api/v1 con una clave Bearer con prefijo or_live_, generada en la consola de desarrolladores. El id de país de Brasil es br.

1. Resuelve los ids de servicio una vez con GET /api/v1/services y guárdalos en la configuración.
2. Antes de pedir, llama a GET /api/v1/prices?country=br&service=whatsapp (o tu id de servicio). La respuesta trae el precio y la disponibilidad en vivo de ese par.
3. Crea la activación con POST /api/v1/activations y el cuerpo {"service": "whatsapp", "country": "br"}. Guarda el id de activación junto a tu ejecución de pruebas.
4. Escribe el número +55 en el flujo que estás probando.
5. Escucha el evento activation.sms_received en un webhook; como alternativa, consulta GET /api/v1/activations/{id} cada pocos segundos.
6. Si la prueba se aborta, libera el número con POST /api/v1/activations/{id}/cancel para que los fondos vuelvan de inmediato.

Las entregas de webhook se firman en X-OTPRoute-Signature como t=<unix>,v1=<hex>: un HMAC-SHA256 de <t>.<raw body> con el secreto del endpoint. Verifícalo, descarta las marcas de tiempo antiguas y haz el manejador idempotente respecto al id de activación. La referencia completa está en la documentación de la API.

¿Puede alguien del equipo de growth hacerlo sin código?

Sí. El panel ejecuta el mismo enrutamiento OTP sin ninguna programación:

1. Crea una cuenta con tu correo y un código de 6 dígitos por correo, o con inicio de sesión de Google.
2. Añade fondos al monedero en USD.
3. Elige Brasil y el servicio, revisa el precio que se muestra y haz el pedido.
4. Pega el número +55 en la app y observa cómo aparece el código en la tarjeta de activación.

Marketing, soporte y revisores de localización suelen usar esta vía para confirmar que una pantalla de alta en portugués se comporta bien antes de un lanzamiento, mientras los ingenieros reservan la API para las ejecuciones automatizadas.

¿Cómo deben almacenarse y normalizarse los números +55?

Los números brasileños llevan un código de área de dos dígitos (DDD) seguido del número de abonado, y los móviles tienen nueve dígitos que empiezan por 9. Dentro de Brasil, para llamadas de larga distancia se marca un 0 inicial más un código de selección de operadora, por lo que la entrada del usuario suele contener dígitos de más que no deben almacenarse.

Guarda todo en E.164: +55, el código de área y luego el número de abonado, sin espacios, sin 0 inicial y sin código de operadora. Normaliza al recibir la entrada, compara con el valor normalizado y da formato solo para mostrar. Los códigos de remitentes brasileños suelen llegar en portugués, a veces en inglés, así que analiza los dígitos en lugar de buscar una frase fija.

Los equipos prueban este mercado por un lanzamiento brasileño, por el QA de localización al portugués y por flujos de alta que conviven con las obligaciones de la ley de protección de datos de Brasil, la LGPD. Nuestra página de onboarding fintech cubre la parte de verificación de ese trabajo.

¿Y si un código brasileño nunca aparece?

Primero, deja correr la ventana de 20 minutos; algunos remitentes son más lentos que otros, y la entrega depende del servicio y de la ruta. Si vence, el cargo se revierte automáticamente y puedes intentarlo de nuevo un poco más tarde o por otra ruta que liste la API.

• Confirma que el servicio acepta números virtuales. Algunos no, y justo por eso existe la regla de reembolso.
• No repitas el pedido en bucle cerrado. Espera entre intentos y registra cada id de activación.
• Comprueba que tu app envió el número completo en formato internacional, no en un formato local con los dígitos troncales.

La guía sobre cómo reducir las entregas fallidas de OTP enumera más diagnósticos.

¿Cómo encajan el monedero, las facturas y el sandbox?

OTP Route factura desde un único monedero prepago en USD: pago sobre la marcha, sin cuota mensual y sin plan que elegir. Recarga con tarjeta o con USDT o USDC, y cada recarga llega con una factura en PDF por correo. Las tarifas completas están en la página de precios y en la API.

Para el trabajo de integración, pide a soporte que pase una cuenta de desarrollo a sandbox. Devuelve números y códigos simulados, de modo que puedes ejercitar de extremo a extremo la activación y la ruta del webhook sin tocar fondos del monedero. Úsalo solo para tus propios productos, respeta los términos de cada servicio y recuerda que la Política de Uso Aceptable se aplica a todas las cuentas.

Preguntas frecuentes

¿Puedo probar el registro de mi app en Brasil sin una SIM local?

Sí. Pide un número +55 en el OTP Gateway para tu propia app o un servicio compatible, introdúcelo en el flujo y lee el código en el panel o a través de la API.

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

Es br. Pásalo como campo country al crear una activación o como parámetro de consulta country en el endpoint de precios.

¿Me cobran si WhatsApp nunca envía el código a mi número +55?

No. Si ningún SMS llega al número en 20 minutos, o cancelas antes, el importe completo vuelve a tu monedero automáticamente.

¿Puedo comprar un número brasileño y conservarlo durante meses?

No como producto de autoservicio. Los Dedicated Numbers de largo plazo solo se venden para Estados Unidos y Canadá; para Brasil puedes escribir a [email protected] para consultarlo, sin promesa de disponibilidad.

¿Debo guardar el cero inicial de un número brasileño?

No. Elimina el 0 troncal y cualquier código de selección de operadora, y guarda el número en formato E.164, que empieza por +55 y el código de área de dos dígitos.

¿En qué idioma llegan los mensajes de verificación de Brasil?

La mayoría llega en portugués, y unos pocos servicios globales envían texto en inglés. Extrae el código numérico en lugar de depender de la redacción.

¿Puedo probar la API antes de recargar el monedero?

Pide el modo sandbox en una cuenta de desarrollo. Simula números y códigos para que la integración completa pueda probarse sin gastar fondos del monedero.

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.