Documentazione SMS

Invia SMS

Punto finale: 

Parametri:

Esempio di richiesta:

Esempio di risposta JSON:

{ "risultato": { "errore": 0, "inviato": "1", "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "nota": "inviato da cellulare", "data e ora": "2026-03-20T21:07:44Z", "data e ora locale": "2026-03-20T22:07:44+01:00", "porta": null, "controllo_iac": "1", "autorizzato_iac": "1", "invia_con_whatsapp": "0", "crittografato": { "stato": "0" }, "account_di_prova": { "stato": "0", "sms_inviati": 0 } } }

Spiegazione della risposta:

Reinvia un SMS non inviato

Questo endpoint consente di reinviare un SMS non inviato in precedenza, solo se il messaggio si trova attualmente in stato di errore.

Punto finale:

Parametri: 

Esempio di richiesta: 

Esempio di risposta JSON:

{ "risultato": { "errore": "0", "sms": "reinviato con successo", "tentativo": 1 } }

Spiegazione della risposta:

Registro degli SMS inviati dall'API

Questo endpoint consente di recuperare il registro dei messaggi SMS inviati tramite l'API.

Punto finale: 

Parametri:

Esempio di richiesta:

Esempio di risposta JSON:

{ "risultato": { "errore": "0", "sms": [ { "sIdentifiantPhone": "abbg00055x5", "porta": 0, "data_aggiunta": "2026-03-20", "ora_aggiunta": "22:07:44", "timestamp": 1774044464, "invio_da_mobile": 1, "data_invio_da_mobile": "2026-03-20", "ora_invio_da_mobile": "22:10:05", "timestamp_invio_da_mobile": 1774044605, "destinatari": "32495898697", "sms": "test", "error_api": "", "errore_invio_da_mobile": "", "messaggio_guid": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "timearea": "UTC+01", "date_add_server": "2026-03-20", "hour_add_server": "21:07:44", "timestamp_server": 1774040864, "send_from_mobile_date_server": "2026-03-20", "send_from_mobile_heure_server": "21:10:05" } ] } }

Spiegazione della risposta:

Elenco degli SMS inviati dal cellulare

Questo endpoint consente di visualizzare l'elenco dei messaggi SMS inviati dal dispositivo mobile e sincronizzati con l'account SMSMobileAPI.

Importante: Questa funzionalità è disponibile a partire dalla versione Android 4.1.20.

Importante: Questa caratteristica è non abilitato per impostazione predefinita nell'app Android.

Privacy: Tutte le informazioni sincronizzate vengono anonimizzate, rese riservate e gestite in modo sicuro.

Limite storico: Questa API restituisce dati solo dall'ultimo 7 giorni.

Nota: Se invii SMS utilizzando l'endpoint API standard https://api.smsmobileapi.com/sendsms/Questi SMS potrebbero comparire in questo elenco anche perché vengono effettivamente inviati dal tuo dispositivo mobile.

Punto finale:

Parametri: 

Campi restituiti: 

Esempio di richiesta: 

Esempio con filtri:

Esempio con periodo predefinito:

Esempio di risposta JSON:

{ "risultato": { "errore": "0", "conteggio": 200, "limite": 200, "limite_cronologia_giorni": 7, "ordina_per": "data_mobile_ms", "ordine_ordinamento": "DESC", "sms": [ { "sIdentificativo": "508b004b4aadacc4", "numero": "+15551234567", "messaggio": "Ciao, il tuo appuntamento è stato confermato.", "data_mobile_ms": 1774041004692, "formattato_data_mobile": "2026-03-20 22:10:04", "ora_sincronizzazione": "2026-03-20 21:10:05" }, { "sIdentificativo": "e5b70a8a28b2ec3d", "numero": "+447700900123", "message": "Il tuo codice di verifica è 482915.", "mobile_date_ms": 1774040902284, "mobile_date_formatted": "2026-03-20 22:08:22", "synchro_time": "2026-03-20 21:08:35" }, { "sIdentifiant": "e5b70a8a28b2ec3d", "number": "+33198765432", "message": "Grazie per il tuo ordine. È in fase di elaborazione.", "mobile_date_ms": 1774026491230, "mobile_date_formatted": "2026-03-20 18:08:11", "synchro_time": "2026-03-20 17:19:19" } ] } }

Spiegazione della risposta:

SMS ricevuto

Questo endpoint consente di recuperare i messaggi SMS ricevuti sullo smartphone. 

Punto finale:

Parametri: 

Esempio di richiesta:

Esempio di risposta JSON:

{ "risultato": { "errore": "", "sms": [ { "id": 466340, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "data": "2026-03-20", "ora": "21:23:34", "timestamp_unix": 1774041814, "ora_ricevuta": "20260320222332804", "indice": "27593", "messaggio": "Ciao, il tuo pacco è stato consegnato.", "numero": "+15551234567", "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466341, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320221005892", "indice": "27591", "message": "Il tuo appuntamento è confermato per domani.", "number": "+447700900123", "guid": "BF3B38D7-8401-4A8C-8BA6-D8D58ACBB23E", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466324, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:08:24", "timestamp_unix": 1774040904, "time_received": "20260320220822763", "indice": "27590", "message": "Per favore, richiamaci quando sei disponibile.", "number": "+33198765432", "guid": "08C88E20-9B98-453F-B361-9BB06D3275D6", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466156, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "ora": "19:05:22", "timestamp_unix": 1774033522, "ora_ricevuta": "20260320200026246", "indice": "27588", "messaggio": "Promemoria: la revisione del tuo account è in sospeso.", "numero": "10001", "guid": "551B2CF4-9330-4DD2-B2BA-5A4026EEEB15", "alias": null, "apikey": "YOUR_API_KEY_HASH" } ] } }

Spiegazione della risposta:

Contrassegna i messaggi SMS ricevuti come letti

Questo endpoint API viene utilizzato per contrassegnare un messaggio SMS ricevuto come letto nel Solo stato API.
Ciò non modifica lo stato di lettura sullo smartphone.  

Punto finale:

Parametro: 

Esempio:

Aggiorna l'alias SMS

Questo endpoint API viene utilizzato per aggiornare l'alias di un SMS ricevuto utilizzando il suo GUID.

Nota: IL alias Il parametro può essere vuoto. In tal caso, l'alias verrà cancellato.

Punto finale:

Parametri: 

Esempio: 

Esempio per cancellare l'alias:

Elimina SMS

Questo endpoint consente di eliminare i messaggi SMS dal registro del server SMSMobileAPI.

Punto finale: 

Parametri:

Esempio di richiesta:

Esempio di risposta JSON:

{ "risultato": { "errore": null, "conteggio_eliminazioni": 1 } }

Spiegazione della risposta:

Nota: vengono eliminati solo gli SMS memorizzati nei log del server SMSMobileAPI. I messaggi SMS già memorizzati sul dispositivo mobile non vengono eliminati.

Elenco delle conversazioni SMS

Questo endpoint API viene utilizzato per elencare le conversazioni SMS collegate al tuo account.

Ogni conversazione è raggruppata per numero di telefono e contiene i relativi messaggi SMS in entrata e in uscita.

Nota: Il punto di partenza della conversazione è definito da origineConversation parametro:

• received: le conversazioni vengono rilevate per la prima volta dagli SMS ricevuti in logsmsreceive
• sent: le conversazioni vengono rilevate per la prima volta dagli SMS inviati in logsmssent

Nota: Se numero non è fornito, l'API restituisce solo le conversazioni più recenti. Per impostazione predefinita, l'ultima 20 Le conversazioni vengono risposte.

Nota: Per gli SMS in uscita, se timearea_of_message è disponibile (esempio: UTC+02), la data visualizzata viene convertita automaticamente utilizzando questo valore. Questa data convertita viene utilizzata anche per l'ordinamento.

Nota: Se resume=1Vengono restituiti solo i messaggi più recenti di ogni conversazione. Utilizzare resume_line_how per definire quanti messaggi recenti devono essere inclusi.

Punto finale:

Parametri: 

Dettagli sul comportamento: 

Esempio 1 - Elenca le ultime conversazioni dagli SMS ricevuti: 

Esempio 2 - Elenca le conversazioni più recenti dagli SMS inviati:

Esempio 3 - Filtrare un numero di telefono specifico:

Esempio 4 - Filtra per intervallo di date:

Esempio 5 - Modalità Riprendi con gli ultimi 3 messaggi per conversazione:

Esempio di risposta positiva: 

{ "successo": vero, "origineConversazione": "ricevuto", "ripresa": 0, "ripresa_linea": null, "conversazioni": [ { "numero_telefono": "+10470000001", "alias_contatto": "John Doe", "messaggi": [ { "direzione": "in entrata", "ID_messaggio": "msg_1001", "data": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "messaggio": "Ciao, vorrei maggiori informazioni.", "stato": "ricevuto", "sid_mobile": "sid_dispositivo_1" }, { "direzione": "in uscita", "ID_messaggio": "msg_1002", "data": "2026-03-13 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "Certo, cosa vorresti sapere?", "status": "inviato", "mobile_sid": "device_sid_2" } ] } ] }

Campi di risposta:

Esempio di errore:

{ "successo": falso, "errore": "Parametro obbligatorio mancante: apikey" }

Note:

Gateway – Elenca i cellulari connessi

Elenca i cellulari connessi al tuo Gateway SMS.

Punto finale:

Parametri:

Esempio:

Gateway – Aggiorna un'etichetta mobile

Aggiorna l'etichetta (nom_reference) di un dispositivo mobile connesso.

Punto finale:

Parametri:

Esempio:

Importante: l'etichetta è obbligatoria ma può essere vuota (etichetta=).

Gateway – Elimina un cellulare connesso

Rimuovi un dispositivo mobile connesso dal tuo gateway (elimina tutte le righe della cronologia per questo SID).

Punto finale:

Parametri:

Esempio:

Webhook – SMS ricevuto

Questo sistema webhook invia una richiesta POST all'URL configurato ogni volta che riceve un SMS. Il sistema garantisce aggiornamenti in tempo reale inviando i dettagli dell'SMS all'URL webhook specificato.

Come configurare il webhook nella dashboard

Per impostare l'URL del webhook nella dashboard, segui questi passaggi:

1. Accedi al tuo account su Dashboard API mobile SMS.
2. Vai a Impostazioni webhook sezione.
3. Inserisci l'URL del tuo webhook (ad esempio, https://example.com/webhook-endpoint).
4. Fare clic su Salva Webhook pulsante. 
5. Una volta salvato, il sistema inizierà a inviare i dettagli SMS all'URL configurato.

Payload del webhook

Quando viene ricevuto un SMS, il sistema invia il seguente payload JSON all'URL del webhook:

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "Ciao, questo è un test.", "number": "+123456789", "guid": "abcde12345" }

Campi del carico utile:

• data: Data in cui è stato aggiunto l'SMS (AAAA-MM-GG).
• ora: Ora in cui è stato aggiunto l'SMS (HH:mm:ss).
• tempo_ricevuto: Ora in cui è stato ricevuto l'SMS.
• messaggio: Contenuto dell'SMS. 
• numero: Numero di telefono del mittente.
• guida: Identificatore univoco dell'SMS.

Esempio di endpoint webhook

Il tuo server dovrebbe essere pronto a gestire le richieste POST in arrivo. Di seguito è riportato uno script PHP di esempio per elaborare il payload del webhook:

Test del webhook

Per testare la configurazione del webhook, utilizza strumenti come:

• Webhook.sito
• RequestBin

Risoluzione dei problemi

• Assicurarsi che l'URL del webhook sia corretto e accessibile al pubblico.
• Verifica che il tuo server restituisca un codice di stato HTTP 200 per le richieste andate a buon fine.
• Controlla i log del server per eventuali errori nell'elaborazione del payload.

SMS arricchiti

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

 Questo metodo richiede una chiave API che può essere inclusa come parametro in una richiesta GET o POST.

2. Autenticazione OAuth2

OAuth2 fornisce un metodo di autenticazione più sicuro.
Utilizzare un ID client e un segreto client per ottenere un token di accesso, quindi includerlo nel Autorizzazione intestazione.

Client_id e client_secret sono disponibili nella dashboard.
Scarica subito l'app mobile O accedi alla tua dashboard.

Ottenere un token di accesso

Utilizzo del token di accesso:

Quale metodo dovresti usare?

- Utilizzo Autenticazione tramite chiave API per integrazioni rapide e semplici.

- Utilizzo Autenticazione OAuth2 per una maggiore sicurezza e scalabilità.