Recibir códigos SMS de X (Twitter): una lista de comprobación para equipos de producto y QA

¿Para qué pide X un número de teléfono?

X usa los números de teléfono en unos cuantos lugares conocidos: como alternativa al correo electrónico en el registro, al añadir un número a una cuenta existente, durante los desafíos de inicio de sesión provocados por una actividad que parece inusual, en el restablecimiento de contraseña y en la autenticación de dos factores por mensaje de texto. A lo largo de los años X ha reducido qué cuentas pueden usar el segundo factor por SMS y ofrece las aplicaciones de autenticación como opción, así que revisa los ajustes actuales de la cuenta que pruebas. Cada uno de estos flujos envía un código numérico corto, y cada uno merece cobertura si tu producto se integra con cuentas de X o las gestiona. Casos típicos son una herramienta de redes sociales que incorpora cuentas de marca, una agencia que gestiona perfiles de clientes desde un acceso de equipo compartido y una suite de QA que comprueba cómo se comporta tu aplicación después de que un usuario vincule un perfil de X.

Lista de comprobación previa para probar la verificación por SMS de X (Twitter)

• Titularidad. La cuenta es tuya, de tu empresa o de un cliente que te pidió gestionarla. Una cuenta por persona o empresa reales.
• Condiciones. Lee las normas de X sobre números de teléfono y automatización; se aplican además de nuestra Política de Uso Aceptable.
• País. Decide qué mercado representa la cuenta antes de pedir.
• Id de servicio. En OTP Route el id de servicio de X es twitter.
• Infraestructura. Una clave Bearer (or_live_) y un bucle de polling o un endpoint de webhook.
• Vida útil. ¿Necesitará esta cuenta volver a iniciar sesión dentro de un mes? Si es así, lee la sección de la línea dedicada antes de empezar.

¿De cuál de los 198 países debe ser el número?

La ruta de X cubre 198 países, entre ellos Estados Unidos, Canadá, Reino Unido, Alemania, Francia, India, Indonesia, Filipinas, Japón, Brasil, México, Turquía, Arabia Saudí, Kenia, Nigeria y Ghana. Haz coincidir el número con el mercado al que sirve la cuenta o con el caso de prueba que demuestras: una cuenta de marca regional debe llevar un número de su región, y una prueba de localización necesita el idioma y el formato de número de ese país. Un desajuste entre número, ubicación de la IP y perfil es además el tipo de señal que puede provocar comprobaciones adicionales por parte de X.

Pasos: pedir un número para X a través de la API

URL base: https://otproute.com/api/v1.

1. Consulta el precio de tu combinación con GET /api/v1/prices?country=<id>&service=twitter, que también confirma la disponibilidad en vivo.
2. Crea el pedido: POST /api/v1/activations con {"service": "twitter", "country": "<id>"}. Guarda el id de activación.
3. Introduce el número devuelto en el campo de teléfono de X.
4. Recoge el código del evento de webhook, o consulta GET /api/v1/activations/{id} hasta que aparezca.
5. Si X rechaza el número, libéralo con POST /api/v1/activations/{id}/cancel.

Los ids de país salen de GET /api/v1/countries; la documentación de la API muestra las formas de solicitud y respuesta.

¿Cómo debe construirse el receptor de webhooks?

Suscríbete a activation.sms_received, activation.expired y activation.cancelled. Cada entrega lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>; calcula HMAC-SHA256 sobre la marca de tiempo, un punto y el cuerpo sin procesar con el secreto del endpoint, compara en tiempo constante y rechaza las marcas de tiempo antiguas. Como las entregas pueden repetirse, guarda los ids de activación procesados e ignora los duplicados. El polling es un buen plan B para suites pequeñas, muy por debajo de 300 solicitudes por minuto. La guía de HMAC incluye un ejemplo práctico.

¿Prefieres hacer clic? En el panel, abre OTP Gateway, elige X y un país, confirma el precio mostrado, pega el número en X y observa cómo aparece el código junto al pedido.

Resolución de problemas: X no envió ningún código

• El número fue rechazado. X puede rechazar números virtuales, a veces con un mensaje de que el número no puede usarse. Cancela y reintenta más tarde o con otro país.
• Todavía no ha llegado nada. Deja abierta la ventana de 20 minutos en lugar de volver a pedir de inmediato.
• X está limitando. Las solicitudes repetidas desde una cuenta pueden activar los límites propios de X; espacia los intentos.
• Tu controlador lo descartó. Revisa en tus registros los fallos de firma y los errores.
• La cuenta está marcada. Si X ha restringido la propia cuenta, un número nuevo no lo cambiará; resuélvelo por los canales de soporte de X.

La regla de reembolso elimina el coste del fallo: solo pagas si el código llega, y las activaciones caducadas o canceladas devuelven el importe completo al monedero.

¿Cuándo es mejor una línea dedicada de EE. UU. o Canadá?

Una activación de un solo uso sirve para una única verificación. Una cuenta de empresa que deba superar desafíos de inicio de sesión o recuperar el acceso dentro de unos meses necesita un número que se quede fijo. Los Números Dedicados te lo dan en Estados Unidos y Canadá, desde $1.95/mes: SMS entrantes en el panel y en tu webhook mediante number.sms_received, SMS salientes y llamadas desde el navegador. Compara ambos productos en números virtuales. OTP Route factura todo desde un único monedero prepago, que se recarga con tarjeta o USDT/USDC, con facturas en PDF.

Preguntas frecuentes

¿Cuál es el id de servicio de X (Twitter) en la API de OTP Route?

Es twitter. Úsalo en la solicitud de precios y en el cuerpo de la activación.

¿Puedo recibir un OTP de X sin tarjeta SIM?

Sí, en un número de OTP Gateway de cualquiera de los 198 países, que se muestra en el panel o se envía a tu webhook.

¿Por qué X dijo que mi número de teléfono no puede usarse?

X puede rechazar algunos números virtuales. Cancela la activación para obtener el reembolso y prueba con otro país o más tarde.

¿Cuánto cuesta un código de verificación de X?

Desde $0.20 por código; el precio exacto depende del país y se muestra antes de hacer el pedido.

¿Puedo reutilizar el mismo número para iniciar sesión en X más adelante?

Una activación de un solo uso recibe un código. Para inicios de sesión repetidos usa un número dedicado de EE. UU. o Canadá.

¿Puedo usar OTP Route para crear muchas cuentas de X?

No. Sirve para probar y operar tus propias cuentas y productos legítimos conforme a las condiciones de X.

¿Hay un sandbox para construir la integración?

Sí. Bajo petición, una cuenta de desarrollo puede pasar a sandbox y devolver números y códigos simulados.

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.