Dev DOC WhatsApp - SMSMobileAPI

Documentazione di WhatsApp

Questa documentazione è specifica per l'invio e la ricezione di messaggi WhatsApp.

Clicca qui per saperne di più informazioni su tutte le funzionalità offerte dalla nostra integrazione WhatsApp.

Noi di SMSmobileAPI ci impegniamo a rendere la nostra API il più compatibile possibile con qualsiasi architettura o piattaforma.
Che tu utilizzi REST, SOAP, cURL o vari linguaggi di programmazione come Python, JavaScript, PHP e altri, la nostra API è progettata per integrarsi perfettamente nei tuoi progetti.

Disponiamo anche di plugin pronti all'uso per soluzioni e software di e-commerce. Clicca qui per scoprirli.

API REST

cURL

JavaScript

Pitone

Node.js

Rubino

WSDL

Invia API WhatsApp

Questo endpoint API viene utilizzato per inviare messaggi WhatsApp.

Punto finale:

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

Parametri:

Parametro	Descrizione
apikey	Necessario La tua chiave API univoca.
recipients	Necessario Il numero di telefono del destinatario (il numero deve essere disponibile su WhatsApp). Inserisci il numero di telefono iniziando con il prefisso internazionale (senza '+' e senza '00'), seguito direttamente dal resto del numero. Esempio: 191728660
message	Necessario Messaggio da inviare (sono possibili più righe).
waonly	Necessario Deve avere il valore SÌ → Necessario per specificare che deve essere inviato un solo messaggio WhatsApp.
url_media	L'URL diretto del file multimediale che desideri inviare tramite WhatsApp. Deve iniziare con https:// e puntare a un valido PDF, dottore O immagine file. Il file deve essere accessibile al pubblico senza autenticazione. Formati supportati: Documenti: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz Immagini: jpg, jpeg, png
url_media_shorted	Se il valore è SÌe se è impostato [pdf_with_image=yes], la visualizzazione del link per il download del PDF avviene tramite un URL breve.
pdf_with_image	Se il valore è SÌ, verrà visualizzata un'anteprima dell'immagine del PDF insieme al messaggio (solo se il file è un PDF).
encrypt_message	SÌ = Il messaggio verrà crittografato quando verrà letto dal destinatario. Per decifrare il messaggio, il destinatario dovrà immettere una chiave univoca. Scopri di più sulla crittografia dei messaggi
contactGroup	Immetti il GUID del gruppo (disponibile nella dashboard) quando modifichi il gruppo di contatti.

Esempio senza media:


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

Esempio con media:


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

Formattare il testo in WhatsApp:

Corsivo: Usa caratteri di sottolineatura → _testo_
Grassetto: Usa gli asterischi → *testo*
Barrato: Usa le tilde → ~testo~
Monospaziatura: Usa i backtick → ```testo```

Ad esempio: _Ciao_ mondo, come *stai* ~oggi~ da ```SMSMobileAPI```

Reinvia un messaggio WhatsApp non inviato

Questo endpoint API viene utilizzato per reinviare un messaggio non inviato (solo se il messaggio presenta uno stato di errore)

Punto finale:

OTTENERE INVIARE https://api.smsmobileapi.com/resendwa/

Parametro:

Parametro	Descrizione
guid	Necessario GUID del messaggio da reinviare.

Esempio:


        OTTIENI https://api.smsmobileapi.com/resendwa/?apikey=LA_TUA_CHIAVE_API&guid=GUID_DEL_MESSAGGIO

Sincronizzazione per recuperare il messaggio

Questo endpoint API viene utilizzato per inviare una richiesta di sincronizzazione e recupero dei messaggi WhatsApp.
Questo passaggio è obbligatorio e deve essere eseguito prima di chiamare l'endpoint che recupera i messaggi.

Avvertimento: La sincronizzazione è strettamente necessaria solo per la funzione di recupero dei messaggi. Non avviare una sincronizzazione per inviare un messaggio.

Punto finale:

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

Parametro:

Parametro	Descrizione
apikey (required)	Necessario La chiave API che possiedi o che riceverai.

Esempio:


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

Rispondere :



{


 "errore": "0",

   "messaggi": "sincronizzati",

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

  "expire_at_unix": "1741692420",


 

}

Recupera messaggio WhatsApp

Questo endpoint API viene utilizzato per recuperare i messaggi WhatsApp ricevuti.

Punto finale:

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

Parametro:

Parametro	Descrizione
apikey	Necessario La chiave API che possiedi o che riceverai.
before	Passare il timestamp come parametro e visualizzare i record sotto questo timestamp.
date	(aaaa-mm-gg) Ottieni tutti i record in base alla data.
message_type	Lascia vuoto per vedere tutti i messaggi (testo e audio) Utilizzo `testo` per vedere solo i messaggi di testo Utilizzo `audio` per vedere solo i messaggi audio convertiti in testo

Esempio:


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

Rispondere :



{


  "data": "2025-03-11",

  "ora": "12:27:00",

  "marca temporale": "1741692420",

  "numero": "19176728660",

  "contatto": "Smsmobileapi",

  "messaggio": "Puoi dirmi quando riceverò il mio ordine?",

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

  
  "Di più": {

    "risposta automatica": "1",

    "trasferisci_a_email": "1",

    "chatgpt_reply": "1"

	
  },


  "chatgpt": {

    "prompt_tokens": "900",

    "token di completamento": "10",

    "totale_gettoni": "910",

    "costo_totale_gettoni": "0,182"

	 "response": "Il tuo ordine #576 verrà spedito domani."

	
  }

    
  
}

Controlla il numero su WhatsApp

Questo endpoint API consente di verificare se il numero di telefono è disponibile sulla rete WhatsApp.

Punto finale:

GET https://api.smsmobileapi.com/whatsapp/checknumber/

Parametro:

Parametro	Descrizione
apikey	Necessario Il tuo apikey
recipients	Necessario Il numero di telefono da verificare

Esempio:


        GET https://api.smsmobileapi.com/whatsapp/checknumber/?recipients=_YOUR_API_KEY_&apikey=_PHONE_NUMBER_

Rispondere :



{


  "contatto_trovato_su_whatsapp": "sì",

  "destinatari": 19176728660",

 


  
  
}

Autenticazione

L'API SMSMobile supporta due metodi di autenticazione: tramite una semplice chiave API o tramite il protocollo OAuth2 con un ID client e un segreto client.

1. Autenticazione tramite chiave API

Per inviare o ricevere messaggi WhatsApp tramite la nostra API, è richiesta l'autenticazione tramite una chiave API. Questo garantisce un accesso sicuro e autorizzato al servizio di messaggistica. Basta includere la chiave API nella richiesta per autenticarsi e iniziare a inviare messaggi senza problemi.

2. Autenticazione OAuth2

OAuth2 fornisce un metodo di autenticazione più sicuro e scalabile.
Sarà necessario utilizzare un ID client e un segreto client per ottenere un token di accesso, che dovrebbe quindi essere incluso nelle richieste API utilizzando Autorizzazione intestazione.

Client_id e client_secret sono disponibili nella dashboard.

Ottenere un token di accesso

Per ottenere un token di accesso, invia una richiesta POST all'endpoint del token con il tuo ID client e il tuo segreto client.


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"

Utilizzo del token di accesso:

Una volta ottenuto il token di accesso, includilo nel Autorizzazione intestazione delle tue richieste 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.

Invia messaggio WhatsApp

URL WSDL

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

Parametri:

- recipients: Il numero di cellulare del destinatario.

- message: Il messaggio da inviare.

- apikey: La chiave API che possiedi o che riceverai.

- waonly: deve avere il valore SÌ -> Necessario per specificare che verrà inviato un solo messaggio WhatsApp.

Esempio


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

Invia WhatsApp

Comando cURL di base

Puoi utilizzare il seguente comando cURL per inviare un messaggio WhatsApp tramite SMSmobileAPI:


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

        -d "recipients=PHONE_NUMBER" \

        -d "message=YOUR_MESSAGE" \

        -d "apikey=YOUR_API_KEY"

Esempio di cURL in PHP

Se utilizzi PHP, ecco come puoi inviare un messaggio WhatsApp utilizzando 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;

        

        ?>

Questo esempio PHP mostra come inviare una richiesta POST tramite cURL alla SMSmobileAPI, passando i parametri necessari come array associativo.

Invia WhatsApp

Utilizza il nostro modulo Python ufficiale: https://smsmobileapi.com/python/
oppure usa il metodo manuale...

Utilizzo della libreria `requests`

La libreria `requests` è una libreria HTTP semplice e diffusa per Python. Ecco come usarla per inviare un messaggio WhatsApp tramite l'API SMSmobile:


        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)

Questo esempio mostra una semplice richiesta POST all'API SMSmobile, che invia un messaggio WhatsApp a un numero di telefono specifico.

Utilizzo della libreria `http.client`

La libreria `http.client` è inclusa nella libreria standard di Python e può essere utilizzata anche per interagire con la tua 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()

Questo esempio mostra come utilizzare la libreria `http.client` per inviare una richiesta POST all'API. I parametri sono codificati in URL e inviati con le intestazioni appropriate.

Invia WhatsApp

Utilizzo dell'API `fetch`

L'API `fetch` è un modo moderno e versatile per effettuare richieste HTTP in JavaScript. Ecco come puoi usarla per inviare un messaggio WhatsApp tramite l'API SMSmobile:


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

Questo esempio mostra come inviare una richiesta POST utilizzando l'API `fetch`, supportata dalla maggior parte dei browser moderni.

Utilizzo di `XMLHttpRequest`

Se hai bisogno di supportare browser più vecchi, puoi utilizzare l'oggetto `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);

Questo esempio mostra come utilizzare `XMLHttpRequest` per inviare una richiesta POST, garantendo la compatibilità con i browser più vecchi che potrebbero non supportare `fetch`.

Invia WhatsApp

Utilizzo della libreria `axios`

La libreria `axios` è un popolare client HTTP per Node.js. Ecco come utilizzarla per inviare un messaggio WhatsApp tramite l'API SMSmobile:


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

        });

Questo esempio mostra come inviare una richiesta POST utilizzando `axios` in Node.js per interagire con SMSmobileAPI.

Invia WhatsApp

Utilizzo della libreria `Net::HTTP`

È possibile utilizzare la libreria `Net::HTTP` in Ruby per inviare un messaggio WhatsApp tramite 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

Questo esempio mostra come inviare una richiesta POST utilizzando `Net::HTTP` in Ruby a SMSmobileAPI.

È anche possibile inviare un messaggio WhatsApp e un SMS contemporaneamente.

Se hai domande, suggerimenti o hai bisogno di assistenza, il nostro team è qui per aiutarti.
Non esitate a contattarci a api@smsmobileapi.com

Funzionalità SMS

Funzionalità di WhatsApp

Plugin generali

Plugin per negozi online

API e documentazione per sviluppatori

Registro strumenti e modifiche

Documentazione di WhatsApp

Invia WhatsApp

Invia nuovamente il messaggio

Sincronizzazione

Recupera messaggi

Numero di controllo

Autenticazione

Invia API WhatsApp

Punto finale:

Parametri:

Esempio senza media:

Esempio con media:

Formattare il testo in WhatsApp:

Reinvia un messaggio WhatsApp non inviato

Punto finale:

Parametro:

Esempio:

Sincronizzazione per recuperare il messaggio

Punto finale:

Parametro:

Esempio:

Rispondere :

Recupera messaggio WhatsApp

Punto finale:

Parametro:

Esempio:

Rispondere :

Controlla il numero su WhatsApp

Punto finale:

Parametro:

Esempio:

Rispondere :

Autenticazione

1. Autenticazione tramite chiave API

2. Autenticazione OAuth2

Ottenere un token di accesso

Utilizzo del token di accesso:

Which Method Should You Use?

Invia messaggio WhatsApp

URL WSDL

Parametri:

Esempio

Invia WhatsApp

Comando cURL di base

Esempio di cURL in PHP

Invia WhatsApp

Utilizzo della libreria `requests`

Utilizzo della libreria `http.client`

Invia WhatsApp

Utilizzo dell'API `fetch`

Utilizzo di `XMLHttpRequest`

Invia WhatsApp

Utilizzo della libreria `axios`

Invia WhatsApp

Utilizzo della libreria `Net::HTTP`