Alquiler reutilizable · REST + MCP

Un número que sigue siendo tuyo

Alquila un número privado un día o más y sigue recibiendo mensajes todo ese tiempo. Consulta qué intervalos hay disponibles y cuánto cuestan, compra uno y luego amplíalo si el trabajo se alarga o cancélalo cuando termines.

Conecta tu cliente de IA Ir al inicio rápido de REST
Duración
Un día o más
Qué obtienes
Varios mensajes SMS
Ideal para
Sesiones, pruebas y acceso continuado
800+ servicios cubiertos
200+ países disponibles
Sin registro para ver precios
Por número nunca una suscripción

Empieza a construir

Consigue tu clave de API en menos de un minuto

Regístrate con un correo electrónico: sin tarjeta y sin llamadas comerciales. El enlace de acceso te devuelve a esta misma página y te entrega una clave que funciona con la API REST y con el servidor MCP.

Crearla es gratis. Pagas por número, nunca una suscripción.

Cómo funciona

Cuatro pasos, de principio a fin

Cada paso de abajo corresponde a endpoints y herramientas reales. Guarda el id que devuelve la compra: todo lo posterior cuelga de él.

  1. 1

    Consulta el inventario en vivo

    Lista servicios, países e intervalos de alquiler con sus precios exactos actuales en USD.

    GET /v1/sms/rental/servicesGET /v1/sms/rental/countriesGET /v1/sms/rental/intervals sms_rental_list_servicessms_rental_list_countriessms_rental_list_intervals
  2. 2

    Alquila por un intervalo

    Elige saldo prepago o x402 sin cuenta, y guarda el id de alquiler devuelto.

    POST /v1/sms/rental/numbers sms_rental_buy_number
  3. 3

    Recoge los mensajes

    Consulta durante todo el alquiler y usa cursores para recuperar varios mensajes sin duplicados.

    GET /v1/sms/rental/numbers/{id}/codes sms_rental_get_codes
  4. 4

    Cancela o amplía

    Cancela cuando haya derecho a reembolso, o lista las ampliaciones disponibles con sus precios y amplía un alquiler activo.

    POST /v1/sms/rental/numbers/{id}/cancelGET /v1/sms/rental/numbers/{id}/extend-optionsPOST /v1/sms/rental/numbers/{id}/extend sms_rental_cancelsms_rental_list_extend_optionssms_rental_extend

Configúralo una vez

Pon Voxisim dentro de tu cliente de IA

Conecta el endpoint alojado y tu agente podrá comparar precios, comprar un número y darte el código sin que escribas una sola petición. Nada que instalar: no hay paquete, ni servidor local, ni contenedor; solo una URL y un inicio de sesión en el navegador.

Endpoint alojado https://api.voxisim.com/mcp
Streamable HTTP · OAuth o clave bearer
  1. 01

    Añade el endpoint

    Elige tu cliente abajo y copia el bloque que necesita.

  2. 02

    Inicia sesión una vez

    Aprueba el aviso de OAuth en el navegador, o pasa una clave vxs_ desde tu gestor de secretos si prefieres no usar OAuth.

  3. 03

    Solo pídelo

    Tu agente elige las herramientas adecuadas y va pasando los ids entre ellas, así que una sola frase cubre todo el ciclo.

Claude

Web y escritorio

OAuth

Abre Ajustes → Conectores, añade un conector personalizado llamado Voxisim y pega el endpoint alojado.

Sin archivo de configuración 
https://api.voxisim.com/mcp

Pulsa Conectar y termina el inicio de sesión en el navegador. Activa Voxisim desde búsqueda y herramientas en tu chat.

Flujo del agente

Lo que hace realmente tu agente

Las herramientas están tipadas y nombradas por su función, así que los resultados vuelven como campos estructurados y no como texto que el agente tiene que releer. Las compras pueden salir de tu saldo o responder con un reto de pago que tu agente firma desde una wallet.

9 herramientas para este producto

  • sms_rental_list_services
  • sms_rental_list_countries
  • sms_rental_list_intervals
  • sms_rental_buy_number
  • sms_rental_get_codes
  • sms_rental_list_numbers
  • sms_rental_cancel
  • sms_rental_list_extend_options
  • sms_rental_extend

Prueba a pedirle a tu agente

Compara los intervalos de alquiler disponibles para WhatsApp en Estados Unidos y muéstrame los precios exactos.
Alquila un número por el intervalo disponible más corto y vigila los mensajes nuevos.
Lista mis alquileres activos y amplía el que caduque antes por un intervalo disponible.

REST

Inicio rápido con REST

El descubrimiento es público: puedes ejecutar el primer bloque ahora mismo sin cuenta. Comprar requiere una clave prepago o un pago x402 firmado, y el cuerpo de la petición es idéntico en ambos casos.

Dos formas de pagar, una sola llamada de compra

El saldo prepago es más simple si compras a menudo. El x402 sin cuenta va mejor para una compra autónoma puntual: guarda el receipt_token de la primera respuesta pagada para poder consultar después qué compraste.

1. Descubre gratis

No hace falta cuenta. Consulta la disponibilidad en vivo y los precios exactos antes de comprar.

curl 'https://api.voxisim.com/v1/sms/rental/services'
curl 'https://api.voxisim.com/v1/sms/rental/countries?service_id=SERVICE_ID'
curl 'https://api.voxisim.com/v1/sms/rental/intervals?service_id=SERVICE_ID&country_id=COUNTRY_ID'

2A. Usa saldo prepago

Crea una cuenta una vez, recárgala por x402 y usa la clave vxs_ devuelta para tus compras.

curl -X POST https://api.voxisim.com/v1/signup \
  -H 'content-type: application/json' \
  -d '{"label":"docs-quickstart"}'

curl -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'authorization: Bearer YOUR_VXS_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

2B. O paga sin cuenta con x402

Envía la compra sin credenciales, firma uno de los requisitos de la respuesta 402 y repite la misma petición.

curl -i -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

curl -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'content-type: application/json' \
  -H 'X-PAYMENT: BASE64_SIGNED_AUTHORIZATION' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

3. Recupera los mensajes

Consulta durante todo el alquiler; usa last_id para recuperar solo los mensajes más nuevos.

curl 'https://api.voxisim.com/v1/sms/rental/numbers/YOUR_RENTAL_ID/codes' \
  -H 'authorization: Bearer YOUR_VXS_API_KEY'
Método Ruta Qué hace
GET /v1/sms/rental/services Lista los servicios alquilables
GET /v1/sms/rental/countries Lista países para un servicio
GET /v1/sms/rental/intervals Lista intervalos y precios exactos
POST /v1/sms/rental/numbers Alquila un número
GET /v1/sms/rental/numbers Lista alquileres activos o archivados
GET /v1/sms/rental/numbers/{id}/codes Recupera los SMS recibidos
POST /v1/sms/rental/numbers/{id}/cancel Cancela un alquiler activo
GET /v1/sms/rental/numbers/{id}/extend-options Lista duraciones y precios de ampliación
POST /v1/sms/rental/numbers/{id}/extend Amplía un alquiler activo

Notas de uso

Reembolsos, caducidad y recuperación limpia

La caducidad y los tropiezos del proveedor son estados normales, no excepciones. Ramifica según el error tipado, vuelve a ejecutar el descubrimiento antes de reintentar y nunca des por hecho que el precio de la última ejecución sigue vigente.

Los intervalos salen del descubrimiento

Las duraciones y los precios no son un menú fijo: salen del descubrimiento de intervalos en vivo. El valor hours que envías al comprar tiene que coincidir con una de las opciones realmente disponibles en ese momento.

Lee mensajes sin duplicados

Consulta con last_id para que cada llamada devuelva solo lo nuevo, y guarda el id del alquiler: lo necesitas para cancelar o ampliar después.

Cancela pronto, amplía tarde

Cancela dentro de la ventana con derecho a reembolso si ya no necesitas el número, o amplía un alquiler activo por cualquier intervalo que siga disponible para él.

Cuando algo sale mal

  • invalid_argument: tu servicio, país o intervalo está obsoleto. Vuelve a ejecutar el descubrimiento y envía una combinación válida ahora mismo.
  • payment_required: es lo esperado en la vía x402. Firma uno de los requisitos ofrecidos y repite la petición idéntica.
  • number_unavailable o un conflicto: esa opción acaba de agotarse. Descubre de nuevo y elige otra en lugar de repetir la misma compra.
  • provider_unavailable o límite de tasa: espera y respeta la indicación de reintento del error. Reintentar de inmediato lo empeora.

¿Aún con dudas?

Activación y alquiler resuelven problemas distintos

Elige la duración más corta que cubra tu flujo. El stock y los precios están en vivo para ambos.

Activación SMS

Compra un número de teléfono de un solo uso y recibe su código de verificación.

  • Unos 20 minutos
  • Un código de verificación
  • Verificación de cuentas y flujos OTP
Leer la guía de Activación SMS

Alquiler SMS

Estás aquí

Alquila un número de teléfono durante el tiempo que elijas y recibe sus mensajes SMS.

  • Un día o más
  • Varios mensajes SMS
  • Sesiones, pruebas y acceso continuado

Dónde encaja un alquiler

Sesiones con varios mensajesPruebas de integración largasAcceso continuado a una cuentaBandejas vigiladas por agentes

Preguntas frecuentes

Preguntas sobre el alquiler

  • Un día es el mínimo, y a partir de ahí hay intervalos más largos. Pregunta al endpoint de intervalos qué se ofrece realmente para tu servicio y país en lugar de suponer un conjunto fijo: las opciones varían.

  • Todos los que lleguen durante el alquiler. Esa es justo la diferencia con una activación, que se detiene tras un código.

  • Pasa last_id al consultar. Así cada llamada devuelve solo mensajes más nuevos que el que ya tienes, y puedes consultar con frecuencia sin deduplicar por tu cuenta.

  • Sí, mientras siga activo, con cualquier intervalo disponible para él. Ampliar es más barato y menos disruptivo que alquilar un número nuevo, porque el número no cambia.

  • Cancelar dentro de la ventana con derecho a reembolso devuelve el importe del alquiler. Fuera de esa ventana, el alquiler simplemente llega al final de su plazo, así que cancela en cuanto sepas que has terminado.

  • Sí. La vía x402 funciona igual que en las activaciones: envía la compra, firma el reto que llega de vuelta y repite la petición idéntica.

Referencia

Los contratos generados

Esta página explica el flujo. Para cada parámetro, campo de respuesta y entrada de herramienta, ve a la referencia: se genera desde el contrato en vivo, así que no puede desviarse.

API interactivaExplora las operaciones en Scalar REST en MarkdownGenerado desde OpenAPI MCP en MarkdownGenerado desde los metadatos de las herramientas OpenAPI JSONContrato legible por máquinas

¿Listo para comprar tu primer número?

Conecta un cliente MCP y pídeselo, o copia el inicio rápido de REST y ejecútalo.

Abrir la referencia de la API Comparar ambos productos