Cómo recibir códigos SMS de Truecaller de forma programática

¿Cómo es la cadena de llamadas de la API para Truecaller?

El id de servicio de Truecaller es truecaller, y todas las llamadas siguientes se hacen contra https://otproute.com/api/v1 con una clave Bearer cuyo prefijo es or_live_.

1. GET /api/v1/countries te da los ids de país; guárdalos en caché.
2. GET /api/v1/prices?country=<id>&service=truecaller devuelve el precio actual e indica si hay una ruta abierta ahora mismo.
3. POST /api/v1/activations con {"service": "truecaller", "country": "in"} (o cualquier otro id de país) reserva el número y devuelve un id de activación.
4. Introduce ese número en la app de Truecaller en tu dispositivo de prueba y solicita la verificación.
5. El código llega como evento de webhook activation.sms_received, o consultas GET /api/v1/activations/{id}.
6. Si la prueba se abandona, POST /api/v1/activations/{id}/cancel la reembolsa al instante.

Una cuenta admite 10 claves de API, 5 endpoints de webhook y 300 solicitudes por minuto. La guía de integración de la API cubre los reintentos y los tiempos de espera.

¿Cómo debe tratar el manejador del webhook los eventos de Truecaller?

Cada entrega lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcula HMAC-SHA256 sobre la marca de tiempo, un punto y el cuerpo en bruto de la solicitud con el secreto de tu endpoint, compáralo en tiempo constante y rechaza las marcas de tiempo demasiado antiguas.

Basa todo el procesamiento en el id de activación. Los webhooks pueden reintentarse, así que un manejador que guarda el código dos veces o hace avanzar una prueba dos veces producirá resultados inestables; comprueba si la activación ya está marcada como completa antes de actuar. Trata activation.expired y activation.cancelled como estados terminales que indican a tu ejecutor de pruebas que deje de esperar. El sondeo funciona como alternativa en desarrollo local, donde no hay un endpoint público.

¿Por qué pide Truecaller un número de teléfono?

Truecaller es una app de identificación de llamadas y bloqueo de spam, y el número de teléfono es la cuenta. El registro confirma que el usuario controla el número antes de crear el perfil, y la comprobación se repite cuando la app se reinstala o se traslada a un dispositivo nuevo. En algunos dispositivos la app puede intentar verificar con una llamada en lugar de un SMS. Un número del OTP Gateway solo captura SMS, así que una comprobación basada en llamada no producirá un código en la activación; la ventana simplemente se agota y el monedero se reembolsa.

Entre los motivos legítimos por los que los equipos verifican cuentas de Truecaller están comprobar cómo se etiquetan los números de soporte o de reparto salientes de una empresa para las personas de un mercado concreto, el QA de apps que integran identificación de llamadas y el personal de operaciones que necesita un perfil de trabajo separado de su teléfono personal.

¿Qué países tienen rutas de Truecaller?

La instantánea en vivo muestra rutas de Truecaller en 198 países, entre ellos India, Pakistán, Bangladés, Nigeria, Kenia, Egipto, Indonesia, Sri Lanka, Nepal, Arabia Saudita, los Emiratos Árabes Unidos, Brasil, México, Sudáfrica, el Reino Unido y Estados Unidos.

Elige el país que corresponda al caso de prueba. Las etiquetas de llamada, los reportes de spam y el idioma de la app siguen al mercado, así que una comprobación de cómo aparece tu línea de soporte de Lagos debe usar una ruta nigeriana y no la que resulte más barata. La disponibilidad cambia a lo largo del día; consulta el endpoint de precios antes de cada ejecución.

¿Pueden hacerlo desde el panel quienes no programan?

Sí. Inicia sesión, abre el OTP Gateway, elige Truecaller y un país, confirma el precio mostrado y el número aparece en una tarjeta de activación. Introdúcelo en Truecaller, solicita el código y se mostrará en la misma tarjeta cuando llegue el SMS. La ventana de 20 minutos es visible en la tarjeta. Si no llega ningún código, o si cancelas, el importe completo vuelve automáticamente a tu monedero. Las recargas del monedero funcionan con tarjeta o USDT/USDC, con una factura en PDF por correo para cada una; consulta los precios.

¿Por qué podría no llegar un código de Truecaller?

Causas habituales:

• Truecaller rechazó el número porque lo trata como virtual. Algunos servicios lo hacen; por eso se te reembolsa.
• La app eligió la verificación por llamada en lugar de SMS.
• La ruta estuvo brevemente saturada. Inténtalo más tarde o con otro país que encaje con tu prueba.
• El número se introdujo sin su código de país, o con un 0 de troncal sobrante.

No satures el endpoint de pedidos con un bucle. Espacia los intentos y registra cada id de activación para ver patrones.

¿Cuándo tiene más sentido un número dedicado para Truecaller?

Un número de un solo uso desaparece tras la activación. Si un perfil de Truecaller tiene que volver a verificarse más adelante, por ejemplo el dispositivo de trabajo de un equipo de soporte que se restablece, usa en su lugar un número dedicado. Están disponibles al instante en Estados Unidos y Canadá desde $1.95/month, reciben SMS en el panel y a través del webhook number.sms_received, y se renuevan desde el monedero hasta que los liberes. Consulta números virtuales.

Usa OTP Route solo para tus propias cuentas y productos legítimos: una cuenta por persona o negocio reales, sin denuncias ni cambios de etiqueta contra números de otras personas, y con pleno respeto por los términos de Truecaller y por la Política de uso aceptable de OTP Route. Truecaller es una marca registrada de su titular, y OTP Route no está afiliado a ella.

Preguntas frecuentes

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

Es truecaller. Combínalo con un id de país en GET /api/v1/prices y en el cuerpo de POST /api/v1/activations.

¿Puedo recibir un OTP de Truecaller en un número virtual?

A menudo, pero no siempre; Truecaller puede rechazar números que clasifica como virtuales. Si no llega ningún código en 20 minutos, el cargo se reembolsa automáticamente.

¿Por qué me llamó Truecaller en lugar de enviar un SMS?

En algunos dispositivos la app puede elegir la verificación por llamada. Los números del OTP Gateway solo capturan SMS, así que solicita la opción de SMS si la app la ofrece.

¿Qué país debo elegir para las pruebas de verificación por SMS de Truecaller?

El mercado sobre el que trata tu prueba, ya que las etiquetas de llamada y el idioma siguen al país del número. Comprueba antes la disponibilidad en vivo con el endpoint de precios.

¿Puedo conservar el mismo número de teléfono de Truecaller para inicios de sesión posteriores?

Sí, con un número dedicado en Estados Unidos o Canadá desde $1.95/month. Los números únicos del Gateway no pueden reutilizarse.

¿Cómo evito que las entregas duplicadas de webhook rompan mis pruebas?

Haz que el manejador sea idempotente respecto al id de activación y verifica la firma antes de hacer nada con la carga útil.

¿Está OTP Route afiliado a Truecaller?

No. Truecaller es una marca registrada de su titular; OTP Route proporciona números para probar y operar tus propias cuentas legítimas.

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.