Documentación de SMS

Enviar SMS

Punto final: 

Parámetros:

Ejemplo:

Reenviar un SMS no enviado

Este punto final de API se utiliza para reenviar un SMS no enviado (solo si el mensaje tiene un estado de error).

Punto final:

Parámetro: 

Ejemplo: 

Registro de SMS enviados desde la API

Este punto final de API se utiliza para recuperar el registro de mensajes SMS enviados a través de la API.

Punto final: 

Parámetro:

Ejemplo:

Lista de SMS enviados desde el móvil

Este punto final de la API se utiliza para listar los mensajes SMS enviados desde su dispositivo móvil y sincronizados con su cuenta de SMSMobileAPI.

Importante: Esta función está disponible a partir de la versión de Android. 4.1.20.

Importante: Esta característica es no está habilitado por defecto en la aplicación de Android.

Privacidad: Toda la información sincronizada es anónima, confidencial y se maneja de forma segura.

Límite de historial: Esta API siempre devuelve datos del último 7 días solo.

Nota: Si envía SMS utilizando el punto final de la API estándar https://api.smsmobileapi.com/sendsms/Estos SMS también pueden aparecer en esta lista porque se envían físicamente desde su dispositivo móvil.

Punto final:

Parámetros: 

Campos devueltos: 

Ejemplo: 

Ejemplo con filtros:

Ejemplo con período predefinido:

SMS recibido

Este punto final de API se utiliza para recuperar mensajes SMS recibidos en el teléfono inteligente. 

Punto final:

Parámetro: 

Ejemplo:

Marcar los mensajes SMS recibidos como leídos

Este punto final de API se utiliza para marcar un mensaje SMS recibido como leído en el Solo estado de API.
Esto no cambia el estado de lectura en el teléfono inteligente.  

Punto final:

Parámetro: 

Ejemplo:

Actualizar alias de SMS

Este punto final de la API se utiliza para actualizar el alias de un SMS recibido mediante su GUID.

Nota: El alias El parámetro puede estar vacío. En ese caso, se borrará el alias.

Punto final:

Parámetros: 

Ejemplo: 

Ejemplo para borrar el alias:

Eliminar SMS

Este punto final de API se utiliza para eliminar mensajes SMS del registro del servidor de SMS Mobile API.

Punto final: 

Parámetro:

Ejemplo:

Nota: Los SMS eliminados solo se almacenan en los registros del servidor. Los SMS del dispositivo no se eliminarán.

Lista de conversaciones SMS

Este punto final de la API se utiliza para listar las conversaciones de SMS vinculadas a su cuenta.

Cada conversación se agrupa por número de teléfono y contiene los mensajes SMS entrantes y salientes relacionados.

Nota: El punto de partida de la conversación está definido por el origineConversation parámetro:

• received: las conversaciones se detectan primero a partir de los SMS recibidos en logsmsreceive
• sent: las conversaciones se detectan primero a partir de los SMS enviados en logsmssent

Nota: Si numero No se proporciona, la API devuelve solo las últimas conversaciones. Por defecto, la última 20 Se devuelven las conversaciones.

Nota: Para SMS salientes, si timearea_of_message está disponible (ejemplo: UTC+02), la fecha mostrada se convierte automáticamente utilizando este valor. Esta fecha convertida también se utiliza para la ordenación.

Nota: Si resume=1, solo se devuelven los mensajes más recientes de cada conversación. Usar resume_line_how para definir cuántos mensajes recientes deben incluirse.

Punto final:

Parámetros: 

Detalles del comportamiento: 

Ejemplo 1: Lista de las últimas conversaciones de los SMS recibidos: 

Ejemplo 2 - Listar las últimas conversaciones de los SMS enviados:

Ejemplo 3 - Filtrar un número de teléfono específico:

Ejemplo 4 - Filtrar por rango de fechas:

Ejemplo 5 - Modo reanudar con los últimos 3 mensajes por conversación:

Ejemplo de respuesta exitosa: 

{ "éxito": verdadero, "conversación de origen": "recibido", "reanudar": 0, "cómo_línea_reanudar": nulo, "conversaciones": [ { "número_de_teléfono": "+10470000001", "alias_de_contacto": "John Doe", "mensajes": [ { "dirección": "entrante", "id_mensaje": "msg_1001", "fecha": "2026-03-13 08:45:12", "marca_de_tiempo_utc": "2026-03-13T08:45:12Z", "mensaje": "Hola, me gustaría obtener más información.", "estado": "recibido", "sid_móvil": "sid_de_dispositivo_1" }, { "dirección": "saliente", "id_mensaje": "msg_1002", "fecha": "2026-03-13 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "Por supuesto, ¿qué le gustaría saber?", "status": "sent", "mobile_sid": "device_sid_2" } ] } ] }

Campos de respuesta:

Ejemplo de error:

{ "éxito": false, "error": "Falta el parámetro obligatorio: apikey" }

Notas:

Puerta de enlace – Lista de móviles conectados

Listado de móviles conectados a tu Puerta de enlace de SMS.

Punto final:

Parámetros:

Ejemplo:

Puerta de enlace: Actualizar una etiqueta móvil

Actualizar la etiqueta (nom_reference) de un móvil conectado.

Punto final:

Parámetros:

Ejemplo:

Importante: La etiqueta es obligatoria pero puede estar vacía (etiqueta=).

Puerta de enlace – Eliminar un móvil conectado

Eliminar un móvil conectado de su puerta de enlace (elimina todas las filas del historial para este SID).

Punto final:

Parámetros:

Ejemplo:

Webhook – SMS recibidos

Este sistema de webhook envía una solicitud POST a la URL configurada cada vez que se recibe un SMS. El sistema garantiza actualizaciones en tiempo real al enviar los detalles del SMS a la URL del webhook especificado.

Cómo configurar el webhook en el panel de control

Siga estos pasos para configurar la URL de su webhook en el panel de control:

1. Inicie sesión en su cuenta en Panel de control de API de SMS para dispositivos móviles.
2. Navegar hasta el Configuración de webhook sección.
3. Ingrese la URL de su webhook (por ejemplo, https://example.com/webhook-endpoint).
4. Haga clic en el Guardar Webhook botón. 
5. Una vez guardado, el sistema comenzará a enviar detalles SMS a la URL configurada.

Carga útil del webhook

Cuando se recibe un SMS, el sistema envía la siguiente carga JSON a la URL de su webhook:

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "Hola, esto es una prueba.", "number": "+123456789", "guid": "abcde12345" }

Campos de carga útil:

• fecha: Fecha en la que se agregó el SMS (AAAA-MM-DD).
• hora: Hora en que se añadió el SMS (HH:mm:ss).
• tiempo_recibido: Hora en que se recibió el SMS.
• mensaje: Contenido del SMS. 
• número: Número de teléfono del remitente.
• guía: Identificador único del SMS.

Ejemplo de punto final de webhook

Su servidor debería estar listo para manejar solicitudes POST entrantes. A continuación, se muestra un ejemplo de script PHP para procesar la carga útil del webhook:

Probando el Webhook

Para probar la configuración de su webhook, utilice herramientas como:

• Sitio webhook
• SolicitudBin

Solución de problemas

• Asegúrese de que la URL del webhook sea correcta y de acceso público.
• Verifique que su servidor esté devolviendo un código de estado HTTP 200 para solicitudes exitosas.
• Revise los registros de su servidor para detectar cualquier error en el procesamiento de la carga útil.

SMS enriquecidos

Autenticación

La API de SMSMobile admite dos métodos de autenticación: utilizando una clave API simple o el protocolo OAuth2 con un ID de cliente y un secreto de cliente.

1. Autenticación de clave API

 Este método requiere una clave API que se puede incluir como parámetro en una solicitud GET o POST.

2. Autenticación OAuth2

OAuth2 proporciona un método de autenticación más seguro.
Utilice un ID de cliente y un secreto de cliente para obtener un token de acceso y luego inclúyalo en el Autorización encabezamiento.

El client_id y el client_secret están disponibles en su panel de control.
Descargue la aplicación móvil ahora o Accede a tu panel de control.

Obtención de un token de acceso

Usando el token de acceso:

¿Qué método deberías utilizar?

- Usar Autenticación de clave API para integraciones rápidas y sencillas.

- Usar Autenticación OAuth2 para una mayor seguridad y escalabilidad.