Documentación para desarrolladores de SMSmobileAPI

Documentación de SMS

En SMSmobileAPI, nos esforzamos por hacer que nuestra API sea lo más compatible posible con cualquier arquitectura o plataforma.
Ya sea que utilice REST, SOAP, cURL o varios lenguajes de programación como Python, JavaScript, PHP y más, nuestra API está diseñada para integrarse perfectamente en sus proyectos.

También disponemos de complementos listos para usar para soluciones y software de comercio electrónico. Haga clic aquí para descubrirlos.

¿Necesitar ayuda? api@smsmobileapi.com

Buscar

Enviar SMS

Este punto final le permite enviar un SMS desde su teléfono móvil.

Punto final:

CONSEGUIR CORREO https://api.smsmobileapi.com/sendsms/

Parámetros:

Parámetro	Descripción
apikey	Requerido Su clave API única.
recipients	Requerido El número de teléfono del destinatario.
message	Requerido El mensaje a enviar (La longitud del mensaje no está limitada a 160 caracteres; puedes enviar mensajes más largos)
shorturl	1 = todas las URL del mensaje se convertirán automáticamente en URL cortas 0 o vacío = las URL no se convertirán en URL cortas
sIdentifiant	Si tienes varios teléfonos conectados a tu cuenta, define cuál debe enviar el SMS. Cada teléfono tiene un identificador único; úsalo para seleccionar el dispositivo. Déjalo en blanco si solo tienes un teléfono conectado o si solo envías el SMS. Necesita la versión de la aplicación 3.0.35.3 o superior para acceder.
sendwa	1 = el mensaje debe enviarse vía WhatsApp.
sendsms	1 = el mensaje debe enviarse mediante un SMS tradicional. (Si Envía SMS está vacío: se envía por defecto, configúrelo en 0 para bloquear los SMS)
encrypt_message	Sí = El mensaje se cifrará cuando lo lea el destinatario. El destinatario deberá ingresar una clave única para descifrar el mensaje. Obtenga más información sobre el cifrado de mensajes
schedule_timestamp	Representa la hora a partir de la cual se debe enviar el SMS - Debe ser un Marca de tiempo UNIX (GMT 0)

Ejemplo:

OBTENER https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld

Nota: En caso de un error de entrega causado por su operador, una función predeterminada vuelve a intentar enviar el mismo SMS hasta 3 veces dentro de un intervalo definido.

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:

CONSEGUIR CORREO https://api.smsmobileapi.com/resend/

Parámetro:

Parámetro	Descripción
guid	Requerido GUID del mensaje a reenviar.

Ejemplo:

OBTENER https://api.smsmobileapi.com/resend/?apikey=SU_CLAVE_API&guid=GUID_DEL_MENSAJE

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:

CONSEGUIR https://api.smsmobileapi.com/log/sent/sms/

Parámetro:

Parámetro	Descripción
apikey	Requerido Su clave API.
guid_message	Abreviatura del identificador único del mensaje utilizado para ordenar y filtrar.
before	Recupere mensajes enviados antes de esta marca de tiempo o GUID específico.
error_api	Ingrese 1 para enumerar todos los SMS que encontraron un error durante la solicitud de API.
error_mobile	Ingrese 1 para enumerar todos los SMS que encontraron un error durante el procesamiento móvil.
keyword	Una palabra clave para filtrar mensajes según el número del destinatario o el contenido del SMS.

Ejemplo:

OBTENER https://api.smsmobileapi.com/log/sent/sms?apikey=SU_CLAVE_API

SMS recibido

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

Punto final:

CONSEGUIR https://api.smsmobileapi.com/getsms/

Parámetro:

Parámetro	Descripción
apikey	Requerido La clave API que tienes o recibirás.
sIdentifiantPhone	Permite aislar un número de teléfono vinculado al SMS recibido
after_timestamp_unix	Ingresar la "marca de tiempo" Permite enumerar los mensajes SMS recibidos después de una marca de tiempo UNIX determinada
onlyunread	Introducir “sí” Permite listar sólo los mensajes SMS que aún no han sido marcados como leídos (según el estado de la API).

Ejemplo:

OBTENER https://api.smsmobileapi.com/getsms/?apikey=SU_CLAVE_API

Marcar los mensajes SMS recibidos como leídos

Este punto final de API se utiliza para marcar uno o varios mensajes SMS recibidos como leídos solo en el estado de API.
Esto significa que el estado de lectura se actualiza en el lado de la API, lo que le ayuda a filtrar los mensajes ya procesados cuando utiliza el filtro onlyunread=yes.

Importante:
Esta acción no afecta el estado de lectura en el teléfono inteligente en sí: el cambio se aplica solo al estado de la API, no a la aplicación de mensajería ni al estado del sistema en el dispositivo.

Punto final:

CONSEGUIR https://api.smsmobileapi.com/getsms/set-read/

Parámetro:

Parámetro	Descripción
apikey	Requerido La clave API que tienes o recibirás.
guid_message	Requerido GUID del mensaje a marcar como leído

Ejemplo:

OBTENER https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_APIKEY&guid_message=GUID_MESSAGE

Eliminar SMS

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

Punto final:

CONSEGUIR https://api.smsmobileapi.com/deletesms/

Parámetro:

Parámetro	Descripción
apikey	Requerido La clave API que tienes.
guid_message	El ID único del mensaje que se eliminará.
date_start	Si se usa solo, elimina todos los mensajes del día especificado.
date_start and date_end	Combinado para eliminar mensajes dentro de un período específico.

Ejemplo:

OBTENER https://api.smsmobileapi.com/deletesms/?apikey=SU_CLAVE_API

Nota: Los SMS eliminados son solo los que se almacenan en los registros de su cuenta de la aplicación móvil. Los SMS del dispositivo móvil no se eliminarán, ya que no tenemos acceso a ellos.

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:

Inicie sesión en su cuenta en Panel de control de API de SMS para dispositivos móviles.
Navegar hasta el Configuración de webhook sección.
Ingrese la URL de su webhook (por ejemplo, https://example.com/webhook-endpoint).
Haga clic en el Guardar Webhook botón.
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:

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

Muy pronto

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. Es una forma sencilla de autenticar sus solicitudes API.

2. Autenticación OAuth2

OAuth2 proporciona un método de autenticación más seguro y escalable.
Necesitará utilizar un ID de cliente y un secreto de cliente para obtener un token de acceso, que luego debe incluirse en sus solicitudes de API mediante el Autorización encabezamiento.

El client_id y el client_secret están disponibles en su panel de control, a los que puede acceder después de instalar la aplicación y crear una cuenta en su dispositivo móvil.
Descargue la aplicación móvil ahora o Accede a tu panel de control.

Obtención de un token de acceso

Para obtener un token de acceso, envíe una solicitud POST al punto final del token con su ID de cliente y su secreto de cliente.


curl -X POST https://api.smsmobileapi.com/oauth2/token \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "grant_type=client_credentials" \

-d "client_id=1ab0ex4b4c1ef2c800690d" \

-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"

Usando el token de acceso:

Una vez que tenga el token de acceso, inclúyalo en el Autorización encabezado de sus solicitudes de API:


curl -X POST https://api.smsmobileapi.com/sendsms \

-H "Autorización: Portador abc123xyz456" \

-H "Tipo de contenido: aplicación/x-www-form-urlencoded" \

-d "destinatarios=+1234567890" \

-d "mensaje=Hola"

¿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 en sus integraciones.

Para obtener más detalles, consulte la documentación completa.

Enviar SMS

URL WSDL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Parámetros:

- recipients: El número de móvil del destinatario.
- message: El mensaje que se va a enviar. (La longitud del mensaje no está limitada a 160 caracteres; puedes enviar mensajes más largos)
- apikey: La clave API que tienes o recibirás.

Ejemplo


require_once "lib/nusoap.php";


$client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

$error  = $client->getError();


$result = $client->call("sendSms", array("recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));


print_r($result);

Enviar SMS y WhatsApp

Comando básico de cURL

Puede utilizar el siguiente comando cURL para enviar un SMS a través de SMSmobileAPI:


curl -X POST https://api.smsmobileapi.com/sendsms/ \

-d "recipients=PHONE_NUMBER" \

-d "message=YOUR_MESSAGE" \

-d "apikey=YOUR_API_KEY" 

-d "sendwa=1"

-d "sendsms=1"

Ejemplo de cURL en PHP

Si estás usando PHP, aquí te mostramos cómo puedes enviar un SMS usando cURL:


<?php


$url = 'https://api.smsmobileapi.com/sendsms/';

$data = array(

    'recipients' => 'PHONE_NUMBER',

    'message' => 'YOUR_MESSAGE',

    'apikey' => 'YOUR_API_KEY',

    'sendwa' => '1',

    'sendsms' => '1'

);


$options = array(

    CURLOPT_URL => $url,

    CURLOPT_POST => true,

    CURLOPT_POSTFIELDS => http_build_query($data),

    CURLOPT_RETURNTRANSFER => true,

);


$ch = curl_init();

curl_setopt_array($ch, $options);

$response = curl_exec($ch);

curl_close($ch);


echo $response;


?>

Este ejemplo de PHP demuestra cómo enviar una solicitud POST usando cURL a SMSmobileAPI, pasando los parámetros necesarios como una matriz asociativa.

Enviar SMS y WhatsApp

Utilice nuestro módulo oficial de Python: https://smsmobileapi.com/python/

o usa el método manual...

Utilizando el `solicitudes` Biblioteca

El solicitudes La biblioteca es una biblioteca HTTP sencilla y popular para Python. Puedes usarla para enviar un SMS mediante SMSmobileAPI:


import requests


url = "https://api.smsmobileapi.com/sendsms/"


payload = {

    "recipients": "PHONE_NUMBER",

    "message": "YOUR_MESSAGE",

    "apikey": "YOUR_API_KEY"

}


response = requests.post(url, data=payload)


print(response.text)

Utilizando el `http.cliente` Biblioteca

El http.cliente La biblioteca está incluida en la biblioteca estándar de Python y también se puede utilizar para interactuar con su API:


import http.client

import urllib.parse


conn = http.client.HTTPSConnection("api.smsmobileapi.com")


params = urllib.parse.urlencode({

    "recipients": "PHONE_NUMBER",

    "message": "YOUR_MESSAGE",

    "apikey": "YOUR_API_KEY"

})


headers = { "Content-type": "application/x-www-form-urlencoded" }


conn.request("POST", "/sendsms/", params, headers)

response = conn.getresponse()

data = response.read()


print(data.decode("utf-8"))

conn.close()

API móvil de SMS: SDK PHP (Composer)

El SDK PHP de SMS Mobile API está disponible a través de Composer, lo que facilita la integración del envío de SMS en sus aplicaciones PHP.
El compositor requiere smsmobileapi/sdk

Para obtener documentación detallada, instrucciones de instalación y ejemplos de uso, visite nuestro repositorio de GitHub:

🔗 SDK PHP de API móvil de SMS en GitHub: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

En GitHub encontrarás:
✔️ Guía de instalación completa
✔️ Ejemplo de uso
✔️ Referencia de API y mejores prácticas

¿Necesitas ayuda? ¡No dudes en abrir un problema en GitHub! 🎯

Enviar SMS y WhatsApp

Utilizando el `buscar` API

El buscar La API es una forma moderna y versátil de realizar solicitudes HTTP en JavaScript. Aquí te explicamos cómo usarla para enviar un SMS mediante SMSmobileAPI:


const url = "https://api.smsmobileapi.com/sendsms/";


const data = {

    recipients: "PHONE_NUMBER",

    message: "YOUR_MESSAGE",

    apikey: "YOUR_API_KEY"

};


fetch(url, {

    method: "POST",

    headers: {

        "Content-Type": "application/x-www-form-urlencoded"

    },

    body: new URLSearchParams(data)

})

.then(response => response.text())

.then(result => console.log(result))

.catch(error => console.error("Error:", error));

Usando `Solicitud XMLHttp`

Si necesita compatibilidad con navegadores más antiguos, puede utilizar el Solicitud XMLHttp objeto:


const xhr = new XMLHttpRequest();

const url = "https://api.smsmobileapi.com/sendsms/";


const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";


xhr.open("POST", url, true);

xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");


xhr.onreadystatechange = function() {

    if (xhr.readyState === 4 && xhr.status === 200) {

        console.log(xhr.responseText);

    }

};


xhr.send(data);

Enviar SMS y WhatsApp

Utilizando el `axios` Biblioteca

El axios La biblioteca es un cliente HTTP popular para Node.js. Puedes usarla para enviar SMS a través de SMSmobileAPI:


const axios = require('axios');


const url = 'https://api.smsmobileapi.com/sendsms/';

const data = {

    recipients: 'PHONE_NUMBER',

    message: 'YOUR_MESSAGE',

    apikey: 'YOUR_API_KEY'

};


axios.post(url, data)

.then(response => {

    console.log(response.data);

})

.catch(error => {

    console.error('Error:', error);

});

Enviar SMS y WhatsApp

Utilizando el `Red::HTTP` Biblioteca

Puedes utilizar el Red::HTTP Biblioteca en Ruby para enviar un SMS a través de SMSmobileAPI:


require 'net/http'

require 'uri'


uri = URI.parse("https://api.smsmobileapi.com/sendsms/")

request = Net::HTTP::Post.new(uri)

request.set_form_data(

    "recipients" => "PHONE_NUMBER",

    "message" => "YOUR_MESSAGE",

    "apikey" => "YOUR_API_KEY"

)


req_options = {

    use_ssl: uri.scheme == "https",

}


response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|

    http.request(request)

end


puts response.body

Haga clic aquí para probar la clave API y el servicio con el formulario simple

Dependiendo de la versión de Android instalada en un teléfono móvil, el sistema operativo puede dificultar el correcto funcionamiento del envío y recepción automático de mensajes SMS cuando la aplicación SmsMobileApi no está en primer plano.
Este problema surge de un proceso que intenta ejecutarse en segundo plano cuando la aplicación no se inicia de forma activa. Sin embargo, debido a las medidas de optimización de la batería de Android, que varían según las distintas versiones, es posible que este proceso en segundo plano no se inicie correctamente. La optimización de la batería de Android está diseñada para limitar la actividad en segundo plano de las aplicaciones para conservar la vida útil de la batería, lo que puede afectar inadvertidamente a las aplicaciones que requieren procesos en segundo plano para funcionar correctamente.

Para solucionar este problema, los usuarios pueden configurar manualmente sus ajustes de Android para permitir que SmsMobileApi utilice recursos sin restricciones.
Esto implica ajustar la configuración de optimización de la batería para la aplicación específica, básicamente indicando a Android que SmsMobileApi puede ejecutarse en segundo plano y utilizar los recursos según sea necesario. Al hacerlo, la aplicación debería poder enviar y recibir mensajes SMS automáticamente incluso cuando no sea la aplicación activa en primer plano. Este ajuste garantiza que el proceso en segundo plano necesario pueda funcionar sin interrupciones, evitando las funciones de optimización de la batería que, de lo contrario, podrían impedir su ejecución adecuada.

Preguntas frecuentes para desarrolladores

¿Cómo generar una clave API?

Descripción de muestra de acordeónPara generar una clave API, descargue nuestra aplicación en su teléfono móvil y cree una cuenta sin costo. Se generará automáticamente una clave API y se vinculará a su teléfono móvil. También recibirá un correo electrónico con toda la información necesaria. Este proceso garantiza que pueda comenzar a utilizar nuestros servicios de manera rápida y sencilla con una configuración mínima.

¿Dónde puedo encontrar siempre mi clave API?

En su aplicación móvil, navegue hasta el menú AJUSTES o AYUDA, donde su clave API estará visible en todo momento. Esto garantiza que pueda acceder fácilmente a su clave API siempre que la necesite para integrar o usar nuestros servicios.

¿Puede la creación de una clave API ser anónima?

Sí, no requerimos ninguna prueba de identidad para crear una clave API. Por lo tanto, la comunicación entre nuestra API y su teléfono móvil es totalmente anónima. Este enfoque permite a los usuarios mantener su privacidad mientras utilizan nuestros servicios.

¡Empiece a utilizar SMSmobileAPI hoy mismo!

Experimente la libertad y flexibilidad de administrar sus servicios de SMS desde cualquier lugar. Descargue nuestra aplicación móvil ahora y dé el primer paso hacia una integración perfecta de SMS.

Descargar la aplicación

Documentación de API y para desarrolladores

Herramientas y registro de cambios

Enviar SMS

Punto final:

Parámetros:

Ejemplo:

Reenviar un SMS no enviado

Punto final:

Parámetro:

Ejemplo:

Registro de SMS enviados desde la API

Punto final:

Parámetro:

Ejemplo:

SMS recibido

Punto final:

Parámetro:

Ejemplo:

Marcar los mensajes SMS recibidos como leídos

Punto final:

Parámetro:

Ejemplo:

Eliminar SMS

Punto final:

Parámetro:

Ejemplo:

Webhook – SMS recibidos

Cómo configurar el webhook en el panel de control

Carga útil del webhook

Campos de carga útil:

Ejemplo de punto final de webhook

Probando el Webhook

Solución de problemas

SMS enriquecidos

Autenticación

1. Autenticación de clave API

2. Autenticación OAuth2

Obtención de un token de acceso

Usando el token de acceso:

¿Qué método deberías utilizar?

Enviar SMS

URL WSDL

Parámetros:

Ejemplo

Enviar SMS y WhatsApp

Comando básico de cURL

Ejemplo de cURL en PHP

Enviar SMS y WhatsApp

Utilizando el solicitudes Biblioteca

Utilizando el http.cliente Biblioteca

API móvil de SMS: SDK PHP (Composer)

Enviar SMS y WhatsApp

Utilizando el buscar API

Usando Solicitud XMLHttp

Enviar SMS y WhatsApp

Utilizando el axios Biblioteca

Enviar SMS y WhatsApp

Utilizando el Red::HTTP Biblioteca

Preguntas frecuentes para desarrolladores

¿Cómo generar una clave API?

¿Dónde puedo encontrar siempre mi clave API?

¿Puede la creación de una clave API ser anónima?

¡Empiece a utilizar SMSmobileAPI hoy mismo!

💬 Chat en vivo disponible

Utilizando el `solicitudes` Biblioteca

Utilizando el `http.cliente` Biblioteca

Utilizando el `buscar` API

Usando `Solicitud XMLHttp`

Utilizando el `axios` Biblioteca

Utilizando el `Red::HTTP` Biblioteca