DOC de desarrollo de WhatsApp

Documentación de WhatsApp

Esta documentación es específica para el envío y recepción de mensajes de WhatsApp.

Haga clic aquí para obtener más información sobre todas las funcionalidades que ofrece nuestra integración con WhatsApp.

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.

API REST

cURL

JavaScript

Pitón

Node.js

Rubí

WSDL

Autenticación

CLAVE API
OAuth2

Enviar API de WhatsApp

Este punto final de API se utiliza para enviar mensajes de WhatsApp.

Punto final:

GET POST https://api.smsmobileapi.com/sendsms

Parámetros:

- apikey:Su clave API única.

- recipients: El número de teléfono del destinatario (el número debe estar disponible en WhatsApp). Ingrese el número de teléfono comenzando con el código del país (sin '+' y sin '00'), seguido directamente por el resto de su número. Ejemplo 191728660

- message:El mensaje a enviar (varias líneas posibles).

- url_mediaLa URL directa del archivo multimedia que quieres enviar por WhatsApp. Debe empezar con https:// y señalar una válida PDF, doc o imagen archivo. El archivo debe ser accesible públicamente sin autenticación.
Compatible con: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz
jpg, jpeg, png, gif, bmp, tiff, SVG, webp, ico, heic, jfif

- waonly:debe tener el valor Sí -> Es necesario especificar que solo se debe enviar un mensaje de WhatsApp

Ejemplo sin medios:


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

Ejemplo con medios:


        GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=191728660&message=Hello%20World&url_media=https://smsmobileapi.com/logo.png

Formatear texto en WhatsApp:

Itálico: Usar guiones bajos → _texto_
Atrevido: Utilice asteriscos → *texto*
Tachado: Usar tildes → ~texto~
Monoespaciado: Usar comillas invertidas → ```texto```

Por ejemplo: _Hola_ mundo, ¿cómo estás ~hoy~? de ```SMSMobileAPI```

Reenviar un mensaje de WhatsApp no enviado

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

Punto final:

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

Parámetro:

- guid: (obligatorio) GUID del mensaje que se va a reenviar.

Ejemplo:


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

Sincronización para recuperar mensajes

Este punto final de API se utiliza para enviar una solicitud para sincronizar y recuperar mensajes de WhatsApp.
Este paso es obligatorio y debe ejecutarse antes de llamar al punto final que recupera los mensajes.

Advertencia: La sincronización es estrictamente necesaria solo para la función de recuperación de mensajes. No inicie una sincronización para enviar un mensaje.

Punto final:

GET https://api.smsmobileapi.com/getwa/synchronisation/

Parámetro:

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

Ejemplo:


        GET https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY

Responder :



{


 "error": "0",

   "mensajes": "sincronizados",

  "expire_at": "2025-03-11 12:27:00",

  "expire_at_unix": "1741692420",


 

}

Recuperar mensaje de WhatsApp

Este punto final de API se utiliza para recuperar los mensajes de WhatsApp recibidos.

Punto final:

GET https://api.smsmobileapi.com/getwa

Parámetro:

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

- before (optional): Pase la marca de tiempo como parámetro y muestre los registros debajo de esta marca de tiempo.

- date (optional): (aaaa-mm-dd) obtener todos los registros según la fecha.

Ejemplo:


        GET https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY

Responder :



{


  "fecha": "2025-03-11",

  "hora": "12:27:00",

  "marca de tiempo": "1741692420",

  "número": "19176728660",

  "contacto": "Smsmobileapi",

  "mensaje": "¿Puedes decirme cuándo recibiré mi pedido?",

  "guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c",

  
  "más": {

    "respuesta automática": "1",

    "transferir_a_correo_electrónico": "1",

    "chatgpt_reply": "1"

	
  },


  "chatgpt": {

    "tokens_de_pronto": "900",

    "tokens_de_finalización": "10",

    "total_tokens": "910",

    Costo total de tokens: 0,182

	 "respuesta": "Su pedido #576 será enviado mañana."

	
  }

    
  
}

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

Para enviar o recibir mensajes de WhatsApp a través de nuestra API, se requiere autenticación mediante una clave API. Esto garantiza un acceso seguro y autorizado al servicio de mensajería. Simplemente incluye tu clave API en la solicitud para autenticarte y empezar a enviar mensajes sin problemas.

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.

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?waonly=yes \

-H "Authorization: Bearer abc123xyz456" \

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

-d "recipients=+1234567890" \

-d "message=Hello"

Which Method Should You Use?

- Use API Key Authentication for quick and straightforward integrations.

- Use OAuth2 Authentication for enhanced security and scalability in your integrations.

Enviar mensaje de WhatsApp

URL WSDL

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

Parámetros:

- recipients: El número de móvil del destinatario.

- message: El mensaje a enviar.

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

- waonly: debe tener el valor Sí -> Es necesario especificar que solo se debe enviar un mensaje de WhatsApp.

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("waonly" =>"yes","recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));

                

                print_r($result);

Enviar WhatsApp

Comando básico de cURL

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


        curl -X POST https://api.smsmobileapi.com/sendsms/?waonly=yes \

        -d "recipients=PHONE_NUMBER" \

        -d "message=YOUR_MESSAGE" \

        -d "apikey=YOUR_API_KEY"

Ejemplo de cURL en PHP

Si usas PHP, aquí te mostramos cómo puedes enviar un mensaje de WhatsApp usando cURL:


        <?php

        

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

        $data = array(

            'recipients' => 'PHONE_NUMBER',

            'message' => 'YOUR_MESSAGE',

            'apikey' => 'YOUR_API_KEY'


        );

        

        $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 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 usarla para enviar un mensaje de WhatsApp a través de SMSmobileAPI:


        import requests



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



        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 de WhatsApp 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/?waonly=yes", 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 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 puede usarla para enviar un mensaje de WhatsApp a través de SMSmobileAPI:


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



        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/?waonly=yes";



        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 WhatsApp

Usando la biblioteca `axios`

La biblioteca `axios` es un cliente HTTP popular para Node.js. Aquí se explica cómo se puede usar para enviar un mensaje de WhatsApp a través de SMSmobileAPI:


        const axios = require('axios');



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

        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 WhatsApp

Uso de la biblioteca `Net::HTTP`

Puede utilizar la biblioteca `Net::HTTP` en Ruby para enviar un mensaje de WhatsApp a través de SMSmobileAPI:


        require 'net/http'

        require 'uri'



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

        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.

También es posible enviar un mensaje de WhatsApp y un SMS simultáneamente.

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

Documentación de WhatsApp

Enviar WhatsApp

Reenviar mensaje

Sincronización

Recuperar mensajes

Autenticación

Enviar API de WhatsApp

Punto final:

Parámetros:

Ejemplo sin medios:

Ejemplo con medios:

Formatear texto en WhatsApp:

Reenviar un mensaje de WhatsApp no enviado

Punto final:

Parámetro:

Ejemplo:

Sincronización para recuperar mensajes

Punto final:

Parámetro:

Ejemplo:

Responder :

Recuperar mensaje de WhatsApp

Punto final:

Parámetro:

Ejemplo:

Responder :

Autenticación

1. Autenticación de clave API

2. Autenticación OAuth2

Obtención de un token de acceso

Usando el token de acceso:

Which Method Should You Use?

Enviar mensaje de WhatsApp

URL WSDL

Parámetros:

Ejemplo

Enviar WhatsApp

Comando básico de cURL

Ejemplo de cURL en PHP

Enviar WhatsApp

Uso de la biblioteca `requests`

Uso de la biblioteca `http.client`

Enviar WhatsApp

Usando la API `fetch`

Usando `XMLHttpRequest`

Enviar WhatsApp

Usando la biblioteca `axios`

Enviar WhatsApp

Uso de la biblioteca `Net::HTTP`