Recibir códigos de verificación de WhatsApp sin ocupar el teléfono de un empleado

¿Por qué un equipo acaba necesitando un número de WhatsApp que no pertenece a nadie en particular?

La situación es conocida. Un equipo de producto está montando un flujo de soporte en WhatsApp, o probando cómo su aplicación deriva a los usuarios a un chat, y alguien tiene que registrar una cuenta. La opción más rápida es el móvil de un compañero. Eso ata una configuración empresarial a la SIM de un solo empleado, mezcla el tráfico de pruebas con sus conversaciones privadas y deja de funcionar el día que se marcha.

Las agencias que configuran WhatsApp para sus clientes se topan con el mismo obstáculo, igual que los ingenieros de QA que necesitan una cuenta de prueba en un mercado concreto para ver cómo se comporta un onboarding regional. Un número de teléfono de WhatsApp de OTP Gateway mantiene ese trabajo fuera de las líneas personales: eliges el país, recibes el código de registro y sigues adelante.

¿Cuándo pide WhatsApp un código de verificación por teléfono?

WhatsApp identifica cada cuenta por su número de teléfono, así que comprueba que controlas ese número con un código de un solo uso en varios momentos:

• Registro: una cuenta nueva recibe por SMS un código de seis dígitos, y WhatsApp puede ofrecer una llamada de voz como alternativa.
• Dispositivo nuevo: reinstalar la aplicación o pasar a otro teléfono repite la comprobación, y el teléfono anterior se desconecta.
• Cuentas de empresa: configurar WhatsApp Business con un número pasa por el mismo paso.
• Verificación en dos pasos: un PIN opcional que elige el usuario. Nunca se envía por SMS, pero se solicita junto con el código cuando está activado.

Para las pruebas la conclusión es sencilla: el SMS demuestra que posees el número en ese momento, así que un número que ya no tienes no puede verificar la cuenta más adelante.

¿Cómo funciona el flujo de la API de códigos de verificación de WhatsApp?

Usa el id de servicio whatsapp junto con el id de país del mercado que pruebas, como in, br o us. Con una clave Bearer de la consola de desarrolladores:

1. GET /api/v1/prices?country=<id>&service=whatsapp devuelve el precio en vivo y si esa ruta está abierta ahora mismo.
2. POST /api/v1/activations con {"service": "whatsapp", "country": "<id>"} reserva un número y abre la ventana de 20 minutos.
3. Introduce el número en la pantalla de registro de WhatsApp y solicita el SMS.
4. El código te llega como evento de webhook activation.sms_received, o bien consultas GET /api/v1/activations/{id} cada pocos segundos.
5. Si la prueba se abandona, POST /api/v1/activations/{id}/cancel devuelve el importe al monedero.

Verifica X-OTPRoute-Signature antes de fiarte del cuerpo: calcula HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, compáralo con v1 y rechaza las marcas de tiempo demasiado antiguas. Después registra el evento junto a su id de activación para que una entrega repetida no cambie nada. El polling es la opción más sencilla cuando un ejecutor de pruebas no puede exponer una URL pública; la documentación para desarrolladores describe ambos caminos.

¿En qué países hay números de WhatsApp y importa cuál elijas?

Las rutas de WhatsApp están disponibles actualmente en 198 países, entre ellos India, Brasil, Indonesia, Nigeria, Alemania, México, Reino Unido, Estados Unidos, Pakistán, Filipinas, Egipto, Kenia, España, Turquía y Sudáfrica. El conjunto completo está en la página de países.

Elige el país con criterio. Si tu flujo de onboarding se dirige a usuarios brasileños, un número +55 te muestra cómo tu aplicación da formato, valida y presenta un número local. Si la cuenta de empresa va a atender a un solo mercado, usa ese mercado. Un país al azar no ahorra nada y puede dejar el resultado de la prueba sin valor.

¿Por qué puede no llegar el código de WhatsApp?

WhatsApp decide a qué números envía mensajes y puede rechazar de plano un número virtual para el registro. Cuando eso ocurre, no llega nada a la activación, la ventana se cierra y el importe completo vuelve a tu monedero; solo pagas cuando el código llega de verdad. Otras causas son más corrientes: una ruta saturada, que WhatsApp te pida esperar antes de solicitar otro código, o que el código se haya pedido por llamada de voz en lugar de SMS.

Qué hacer:

• Deja la activación abierta durante toda su ventana en lugar de cancelarla al minuto.
• Comprueba que la pantalla de registro haya solicitado un SMS y no una llamada.
• Reintenta más tarde, o prueba otra ruta de país si el mercado de la cuenta lo permite.
• Espacia los intentos. Pedir código tras código en un bucle rápido suele empeorar las cosas.

¿Una cuenta de WhatsApp de larga duración debería usar un número dedicado?

Normalmente, sí. Un número de OTP Gateway sirve para un solo código, y si la cuenta debe verificarse de nuevo tras cambiar de teléfono o reinstalar, necesitas ese mismo número. Para una línea de soporte, una cuenta de empresa compartida o una cuenta de QA que los testers reutilizan durante meses, encaja mejor un Número Virtual Dedicado. Se venden al instante en Estados Unidos y Canadá desde $1.95/mes, se renuevan desde el monedero, reenvían los SMS entrantes a tu webhook como number.sms_received y pueden liberarse en cualquier momento. Fuera de esos dos países no hay una línea de largo plazo de autoservicio; escribe a [email protected] para consultarlo. Los detalles están en la página de números virtuales.

¿Puede hacerlo desde el panel alguien sin acceso a la API?

Sí. Inicia sesión, recarga el monedero con tarjeta o con USDT/USDC, elige WhatsApp y un país, confirma el precio que se muestra y haz el pedido. Escribe el número en WhatsApp y el código aparecerá en la página de la activación en cuanto se reciba. No hay cuota mensual ni plan, cada recarga incluye una factura en PDF por correo electrónico y se aplica la misma regla de reembolso que en la API. Los desarrolladores que quieran ensayar primero una integración pueden pedir a soporte que ponga una cuenta de desarrollo en sandbox, donde los números y códigos simulados permiten probar el webhook sin gastar fondos.

¿Qué se considera un uso responsable de los números de WhatsApp?

OTP Route existe para probar y operar tus propios productos y cuentas legítimos. Cumple las condiciones del servicio de WhatsApp, mantén una cuenta por persona o empresa reales y no uses las rutas para registrar cuentas en masa, enviar mensajes no solicitados ni volver a la plataforma tras un bloqueo. La Política de Uso Aceptable de OTP Route se aplica a cada activación. WhatsApp es una marca comercial de su titular y OTP Route no está afiliado a ella.

Preguntas frecuentes

¿Puedo recibir un OTP de WhatsApp sin tarjeta SIM?

Sí. Un número de OTP Gateway recibe el SMS de registro de WhatsApp y muestra el código en tu panel o lo envía a tu webhook, sin ninguna SIM física de por medio.

¿Cuál es el id de servicio de WhatsApp en la API?

Usa whatsapp como servicio en GET /api/v1/prices y POST /api/v1/activations, junto con un id de país como in o us.

¿Aceptará WhatsApp cualquier número virtual?

No. WhatsApp puede rechazar números virtuales, y por eso una activación que no recibe ningún código se reembolsa íntegramente a tu monedero.

¿Puedo volver a entrar más tarde en la cuenta de WhatsApp con el mismo número?

No con un número de gateway, que cubre un único código. Si la cuenta tendrá que verificarse de nuevo, usa un Número Virtual Dedicado en EE. UU. o Canadá.

¿Cuánto cuesta un número de verificación de WhatsApp?

Los precios empiezan en $0.20 por código y varían según el país. El precio en vivo aparece en el panel y en el endpoint de precios antes de hacer el pedido.

¿Es posible la verificación por SMS de WhatsApp para pruebas dentro de un pipeline de CI?

Sí, para tus propias cuentas de prueba. Desarrolla contra sandbox y usa después las rutas reales con moderación, dejando un tiempo de espera entre intentos.

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.