SMS8

API de SMS8 para desarrolladores.

Envía SMS y MMS con la API de SMS8 y salen de tu propio teléfono. Una clave de API para todos los endpoints, webhooks para respuestas e informes de entrega, un SDK para Node, clases listas para PHP y C#, y un servidor MCP para agentes de IA.

SMS8: Copia tu clave, envía con una sola petición y sigue la entrega con webhooks.
Empieza con un solo comando
npm install sms8-sdk

Claude Desktop: Ajustes, Conectores, Añadir conector personalizado

Cómo funciona la API

Cada petición va a app.sms8.io. Envías un formulario sencillo con tu clave de API y los campos que necesitas. Recibes JSON, con un indicador de éxito claro y los detalles del mensaje.

Por detrás, el mensaje va a un teléfono Android que vinculaste, y ese teléfono lo envía desde su propia SIM. Las respuestas y los informes de entrega te vuelven por el mismo camino.

La API no tiene un límite artificial de peticiones. El ritmo real depende de tus SIM. Añade teléfonos o usa uno con doble SIM para enviar más.

Qué puedes hacer

Un endpoint para cada tarea. La referencia completa lista cada campo.

01

Enviar SMS y MMS

Envía un mensaje, un lote a muchas personas o una difusión a una lista de contactos guardada. Añade enlaces de imagen para MMS. Programa un envío para más tarde, o haz que pase por delante en la cola.

02

Elegir el remitente

Envía desde un teléfono y una SIM, rota entre todos tus teléfonos, o elige uno al azar por mensaje para repartir la carga.

03

Consultar y reenviar

Busca cualquier mensaje por ID para ver su estado. Vuelve a poner en cola los mensajes fallidos con una sola llamada.

04

Códigos OTP

Envía un código de un solo uso y comprueba lo que escribió el usuario. Los códigos tienen un límite por número al día para proteger a los destinatarios.

05

Dispositivos y contactos

Lista tus teléfonos vinculados y sus SIM. Crea o actualiza contactos con un nombre, etiquetas y campos personalizados.

06

USSD

Envía un código USSD del operador, como una consulta de saldo, desde un teléfono vinculado y lee la respuesta.

Autenticación y respuestas

Una clave por cuenta, la misma forma de respuesta en cada llamada.

01

Dónde está la clave

Tu clave aparece en la página API de tu panel de SMS8. Trátala como una contraseña y guárdala en tu servidor, no en una página web pública.

02

Cómo enviarla

Ponla en la cabecera X-Api-Key, como muestra el archivo OpenAPI. También funcionan un token bearer en la cabecera Authorization o un campo de formulario llamado key.

03

Qué recibes

JSON con un indicador de éxito. Si sale bien, recibes el mensaje o el registro. Si falla, recibes un error con un código y un mensaje breve.

04

Comprueba el indicador

Algunos errores, como campos incorrectos o falta de créditos, llegan dentro de una respuesta normal. Lee el indicador de éxito antes de fiarte del resultado.

05

Cuando la clave es incorrecta

Una clave ausente o no válida devuelve 401. Los campos que faltan o están mal formados devuelven 400.

Los endpoints de un vistazo

Todos en app.sms8.io. El archivo OpenAPI tiene los campos exactos de cada uno.

RutaMétodoQué hace
/api/v1/messagesPOSTEnviar un SMS o MMS a una persona o a un lote
/api/v1/messages/readPOSTListar mensajes enviados y recibidos, filtrados por número, sentido o fecha
/api/v1/messages/resendPOSTReintentar un mensaje fallido, por su ID
/api/v1/devicesGETListar los teléfonos vinculados con batería, cobertura, SIM y última conexión
/api/v1/contactsPOSTCrear o actualizar un contacto con etiquetas y campos personalizados
/api/v1/ussd/sendPOSTEjecutar un código USSD desde una SIM vinculada y obtener la respuesta del operador
/api/v1/ussd/listPOSTListar tus sesiones USSD recientes

Enviar un mensaje, campo a campo

Solo son obligatorios el número y el texto. Todo lo demás tiene un valor por defecto.

01

Número y texto

El número va en formato internacional, como +14155550100. El texto puede tener hasta 1.000 caracteres y usar etiquetas de combinación como {first_name}.

02

SMS o MMS

El tipo es sms por defecto. Para MMS, añade enlaces HTTPS públicos de imagen. SMS8 redimensiona cada imagen a 1.280 píxeles antes de enviarla.

03

Qué teléfono lo envía

Indica uno o varios ID de dispositivo y una ranura SIM, donde 0 es la SIM 1 y 1 es la SIM 2. Si no los pones, envía tu teléfono por defecto.

04

Rotación

Activa la opción para rotar entre todos tus teléfonos, o entre todas las SIM de todos los teléfonos. También es posible un teléfono al azar por mensaje.

05

Saltar la cola

Marca un mensaje como prioritario y pasa por delante de los demás en espera en ese teléfono. Útil para alertas y códigos.

06

Qué recibes

Un ID de mensaje para consultarlo después, el teléfono y la SIM que lo aceptaron y la hora en que entró en cola. Después el estado pasa por en cola, enviando, enviado, entregado o fallido.

Webhooks

Registra una URL y SMS8 le envía los eventos en cuanto ocurren. Cada webhook elige sus propios eventos y tiene su propio secreto de firma, para que puedas comprobar que cada petición viene de verdad de SMS8.

01

Recibido

Ha llegado una respuesta o un mensaje nuevo a uno de tus teléfonos. El que necesitan la mayoría de las configuraciones de CRM.

02

Enviado

Tu teléfono aceptó el mensaje y lo puso en cola en su SIM. Útil para registros de auditoría.

03

Entregado

El operador del destinatario confirmó la entrega.

04

Fallido

No se pudo enviar el mensaje tras varios reintentos, por ejemplo por un número erróneo o falta de cobertura.

05

Respuesta USSD

El operador respondió a un código USSD que enviaste.

06

Teléfono vinculado

Un teléfono nuevo se unió a tu cuenta.

Firmados, reintentados y registrados

Cada petición de webhook lleva una cabecera X-Signature. Es un hash HMAC-SHA256 del cuerpo bruto de la petición, hecho con el secreto propio de ese webhook, no con tu clave de API. Calcula el mismo hash en tu servidor, compara los dos con una comprobación de tiempo constante y descarta todo lo que no coincida.

Tu receptor debe usar HTTPS y debería responder con un estado 2xx en menos de 10 segundos. Si no lo hace, SMS8 vuelve a intentarlo con un calendario que va de unos minutos hasta 30 días. Cada intento aparece en el registro de entregas con el estado y la respuesta, y puedes reintentar cualquier fila a mano.

Responde primero y deja para después el trabajo lento, como consultas al CRM o una clasificación con IA. Usa el ID del mensaje como clave única para que un evento reintentado nunca se procese dos veces.

Para agentes de IA

El servidor MCP de SMS8 en mcp.sms8.io permite a Claude, Cursor y otras herramientas de IA enviar SMS, enviar y comprobar códigos OTP, leer mensajes, listar tus teléfonos y crear webhooks.

Usa la misma clave de API, enviada como token bearer. Añádelo a tu herramienta de IA una vez y tu agente podrá enviar mensajes desde tu número.

Preguntas frecuentes

¿Aún tienes dudas? Respondemos rápido.

Envía tu clave de API con cada petición. La encontrarás en la página API de tu panel. El servidor MCP usa la misma clave como token bearer.

La API no tiene un límite artificial. Tus SIM marcan el ritmo real. Para envíos grandes, añade teléfonos o fija una pausa entre mensajes en tus ajustes.

Suscribe un webhook a los eventos entregado y fallido, o busca el mensaje por ID.

Sí. Pon el tipo en MMS y añade enlaces públicos de imagen. SMS8 redimensiona las imágenes antes de enviarlas.

Sí. Los endpoints actuales están en /api/v1, y las URL antiguas siguen funcionando para las apps existentes.

No. Cada webhook tiene su propio secreto de firma, que se fija al crearlo. Tu clave de API nunca sale de tus peticiones a SMS8.

Los eventos esperan en la cola de reintentos y SMS8 sigue intentándolo hasta 30 días. También puedes reenviar cualquier entrega desde el registro cuando vuelvas a estar en línea.

Sí. Importa el archivo OpenAPI en Postman, Insomnia o un generador de código para tener cada endpoint y cada campo.

Sí. Pasa un ID de dispositivo y una ranura SIM, o deja que SMS8 rote entre tus teléfonos y SIM para repartir la carga.

Haz tu primera llamada a la API

Crea una cuenta, vincula un teléfono y copia tu clave de API. Tu código puede enviar en minutos.