Le risposte arrivano sul numero mobile che il tuo contatto già conosce.
SMSMobileAPI / API
RICEVUTO SMS API · IL TUO MOBILE RIMANE LA CASSELLA IN ENTRATA
Trasforma ogni SMS ricevuto sul tuo mobile in dati utilizzabili dall'applicazione.
Il tuo contatto invia un normale SMS al tuo numero mobile esistente. Il messaggio arriva prima sul telefono connesso, quindi SMSMobileAPI sincronizza in modo sicuro i dati supportati affinché la tua applicazione possa recuperarli, classificarli ed elaborare la risposta.
Nessun numero virtuale sostituisce il tuo telefono: il tuo mobile, la SIM e il numero esistente restano al centro dello scambio.
AUn contatto invia un SMS
“Puoi richiamarmi?”
+1 555 012 9841
Puoi richiamarmi?
/getsms/200sms.received
number+15550129841
deviceMobile commerciale
statusPRONTO
Il tuo software lo utilizza
Recupera il mittente, il messaggio, il mobile ricevente, il timestamp, il GUID e l'eventuale alias.
Centralizza le risposte preservando quale telefono connesso ha ricevuto ciascun SMS.
LA SEMPLICE SPIEGAZIONE
Il API non sostituisce il tuo telefono. Rende utilizzabili gli SMS ricevuti.
SMSMobileAPI aggiunge un livello software sicuro attorno alla reale casella in entrata del mobile. Ciò consente al tuo CRM, alla piattaforma di supporto o all'applicazione interna di accedere ai dati idonei dei messaggi ricevuti senza cambiare il numero usato dai tuoi contatti.
Un contatto invia un SMS
Il contatto scrive al numero reale associato alla tua SIM.
Il tuo mobile lo riceve
Il SMS arriva tramite il tuo operatore mobile sul telefono connesso.
L'app lo sincronizza
Con le autorizzazioni richieste e l'accesso in background, l'app ufficiale invia in modo sicuro i dati dei messaggi supportati al tuo account.
Il tuo software lo utilizza
Recuperalo con il REST API, ricevi un evento Webhook V2 o visualizzalo in un'integrazione compatibile.
UNA RISPOSTA CHE LA TUA APPLICAZIONE PUÒ UTILIZZARE
Una richiesta restituisce il messaggio e il contesto necessari per elaborarlo.
Usa GET /getsms/ per elencare gli SMS in ingresso sincronizzati. Filtra per mobile ricevente, richiedi solo i messaggi non letti o recupera i messaggi successivi a un timestamp Unix.
- number
- Il mittente in formato internazionale quando disponibile.
- message
- Il testo SMS sincronizzato dal mobile connesso.
- sIdentifiantPhone
- Il mobile connesso che ha ricevuto il SMS.
- timestamp_unix
- L'orario del messaggio, pronto per l'ordinamento e la sincronizzazione incrementale.
- guid
- Un riferimento stabile del messaggio per lo stato di lettura e le operazioni di follow-up.
- alias
- Un'etichetta opzionale per il contatto o l'applicazione.
{
"result": {
"error": "",
"sms": [{
"sIdentifiantPhone": "508b004b4aadacc4",
"timestamp_unix": 1774041814,
"message": "Can you call me back?",
"number": "+15550129841",
"guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
"alias": "Alex Morgan"
}]
}
}SCEGLI LA MODALITÀ DI CONSEGNA ADEGUATA
Recupera i messaggi tramite API — o reagisci immediatamente con Webhook V2.
Entrambi i metodi utilizzano gli stessi dati mobili connessi. Scegli in base al funzionamento della tua applicazione o combinali per reazioni rapide e recupero affidabile.
La tua applicazione richiede i messaggi quando è pronta.
- Crea una casella in entrata o una sincronizzazione pianificata
- Filtra per numero mobile, orario o stato non letto
- Recupera i messaggi dopo un'interruzione
SMSMobileAPI invia un evento sms.received alla tua destinazione HTTPS.
- Reagisci senza un ciclo di polling
- Utilizza consegna durevole e tentativi automatici
- Avvia un workflow non appena l'evento è disponibile
Più di una semplice lista di messaggi
Crea un workflow completo per i SMS ricevuti.
/getsms/Elenca i SMS ricevuti
Usa filtri per numero, data/ora e non letti per recuperare solo ciò di cui la tua applicazione ha bisogno.
/getsms/set-read/Segna come elaborato
Aggiorna lo stato di lettura API del SMSMobileAPI dopo che la tua applicazione ha gestito un messaggio.
/getsms/update/Allega un alias
Associa un nome contatto o un'etichetta dell'applicazione a un messaggio ricevuto.
/conversation/sms/list/Crea conversazioni
Raggruppa i messaggi in entrata e in uscita per numero di telefono per una cronologia di supporto o CRM.
Contrassegnare un messaggio come letto tramite il API non ne modifica lo stato di lettura all'interno dell'app di messaggistica del telefono.
Cosa puoi realizzare?
Da una singola risposta a un processo aziendale completo.
Crea una casella SMS condivisa
Instrada le risposte provenienti da più telefoni autorizzati in un'unica vista di supporto preservando il dispositivo ricevente.
Completa la cronologia del contatto
Aggiungi le risposte in arrivo al record cliente insieme agli SMS in uscita e all'attività di chiamata supportata.
Rileva automaticamente le conferme
Rileva conferme, cancellazioni o richieste di riprogrammazione e aggiorna il passo successivo.
Esegui l'escalation dei messaggi importanti
Notifica la persona giusta, invoca un API o avvia un'automazione Workflow Studio quando le condizioni corrispondono.
DA ZERO ALLA PRIMA RISPOSTA API
Ricevi il tuo primo SMS tramite il API in quattro passaggi controllati.
- 1
Installa e associa il dispositivo mobile
Installa l'ultima app ufficiale SMSMobileAPI e collega il telefono compatibile al tuo account.
- 2
Abilita l'accesso ai SMS ricevuti
Nell'app mobile, autorizza la sincronizzazione dei SMS ricevuti e l'esecuzione in background richiesta dal tuo workflow.
- 3
Invia un messaggio di test unico
Invia un SMS da un altro numero al dispositivo mobile connesso e verificane la voce nel log della dashboard dei SMS ricevuti.
- 4
Invoca l'endpoint in modo sicuro
Tieni la chiave API sul tuo server, chiama /getsms/ e memorizza il GUID in modo che la tua applicazione possa evitare l'elaborazione duplicata.
FAQ su RECEIVED SMS API
Domande che sviluppatori e team operativi si pongono per primi.
Il API riceve il SMS invece del mio telefono?
No. Il tuo dispositivo mobile compatibile connesso e la sua SIM ricevono il SMS per primi. SMSMobileAPI poi sincronizza i dati dei messaggi supportati affinché possano essere recuperati dal tuo software.
Più dispositivi mobili possono alimentare la stessa applicazione?
Sì. Più dispositivi mobili autorizzati possono essere collegati a un account e l'identificatore del dispositivo ricevente permette alla tua applicazione di preservare la fonte di ogni messaggio.
Dovrei usare il polling o Webhook V2?
Usa GET /getsms/ quando la tua applicazione controlla la pianificazione del recupero o necessita di recupero. Usa l'evento Webhook V2 di sms.received quando desideri che una destinazione HTTPS reagisca non appena l'evento è disponibile. Molti sistemi di produzione combinano entrambe le soluzioni.
Come evito di elaborare lo stesso messaggio due volte?
Memorizza il GUID del messaggio nella tua applicazione e rendi l'elaborazione idempotente. Dopo l'elaborazione riuscita, puoi anche aggiornare lo stato di lettura API di SMSMobileAPI.
Segnare un messaggio come letto modifica la casella dei messaggi del telefono?
No. L'endpoint modifica lo stato di lettura lato API usato dai workflow di SMSMobileAPI; non segna il messaggio come letto nell'app di messaggistica del telefono.
Posso rispondere dalla mia applicazione?
Sì. La tua applicazione può chiamare l'endpoint di invio di SMS in modo che un dispositivo mobile connesso selezionato invii la risposta tramite la sua SIM e il suo numero di telefono.
Fai in modo che il tuo software comprenda ogni risposta utile ricevuta dal tuo dispositivo mobile.
Collega un telefono, autorizza la sincronizzazione received-SMS e testa l'intero percorso prima di estenderlo al tuo CRM, piattaforma di supporto o automazione.
