Empiece aquí

Su primera solicitud en cuatro pasos

Crea una cuenta y copia la clave API del panel de control.

Instale la aplicación móvil y confirme que el dispositivo está en línea.

Envíe un SMS de prueba con el terminal /sendsms/.

Almacene el ID del mensaje devuelto para correlacionar los registros y el estado de entrega.

La aplicación móvil SMSMobileAPI segura que conecta un teléfono con el panel de seguridad y REST API para operaciones de SMS y llamadas — Conexión móvil a plataforma cifrada

Aplicación móvil oficial

El puente seguro entre su teléfono, dashboard y API.

Los SMS y las operaciones de llamadas pasan por la aplicación oficial SMSMobileAPI instalada en su teléfono conectado. La aplicación empareja el dispositivo con su cuenta, sincroniza eventos autorizados y vincula la red móvil al panel de control y REST API.

1Aplicación móvilPare el teléfono y su SIM 2Enlace cifradoAutentiza y protege los datos en tránsito 3Dashboard & APIControla los flujos de trabajo y la actividad

Los lanzamientos firmados se distribuyen a través de los avisos oficiales de Google Play y Apple App Store
Google y Apple control de la plataforma, firma y distribución
Armario seguro, transporte HTTPS y acceso autenticado API
Sólo los permisos requeridos para las características móviles que permite

Obtener la aplicación oficial SMSMobileAPI en Google Play

Descargar la aplicación oficial SMSMobileAPI en la App Store de Apple

Las capacidades dependen de los permisos y acceso de fondo permitidos por Android o iOS.

Autenticación

Mantenga las credenciales en su servidor

Cada solicitud acepta una clave API a través del parámetro apikey. Las credenciales de cliente OAuth2 también están disponibles para integraciones de servidor a servidor. Nunca exponga una clave de producción en el código del navegador, repositorios públicos o mensajes de soporte.

POST · GET

Envíe un SMS

ENDPOINThttps://api.smsmobileapi.com/sendsms/

Pone en cola un mensaje en un teléfono conectado. Se recomienda POST cuando el mensaje es largo o contiene caracteres especiales.

Cuándo usarlo

Úselo para mensajes transaccionales, recordatorios, alertas y SMS generados por aplicaciones.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`recipients`	teléfono	Requerido	Número de destino en formato internacional.
`message`	cadena	Requerido	Cuerpo del mensaje. Codifique la URL cuando use GET.
`port`	1 \| 2	Opcional	Puerto SIM en dispositivos Android compatibles; déjelo vacío para la selección automática.
`sIdentifiant`	cadena	Opcional	SID de teléfono conectado específico; déjelo vacío para el primer dispositivo disponible.
`shorturl`	0 \| 1	Opcional	Establezca en 1 para acortar las URL encontradas en el mensaje.
`sendsms`	0 \| 1	Opcional	Indicador de canal de SMS. El valor predeterminado es 1 cuando se omite.
`sendwa`	0 \| 1	Opcional	Solicite también la entrega de WhatsApp cuando la cuenta lo admita.
`encrypt_message`	Sí	Opcional	Cifre el mensaje para lectura protegida del lado del destinatario.
`schedule_timestamp`	Segundos Unix	Opcional	Hora UTC a partir de la cual puede enviarse el mensaje enviado.

Ejemplo de solicitud

rizo

curl -X POST "https://api.smsmobileapi.com/sendsms/" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=+1234567890" \
  --data-urlencode "message=Your appointment is confirmed for tomorrow."

Ejemplo de respuesta

JSON

{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25",
    "note": "sent by mobile",
    "datetime": "2026-03-20T21:07:44Z",
    "port": null,
    "send_with_whatsapp": "0"
  }
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

Una respuesta API exitosa significa que la plataforma aceptó el mensaje; conserve la identificación devuelta para un seguimiento posterior.
La entrega del operador y el procesamiento móvil pueden ocurrir después de la respuesta HTTP.

POST · GET

Reenviar un SMS no enviado

ENDPOINThttps://api.smsmobileapi.com/resend/

Vuelva a intentar un mensaje que actualmente se encuentra en un estado de error.

Cuándo usarlo

Utilice esto después de verificar el registro enviado y confirmar que un mensaje fallido es elegible para otro intento.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`guid`	cadena	Requerido	El GUID del mensaje devuelto por el punto final de envío o registro.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE"

Ejemplo de respuesta

JSON

{
  "result": {
    "error": "0",
    "sms": "resent with successfully",
    "attempt": 1
  }
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

Solo se pueden reenviar los mensajes con un estado de error.

CONSEGUIR

Enumere los SMS enviados desde la API

ENDPOINThttps://api.smsmobileapi.com/log/sent/sms/

Devuelve mensajes enviados a través de la API de SMS con información de cola, móvil y de error.

Cuándo usarlo

Úselo para monitoreo de entrega, diagnóstico de soporte y reconciliación.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`guid_message`	cadena	Opcional	Devuelve un mensaje por su GUID único.
`before`	marca de tiempo o referencia	Opcional	Devuelve mensajes antes del cursor o marca de tiempo proporcionados.
`error_api`	0 \| 1	Opcional	Establezca en 1 para devolver solo errores de procesamiento de API.
`error_mobile`	0 \| 1	Opcional	Establezca en 1 para devolver errores de envío móvil únicamente.
`keyword`	cadena	Opcional	Busca el número del destinatario o el texto del mensaje.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/log/sent/sms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

Ejemplo de respuesta

JSON

{
  "result": {
    "error": "0",
    "sms": [{
      "sIdentifiantPhone": "508b004b4aadacc4",
      "recipients": "+1234567890",
      "sms": "Test message",
      "guid_message": "MESSAGE_GUID",
      "send_from_mobile": 1,
      "error_api": "",
      "send_from_mobile_erreur": ""
    }]
  }
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

CONSEGUIR

Listar SMS sincronizados desde un teléfono

ENDPOINThttps://api.smsmobileapi.com/log/sent/frommobile/

Enumera los SMS enviados físicamente por un móvil y sincronizados con la plataforma.

Cuándo usarlo

Utilícelo cuando los mensajes puedan originarse en el teléfono y a través de la API.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`date`	AAAA-MM-DD	Opcional	Filtrar una fecha exacta.
`date_from`	AAAA-MM-DD	Opcional	Inicio de un rango de fechas.
`date_to`	AAAA-MM-DD	Opcional	Fin de un rango de fechas.
`period`	enum	Opcional	hoy, ayer, last_24h, last_3days o last_7days.
`number`	teléfono	Opcional	Filtrar por destinatario.
`sIdentifiant`	cadena	Opcional	Filtrar por SID del móvil conectado.
`message`	cadena	Opcional	Filtrar por contenido del mensaje.
`search`	cadena	Opcional	Búsqueda global en dispositivos móviles, números, mensajes y marcas de tiempo.
`sort_by`	enum	Opcional	sIdentifiant, number, message, mobile_date_ms, mobile_date_formatted o synchro_time.
`sort_order`	ASC confidencialidad DESC	Opcional	Dirección de clasificación.
`limit`	entero	Opcional	Máximo 200 registros.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&period=last_7days&limit=200"

Ejemplo de respuesta

JSON

{
  "result": {
    "error": "0",
    "count": 1,
    "history_limit_days": 7,
    "sms": [{
      "sIdentifiant": "508b004b4aadacc4",
      "number": "+15551234567",
      "message": "Appointment confirmed.",
      "mobile_date_ms": 1774041004692,
      "synchro_time": "2026-03-20 21:10:05"
    }]
  }
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

Requiere la aplicación de Android 4.1.20 o posterior y debe estar habilitada en la aplicación.
Este punto final devuelve un máximo de siete días de historial sincronizado.

CONSEGUIR

Listar SMS recibidos

ENDPOINThttps://api.smsmobileapi.com/getsms/

Devuelve SMS entrantes sincronizados desde teléfonos conectados.

Cuándo usarlo

Úselo para crear una bandeja de entrada, sondear respuestas o recuperar mensajes después de una interrupción del webhook.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`sIdentifiantPhone`	cadena	Opcional	Filtrar por el teléfono que recibió el SMS.
`after_timestamp_unix`	Segundos Unix	Opcional	Devuelve mensajes recibidos después de esta marca de tiempo.
`onlyunread`	Sí	Opcional	Devuelve solo mensajes no marcados como leídos en el estado API.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY&onlyunread=yes"

Ejemplo de respuesta

JSON

{
  "result": {
    "error": "",
    "sms": [{
      "id": 466340,
      "sIdentifiantPhone": "508b004b4aadacc4",
      "timestamp_unix": 1774041814,
      "message": "Please call us back.",
      "number": "+15551234567",
      "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
      "alias": null
    }]
  }
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

POST · GET

Marcar un SMS recibido como leído

ENDPOINThttps://api.smsmobileapi.com/getsms/set-read/

Marca un mensaje recibido como leído en el estado API SMSMobileAPI.

Cuándo usarlo

Utilice esto después de que su aplicación haya procesado un mensaje entrante mensaje.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`guid_message`	cadena	Requerido	GUID del SMS recibido.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

Esto no cambia el estado de lectura dentro de la aplicación de mensajería del teléfono.

POST · GET

Actualizar un alias de SMS recibido

ENDPOINThttps://api.smsmobileapi.com/getsms/update/

Agrega, cambia o borra el alias asociado con un SMS recibido.

Cuándo usarlo

Utilice alias para adjuntar un nombre de contacto o etiqueta de aplicación a un mensaje.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`guid`	cadena	Requerido	GUID del SMS recibido.
`alias`	cadena	Requerido	Nuevo alias. Envíe un valor vacío para borrarlo.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID&alias=John%20Doe"

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

POST · GET

Eliminar registros del servidor de SMS

ENDPOINThttps://api.smsmobileapi.com/deletesms/

Elimina registros SMS del registro del servidor SMSMobileAPI.

Cuándo usarlo

Úselo para flujos de trabajo de retención o eliminación de un mensaje registrado específico.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`guid_message`	cadena	Opcional	Eliminar un mensaje por GUID.
`date_start`	AAAA-MM-DD	Opcional	Eliminar registros de esta fecha.
`date_end`	AAAA-MM-DD	Opcional	Con date_start, limita el rango de eliminación.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

Ejemplo de respuesta

JSON

{
  "result": {
    "error": null,
    "count_delete": 1
  }
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

Esto elimina solo las entradas del registro del servidor. No elimina los mensajes almacenados en el dispositivo móvil.
Trate esta operación como destructiva y verifique los filtros antes de realizarla.

CONSEGUIR

Lista de conversaciones SMS

ENDPOINThttps://api.smsmobileapi.com/conversation/sms/list/

Agrupa los mensajes entrantes y salientes en conversaciones por número de teléfono.

Cuándo usarlo

Úselo para vistas de chat, widgets de conversaciones recientes y cronogramas de soporte.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`origineConversation`	recibidos	Requerido	Conjunto de datos utilizado para identificar las conversaciones iniciales.
`numero`	teléfono	Opcional	Devolver una conversación de número de teléfono.
`date_from`	fecha o fechahora	Opcional	Inicio del rango de mensajes.
`date_to`	fecha o fechahora	Opcional	Fin del rango de mensajes.
`sort`	ASC confidencialidad DESC	Opcional	Orden de conversación; DESC predeterminado.
`limit`	entero	Opcional	Límite de conversación cuando se omite el número; predeterminado 20.
`resume`	0 \| 1	Opcional	Establezca en 1 para devolver solo los últimos mensajes por conversación.
`resume_line_how`	entero	Opcional	Número de mensajes por conversación cuando resume=1.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&resume=1&resume_line_how=3"

Ejemplo de respuesta

JSON

{
  "success": true,
  "origineConversation": "received",
  "conversations": [{
    "phone_number": "+15551234567",
    "contact_alias": "John Doe",
    "messages": [{
      "direction": "incoming",
      "message_id": "msg_1001",
      "timestamp_utc": "2026-03-13T08:45:12Z",
      "message": "I need more information.",
      "status": "received",
      "mobile_sid": "device_sid_1"
    }]
  }]
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

CONSEGUIR

Lista de móviles conectados

ENDPOINThttps://api.smsmobileapi.com/gateway/mobile/list/

Enumera los teléfonos conectados a la cuenta de puerta de enlace SMS.

Cuándo usarlo

Úselo para seleccionar un remitente, mostrar estado del dispositivo o auditar una flota de puerta de enlace.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`sid`	cadena	Opcional	Devuelve un SID móvil exacto.
`search`	cadena	Opcional	Busca SID, fecha, batería, versión, etiqueta y campos relacionados.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/gateway/mobile/list/?apikey=YOUR_API_KEY"

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

POST · GET

Actualizar un móvil conectado

ENDPOINThttps://api.smsmobileapi.com/gateway/mobile/update/

Actualiza la etiqueta legible por humanos o el número de teléfono de un dispositivo conectado.

Cuándo usarlo

Utilízalo para mantener las etiquetas de los dispositivos significativas en instalaciones de varios teléfonos.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`sid`	cadena	Requerido	El SID del dispositivo.
`label`	cadena	Requerido	Nueva etiqueta; puede estar vacío intencionalmente.
`phone_number`	teléfono	Opcional	Nuevos metadatos de números de teléfono.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=DEVICE_SID&label=OfficePhone"

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

POST · GET

Eliminar un móvil conectado

ENDPOINThttps://api.smsmobileapi.com/gateway/mobile/delete/

Elimina un móvil conectado y sus filas del historial de puerta de enlace.

Cuándo usarlo

Úselo solo cuando un teléfono deba eliminarse permanentemente de la cuenta.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Clave API de su cuenta.
`sid`	cadena	Requerido	SID del dispositivo para eliminar.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=DEVICE_SID"

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

Esta operación elimina el historial del dispositivo asociado con el SID. Confirme el dispositivo antes de llamarlo.

POST ENTRADA

Recibir SMS mediante webhook

DESTINOYour HTTPS endpoint

SMSMobileAPI envía una solicitud JSON a su URL configurada cada vez que se recibe un SMS.

Cuándo usarlo

Utilice webhooks para procesamiento en tiempo real en lugar de frecuentes sondeo.

Ejemplo de receptor

PHP 8

<?php
$payload = json_decode(file_get_contents('php://input'), true);
if (!is_array($payload) || empty($payload['guid'])) {
    http_response_code(400);
    exit('Invalid payload');
}
// Queue the event, then acknowledge quickly.
http_response_code(200);
echo 'OK';

Ejemplo de respuesta

JSON

{
  "date": "2026-03-20",
  "hour": "10:15:00",
  "time_received": "2026-03-20 10:14:50",
  "message": "Hello, this is a test.",
  "number": "+123456789",
  "guid": "abcde12345"
}

Punto final de entrada

Este punto final recibe eventos en su propia URL HTTPS. Utilice el ejemplo de receptor anterior y luego envíe un SMS a su teléfono conectado para probarlo.

Es bueno saberlo

Configure la URL HTTPS pública en Panel → Configuración de webhook.
Devuelva HTTP 200 rápidamente y procese el evento de forma asincrónica.
Deduplicar reintentos usando guid.

Solución de problemas

Errores y reintentos seguros

Lea el estado HTTP y el campo de error JSON antes de volver a intentarlo. No vuelva a intentar fallas de validación o autenticación sin corregir primero la solicitud.

HTTP	Código	Qué hacer
400	`missing_parameter`	Un parámetro requerido está vacío o ausente. Consulte la tabla de parámetros del punto final.
403	`invalid_apikey`	La clave API es desconocida, ha caducado o no está autorizada para la función solicitada.
429	`too_many_requests`	Las solicitudes llegan demasiado rápido. Espere y vuelva a intentarlo con un retroceso exponencial.
500	`server_error`	El servicio no pudo completar la solicitud. Conserve la respuesta y comuníquese con el soporte si persiste.

Regla de reintentoReintente solo respuestas transitorias 429 y 5xx. Comience después de 1 segundo, luego retroceda a 2, 4 y 8 segundos.

¿Necesitar ayuda?

Traiga el contexto de la solicitud, no sus secretos.

Comparta el punto final, la marca de tiempo, el estado HTTP y la respuesta desinfectada. Nunca incluya claves API, tokens ni contenido de mensajes privados.

Comuníquese con el soporte de API →

Documentación de la API de SMS

Su primera solicitud en cuatro pasos

El puente seguro entre su teléfono, dashboard y API.

Mantenga las credenciales en su servidor

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Parámetros

Ejemplo de solicitud

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Parámetros

Ejemplo de solicitud

Parámetros

Ejemplo de solicitud

Ejemplo de receptor

Ejemplo de respuesta

Errores y reintentos seguros

Traiga el contexto de la solicitud, no sus secretos.