Claude Code puede integrar por ti la verificación por SMS en tu proyecto: dale la skill de la API de SMS Activate App, guarda tu clave de API en una variable de entorno y revisa cada paso que gaste dinero.
Con esta guía lo configuras en unos diez minutos. Funciona igual con Codex, Cursor o cualquier agente de programación que lea archivos y ejecute comandos.
Qué puede hacer el agente con la API
Con una clave, un agente de programación puede hacer todo lo que hace tu propio código:
- Buscar números disponibles en un país y consultar tu precio.
- Comprar un número privado para un plazo de 28 días, con una Idempotency-Key para que un reintento nunca cobre dos veces.
- Leer los SMS que llegan a ese número y las llamadas: desde noviembre de 2026, una llamada corta llega con su texto y el código que se dicta en ella.
- Liberar un número o desactivar su renovación.
- Configurar un webhook para que los códigos lleguen a tu servidor sin consultar de forma periódica.
Tareas típicas para delegar: una prueba de extremo a extremo de tu flujo de registro, una función auxiliar que espere un código en CI o un receptor de webhooks con comprobación de firma.
Paso 1: crea una clave y mantenla fuera del código
- Crea una cuenta en la página de registro y añade saldo.
- Crea una clave de API personal en la pestaña de claves de API de tu cuenta o en el bot de Telegram.
- Guarda la clave en tu shell o en el almacén de secretos del proyecto, nunca en un archivo del que el agente haga commit:
La clave gasta tu saldo. Claude Code lee la variable cuando ejecuta un comando; no necesita ver el valor en el chat. Si la clave llega alguna vez a un archivo, a un commit o a un registro, revócala en tu cuenta y crea una nueva.
Paso 2: dale la skill a Claude Code
El sitio publica un archivo de skill listo para agentes de programación en /api-skill.md. Indica la URL base, las rutas, los límites y los errores que debes gestionar. Guárdalo como skill del proyecto:
Claude Code carga una skill cuando una tarea coincide con su descripción, por ejemplo «espera el código SMS en mi prueba de registro». Haz commit del archivo de skill si tu equipo debe compartirlo; no contiene ninguna clave.
¿Tu agente no admite skills? Abre la documentación de la API y pulsa el botón que copia el prompt para agentes. Contiene las mismas reglas en un único bloque de texto que puedes pegar en cualquier chat.
Paso 3: fija las reglas del proyecto
Añade unas líneas al CLAUDE.md de tu proyecto para que todas las sesiones las sigan:
La segunda regla es la más importante. Una compra es definitiva y no reembolsable en cuanto se emite un número, así que una persona debe ver cada una antes de que ocurra. Claude Code pide permiso antes de ejecutar un comando; mantén esa opción activada para los comandos que llaman a la ruta de compra.
Paso 4: encárgale una tarea
Pide el resultado, no las llamadas a la API. Por ejemplo:
Añade un fixture de pytest que alquile un número de EE. UU. a través de la API de SMS Activate App, espere hasta cinco minutos a que llegue un SMS a ese número y devuelva el código. Reutiliza entre ejecuciones un único número que se renueva en lugar de comprar uno nuevo cada vez.
Un buen resultado tiene este aspecto:
- Busca con GET /v1/public/numbers/search?country=US y te muestra el número y su precio antes de comprar.
- Compra con POST /v1/public/numbers y una Idempotency-Key.
- Consulta GET /v1/public/numbers/{id}/sms cada 5 a 15 segundos con un tiempo máximo de espera, o configura un webhook.
- Trata insufficientbalance, numberunavailable y rate_limited como respuestas, no como errores que detienen la ejecución.
Si inventa una ruta que no está en la skill, indícale el archivo OpenAPI y pídele que la compruebe.
Paso 5: revisa antes de hacer merge
Antes de hacer merge de lo que ha escrito el agente, comprueba cuatro cosas:
- Que no haya ninguna clave en el diff, en la salida de las pruebas ni en los registros de CI.
- Que cada compra envíe una Idempotency-Key y que un reintento la reutilice.
- Que cada espera tenga un tiempo máximo y un mensaje de error claro que nombre el número.
- Que la prueba no compre un número nuevo en cada ejecución cuando bastaría con uno que se renueve.
Costes que debes conocer
Cada número se alquila por 28 días al precio que muestra la búsqueda y se renueva con cargo al saldo mientras la renovación automática esté activada. Desde noviembre de 2026, las llamadas entrantes (por minuto) y los SMS de un número también se cobran del saldo, a un precio por país que la API devuelve como usagePricing. Consulta los precios para ver las cifras actuales antes de dejar que un agente ejecute una batería de pruebas de forma programada.
Cuándo no usarla
La API recibe SMS y llamadas; no los envía. Úsala para tus propias aplicaciones, cuentas y pruebas. La plataforma con la que verificas, no nosotros, decide si acepta un número. Por eso, comprueba un número con tu servicio de destino antes de montar un flujo sobre él: cómo comprobar un número antes de alquilarlo.
Siguientes pasos
- El flujo completo en Python y curl: automatiza la verificación por SMS con la API.
- Códigos de llamadas y webhooks: recibe códigos por SMS y por llamada con webhooks.
- La referencia: documentación de la API, archivo OpenAPI, skill para agentes.