1. Ottenere un token:

Descrizione: Dopo aver eseguito con successo questa interrogazione, riceverai un token. Successivamente, puoi usare questo token per accedere al server e fare richieste aggiuntive.
Endpoint https://smsgateway24.com/getdata/gettoken
Metodo:: GET

Parametri della richiesta:

Variabile	Tipo	Descrizione
email	string	[obbligatorio] Your login in the system. Usually email
pass	string	[obbligatorio] Your password in the system

Risposta formattata JSON::

Variabile	Tipo	Descrizione
token	string	Il token viene acquisito attraverso il metodo di recupero token:
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta:
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f41119fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

2. Send single message using TOKEN:

Descrizione: Creates one outgoing message on the server. The message can be sent through the selected channel of your connected Android device.
Endpoint https://smsgateway24.com/getdata/addsms
Metodo: GET, POST (Usa %2B invece del segno plus '+' nella richiesta GET)

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
sendto	string	[obbligatorio] Recipient address or phone number. Multiple values can be separated by commas.
body	string	[obbligatorio] Message body. Not required when sending an image (see the "file" parameter below) — in that case body will be replaced with the uploaded image URL.
device_id	int	[obbligatorio] Id Del Dispositivo
sim	int	[obbligatorio] Sim slot: 0 and 1 for SMS. 2 - Whatsapp Business, 3 - WhatsApp Personal. 4 and 5 - RCS.
timetosend	string YYYY-MM-DD o YYYY-MM-DD HH:MM:SS	[opzionale] Tempo indicato per l'invio di un messaggio. Per esempio, 2026-05-29 17:21:27
customerid	int	[opzionale] Numero ID del cliente. Campo opzionale
urgent	int	[opzionale] Marks the message as urgent. Useful for OTP and high-priority traffic.
file	file (multipart/form-data)	[opzionale] Image file to send (jpeg, png, webp, gif). When provided, the request must be sent as multipart/form-data with POST. The file is uploaded to our S3 storage and its public URL replaces the "body" field, so the image is delivered to the recipient (currently supported on WhatsApp / WhatsApp Business slots) and is also displayed in the corresponding chat. This parameter is fully optional — existing integrations that only send text messages can keep working without any changes.

Backwards compatibility: the "file" parameter is optional. If you do not send a file, the endpoint behaves exactly as before — your existing text-only integrations require no changes.

Risposta formattata JSON:

Variabile	Tipo	Descrizione
error	int	0 or 1 - indicates whether there is an error in processing the request
message	string	Messaggio di errore, vuoto se tutto è in ordine.
sms_id	int	Created message identifier in our system.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle Esempio di risposta:

{
    "error": 0,
    "sms_id": 62807347,
    "message": "Sms has been saved successfully"
}

2.1 Legacy method: send single SMS using login and password

Deprecated. Use token-based authentication for new integrations. This method is kept only for backward compatibility.

Endpoint https://smsgateway24.com/getdata/smstosend
Metodo: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
email	string	[obbligatorio] La tua email
pass	string	[obbligatorio] La tua password
sendto	string	[obbligatorio] Recipient address or phone number.
body	string	[obbligatorio] Corpo del messaggio
device_id	int	[obbligatorio] Id Del Dispositivo
sim	int	[obbligatorio] Sim slot: 0 and 1 for SMS. 2 - Whatsapp Business, 3 - WhatsApp Personal. 4 and 5 - RCS
timetosend	string	[opzionale] Scheduled sending time.
customerid	int	[opzionale] Your customer identifier.
urgent	int	[opzionale] Marks the message as urgent.

3. Invio di SMS in massa utilizzando JSON

Descrizione: Crea SMS sul server da inviare. Dopo di che, il telefono con l'applicazione Smsgateway24 chiama il server e prende l'SMS e lo invia dalla scheda SIM Scarica l'applicazione al link
Endpoint https://smsgateway24.com/getdata/addalotofsms
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
datajson	string	[obbligatorio] {"token":"df427bfcf113c9a21c67718035076b5b","smsdata":[{"sendto":"015752982212","body":"Test message","sim":1,"timetosend":"2019-07-01 23:50:00","device_id":260},{"sendto":"+4915752982212","body":"Test message 2","sim":1,"timetosend":"2019-07-01 23:50:00","device_id":260,"urgent":1}]}

Risposta formattata JSON::

Variabile	Tipo	Descrizione
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Request example:

{
   "token":"df427bfcf113c9a21c6771803501",
   "smsdata":[
        {
            "sendto":"015752982212",
            "body":"Your password is 12345",
            "sim":1,
            "timetosend":"2019-07-01 23:50:00",
            "device_id":260,
            "customerid":122,
            "urgent":1
        },
        {
            "sendto":"015752982212",
            "body":"Regular SMS. Not urgnet",
            "sim":1,
            "timetosend":"2019-07-01 23:50:00",
            "device_id":260,
            "customerid":122,
            "urgent":0
        }
    ]
}

4. Ottieni tutti gli SMS (inclusi gli SMS in entrata):

Descrizione: Questa richiesta consente di recuperare tutti i messaggi associati al tuo account, inclusi gli SMS in arrivo dai clienti. Tutte le variabili di input sono obbligatorie in questo metodo e i messaggi SMS possono variare di stato.
Endpoint: https://smsgateway24.com/getdata/getallsms
Metodo: GET, POST (Utilizzare %2B invece del segno più "+" nella richiesta GET)

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
device_id	string	[opzionale] Id Del Dispositivo
status	int	[opzionale] 1 - SMS In Attesa 2 - SMS presi per telefono 3 - In coda per l'invio. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2." 5 - Sms In Arrivo 6 - SMS inviati per telefono 7 - Gli SMS sono stati spediti 8 - SMS NON consegnato 9 - SMS non SENT affatto - Errore generico. (Leggi cosa fare con questo errore qui) Altri errori meno comuni: 10 - SMS Non Inviato - No Service 11 - SMS Non Inviato - Null PDU 12 - SMS Non Inviato - Radio Off 100, 101 - SMS Non Inviato - NOT ALLOWED. (Non sono state concesse autorizzazioni per l'invio di SMS nell'applicazione)
begindate	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[opzionale] Begin Date Time
enddate	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[opzionale] End Date Time
sim	int	[opzionale] Sim slot: 0 and 1 for SMS. 2 - Whatsapp Business, 3 - WhatsApp Personal. 4 and 5 - RCS # 0 or 1
customerid	int	[opzionale] Numero ID del cliente. Campo opzionale
onlycount	int	[opzionale] 0 \| 1 conteggio solo
phone	string	[opzionale] 0 \| 1 Filtro numero di telefono
orderbydesc	int	[opzionale] 0 \| 1 Order by any field
timezone	int	[opzionale] Specifica il tuo fuso orario locale, ad esempio impostandolo in Australia/Sydney.

Risposta formattata JSON::

Variabile	Tipo	Descrizione
token	string	Il token viene acquisito attraverso il metodo di recupero token:
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine
count	int	SMS amount
smss	int	JSON object

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta ... :


            {
    "smss": {
        "62050971": {
            "id": 62050971,
            "sendto": "+4912312312332",
            "body": "Hello! Thank you for Order! ",
            "customerid": null,
            "status": 2,
            "statustitle": "sending",
            "deviceid": 11231,
            "urgent": null,
            "created": {
                "date": "2023-11-02 22:44:43.000000",
                "timezone_type": 3,
                "timezone": "Europe/Paris"
            },
            "senttime": null,
            "timetosend": null,
            "paketid": null,
            "pakettitle": null,
            "paketbody": null
        },
        "62051117": {
            "id": 62051117,
            "sendto": "+4912312312332",
            "body": "Hello! Thank you for Order! ",
            "customerid": null,
            "status": 7,
            "statustitle": "delivered",
            "deviceid": 11231,
            "urgent": null,
            "created": {
                "date": "2023-11-02 22:46:09.000000",
                "timezone_type": 3,
                "timezone": "Europe/Paris"
            },
            "senttime": null,
            "timetosend": null,
            "paketid": null,
            "pakettitle": null,
            "paketbody": null
        }
            }
            }

5. Aggiungi un nuovo elenco contatti

Descrizione: Il tag è necessario per generare una newsletter mirata a un gruppo di numeri. Per esempio, usa il tag Dipendenti
Endpoint https://smsgateway24.com/getdata/savetag
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
title	string	[obbligatorio] Nome etichetta

Risposta formattata JSON::

Variabile	Tipo	Descrizione
tag_id	int	Tag ID
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta:

{
    "error": 0,
    "tag_id": 8303,
    "message": "OK"
}

6. Aggiungi contatti all'elenco contatti:

Descrizione: Aggiungi contatti per qualsiasi tag. Ad esempio, per il tag * Dipendenti * i tuoi colleghi saranno perfettamente in forma.
Endpoint https://smsgateway24.com/getdata/savecontact
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
phone	string	[obbligatorio] phone number
ctag_id	int	[obbligatorio] Tag ID
fullname	string	[obbligatorio] Nome del tuo cliente

Risposta formattata JSON::

Variabile	Tipo	Descrizione
contact_id	int	Contact Id
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta ... :
{"error":0,"contact_id":15954765,"message":"ok"}

7. Crea una newsletter

Descrizione:Una volta che hai creato il tag, puoi fare la mail sui telefoni tag.
Endpoint https://smsgateway24.com/getdata/savepaket
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
title	string	[obbligatorio] Titolo della newsletter
device_id	string	[obbligatorio] Id Del Dispositivo
body	string	[obbligatorio] Corpo messaggio obiettivo
tags	string	[obbligatorio] Tag Id. Può essere diverso, separato da virgole. Per esempio: 12,13,14
sim	int	[obbligatorio]Sim slot: 0 and 1 for SMS. 2 - Whatsapp Business, 3 - WhatsApp Personal. 4 and 5 - RCS 0 or 1
time_to_send	int, default = 0	[obbligatorio]Date time when Newsletter should be sent. Do not forget tap start on device. DD.MM.YYYY H:i:s

Risposta formattata JSON::

Variabile	Tipo	Descrizione
contact_id	int	Id Contatto
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.
paket_id	int	Package ID

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta ... :
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f4f49fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

8. Ottieni elenco dispositivi

Descrizione: Puoi scoprire tutto sui tuoi dispositivi.
Endpoint https://smsgateway24.com/getdata/getalldevices
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.

Risposta formattata JSON::

Variabile	Tipo	Descrizione
count	int	Numero di dispositivi:
device	json	id - Id Del Dispositivo title - Nome Del Dispositivo created - Data Creazione Dispositivo createdhumanformat - Dispositivo creato data in formato regolare lastseen - La data in cui il dispositivo è stato visto l'ultima volta lastseenhumanformat - La data in cui il dispositivo è stato visto l'ultima volta serialnumber - Numero di serie del dispositivo siminfo - Informazioni sulle schede SIM in JSON appversion - La versione dell'applicazione installata sul dispositivo subscription - C'è un abbonamento sul dispositivo
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta:

    {
    "count": 2,
    "device": {
        "1576": {
            "id": 1576,
            "title": "AOSP_on_IA_Emulator",
            "number": null,
            "imei": "358240051111110",
            "created": {
                "date": "2020-03-28 20:10:29.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "createdhumanformat": "28.03.2020 20:10:29",
            "lastseen": {
                "date": "2020-04-23 17:02:21.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "lastseenhumanformat": "23.04.2020 17:02:21",
            "serialnumber": "EMULATOR30X0X5X0",
            "siminfo": [
                {
                    "Slot": "0",
                    "IccId": "89014103211118510720",
                    "Number": " 15555215554",
                    "Roaming": "0",
                    "CountryIso": "us",
                    "CarrierName": "Android (T-Mobile)"
                }
            ],
            "appversion": "12.1.21",
            "isappversionactual": false,
            "delaybetweeneachsms": null,
            "delaybetweenrequest": 1,
            "subscription": true
        },
        "1297": {
            "id": 1297,
            "title": "Android_SDK_built_for_x86",
            "number": null,
            "imei": "null",
            "created": {
                "date": "2020-01-20 14:01:05.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "createdhumanformat": "20.01.2020 14:01:05",
            "lastseen": {
                "date": "2020-04-20 20:51:34.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "lastseenhumanformat": "20.04.2020 20:51:34",
            "serialnumber": "unknown",
            "siminfo": [
                {
                    "Slot": "0",
                    "IccId": "8949226172233934327",
                    "Number": "+4915752982212",
                    "Roaming": "1",
                    "CountryIso": "de",
                    "CarrierName": "Drillisch (o2)"
                }
            ],
            "appversion": "12.1.21",
            "isappversionactual": false,
            "delaybetweeneachsms": 5,
            "delaybetweenrequest": 10,
            "subscription": false
        }
    }
}

9. Ottieni lo stato di consegna di un singolo SMS

Descrizione: Puoi trovare lo stato di consegna di ogni SMS con questo metodo
Endpoint https://smsgateway24.com/getdata/getsmsstatus
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
sms_id	int	[obbligatorio] Sms Id

Risposta formattata JSON::

Variabile	Tipo	Descrizione
sms_id	int	SMS ID
status	int	SMS Status 1 - SMS In Attesa 2 - SMS presi per telefono 3 - In coda per l'invio. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2." 5 - Sms In Arrivo 6 - SMS inviati per telefono 7 - Gli SMS sono stati spediti 8 - SMS NON consegnato 9 - SMS non SENT affatto - Errore generico. (Leggi cosa fare con questo errore qui) Altri errori meno comuni: 10 - SMS Non Inviato - No Service 11 - SMS Non Inviato - Null PDU 12 - SMS Non Inviato - Radio Off 100, 101 - SMS Non Inviato - NOT ALLOWED. (Non sono state concesse autorizzazioni per l'invio di SMS nell'applicazione)
status_description	string	Nome Stato
error	int	0 \| 1 - si è verificato un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta:
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f4f49fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

Accesso rapido

API and integration documentation

Riferimento API

SDKs & tools

Plugins & integrations

1. Ottenere un token:

2. Send single message using TOKEN:

2.1 Legacy method: send single SMS using login and password

3. Invio di SMS in massa utilizzando JSON

4. Ottieni tutti gli SMS (inclusi gli SMS in entrata):

5. Aggiungi un nuovo elenco contatti

6. Aggiungi contatti all'elenco contatti:

7. Crea una newsletter

8. Ottieni elenco dispositivi

9. Ottieni lo stato di consegna di un singolo SMS

Accesso rapido

Api documentation - smsgateway24

API and integration documentation

Riferimento API

SDKs & tools

Plugins & integrations

1. Ottenere un token:

2. Send single message using TOKEN:

2.1 Legacy method: send single SMS using login and password

3. Invio di SMS in massa utilizzando JSON

4. Ottieni tutti gli SMS (inclusi gli SMS in entrata):

5. Aggiungi un nuovo elenco contatti

6. Aggiungi contatti all'elenco contatti:

7. Crea una newsletter

8. Ottieni elenco dispositivi

9. Ottieni lo stato di consegna di un singolo SMS