DOC de desarrollo: SMSMobileAPI

Documentación para desarrolladores de SMSmobileAPI Puedes enviar mensajes de WhatsApp solo a través de nuestra API. Haga clic aquí para obtener más información.

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.

Si tiene alguna pregunta, sugerencia o necesita ayuda, nuestro equipo está aquí para ayudarlo.
No dude en comunicarse con nosotros en api@smsmobileapi.com

.

API REST

cURL

JavaScript

Pitón

Node.js

Rubí

WSDL

API para enviar SMS y WhatsApp

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 para enviar SMS

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.

https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND

Parámetros:

- apikey:Su clave API única.

- recipients:El número de teléfono del destinatario.

- message:El mensaje a enviar (La longitud del mensaje no está limitada a 160 caracteres; puedes enviar mensajes más largos)

- sendwa:1 = el mensaje debe enviarse por 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)

- schedule_timestamp = Representing the time from which the SMS should be sent - Must be a **UNIX timestamp (GMT 0)**

Ejemplo:


        GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=Hello%20World

Note : In case of a delivery error caused by your operator, a default function retries sending the same SMS up to 3 times within a defined interval.

2. Autenticación OAuth2 para enviar SMS

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.

Resend an unsent SMS

This API endpoint is used to resend an unsent SMS (only if the message has an error status)

https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY

Parámetro:

- guid: (required) GUID of the message to be resent.

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.

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

Parámetro:

- apikey: (obligatorio) Su clave API.

- guid_message: abreviado como el 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` (`&error_api=1`) para enumerar todos los SMS que encontraron un error durante la solicitud de API.

- error_mobile: Ingrese `1` (`&error_mobile=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.

Recibir SMS en la API móvil

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

https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY

Parámetro:

- apikey: La clave API que tienes o recibirás.

.

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:

{

    "fecha": "2025-01-20",

    "hora": "10:15:00",

    "hora_recibida": "2025-01-20 10:14:50",

    "mensaje": "Hola, esto es una prueba.",

    "número": "+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:

<?php

// Leer la carga útil entrante

$payload = archivo_get_contents('php://entrada');

$data = json_decode($payload, verdadero);




// Procesar los datos del SMS

si ($data) {

    // Ejemplo: Registrar los datos de SMS en un archivo

    archivo_poner_contenido('sms_log.txt', print_r($data, verdadero), ARCHIVO_APPEND);




    // Responder con estado HTTP 200

    código_de_respuesta_http(200);

    echo "Webhook recibido exitosamente.";

} demás {

    // Responder con estado HTTP 400 para solicitudes incorrectas

    código_de_respuesta_http(400);


    echo "Carga útil no válida.";

}

?>

Probando el Webhook

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

Estas herramientas le permiten inspeccionar la carga útil enviada por el sistema y depurar cualquier problema con la configuración de su webhook.

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.

Eliminar API de SMS

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

https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY

Parámetro:

- apikey: 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.

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

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...

Uso de la biblioteca `requests`

La biblioteca `requests` es una biblioteca HTTP sencilla y popular para Python. Aquí se explica cómo se puede usar para enviar un SMS a través de 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)

Este ejemplo demuestra una solicitud POST simple a SMSmobileAPI, enviando un mensaje a un número de teléfono específico.

Uso de la biblioteca `http.client`

La biblioteca `http.client` 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()

Este ejemplo muestra cómo utilizar la biblioteca `http.client` para enviar una solicitud POST a la API. Los parámetros están codificados en URL y se envían con los encabezados correspondientes.

Enviar SMS y WhatsApp

Usando la API `fetch`

La API "fetch" es una forma moderna y versátil de realizar solicitudes HTTP en JavaScript. A continuación, se muestra cómo se puede utilizar para enviar un SMS a través de 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));

Este ejemplo demuestra cómo enviar una solicitud POST utilizando la API `fetch`, que es compatible con la mayoría de los navegadores modernos.

Usando `XMLHttpRequest`

Si necesita compatibilidad con navegadores más antiguos, puede utilizar el objeto `XMLHttpRequest`:


        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);

Este ejemplo muestra cómo utilizar `XMLHttpRequest` para enviar una solicitud POST, proporcionando compatibilidad con navegadores más antiguos que pueden no soportar `fetch`.

Enviar SMS y WhatsApp

Usando la biblioteca `axios`

La biblioteca `axios` es un cliente HTTP popular para Node.js. Aquí se explica cómo se puede utilizar para enviar un 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);

        });

Este ejemplo demuestra cómo enviar una solicitud POST usando `axios` en Node.js para interactuar con SMSmobileAPI.

Enviar SMS y WhatsApp

Uso de la biblioteca `Net::HTTP`

Puede utilizar la biblioteca `Net::HTTP` 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

Este ejemplo demuestra cómo enviar una solicitud POST utilizando `Net::HTTP` en Ruby a SMSmobileAPI.

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

API para enviar SMS y WhatsApp

1. Autenticación de clave API para enviar SMS

Parámetros:

Ejemplo:

2. Autenticación OAuth2 para enviar SMS

Obtención de un token de acceso

Usando el token de acceso:

¿Qué método deberías utilizar?

Resend an unsent SMS

Parámetro:

Registro de SMS enviados desde la API

Parámetro:

Recibir SMS en la API móvil

Parámetro:

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

Eliminar API de SMS

Parámetro:

Enviar SMS

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

Parámetros:

Ejemplo

Enviar SMS y WhatsApp

Comando básico de cURL

Ejemplo de cURL en PHP

Enviar SMS y WhatsApp

Uso de la biblioteca `requests`

Uso de la biblioteca `http.client`

Enviar SMS y WhatsApp

Usando la API `fetch`

Usando `XMLHttpRequest`

Enviar SMS y WhatsApp

Usando la biblioteca `axios`

Enviar SMS y WhatsApp

Uso de la biblioteca `Net::HTTP`

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!

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