Come verificare se un SMS è stato letto o consegnato dal gateway

Se gestisci un'attività di servizi locali come una clinica medica, una scuola di ripetizioni o un'officina meccanica, sapere se i tuoi clienti vedono effettivamente i tuoi messaggi è fondamentale. In questo tutorial spiegheremo come verificare lo stato di lettura di un SMS dal gateway, faremo chiarezza sui limiti tecnici dei protocolli SMS e ti mostreremo come implementare un tracciamento affidabile della consegna e della lettura per le tue notifiche in uscita.

Fase 1: Comprendere la differenza tra lo stato di consegna e di lettura degli SMS

Prima di immergerti nelle integrazioni API, è fondamentale comprendere la differenza tecnica tra lo stato di consegna e di lettura degli SMS. La tecnologia SMS tradizionale si basa su protocolli cellulari progettati decenni fa. In questo contesto, "gli utenti possono comunicare utilizzando rapidi aggiornamenti di stato di 160 caratteri o meno." A causa di questa infrastruttura legacy, la rete di telecomunicazioni globale supporta solo le ricevute di consegna, non quelle di apertura o lettura.

Questo è molto diverso dalle moderne app di messaggistica istantanea (come WhatsApp, iMessage o RCS), dove "questo flusso libero di comunicazione consente di inviare messaggi, immagini e video a chiunque" con indicatori di digitazione nativi e le doppie spunte blu di "lettura". Gli SMS standard degli operatori telefonici non dispongono di un pacchetto di rete nativo che indichi al gateway quando un utente ha toccato un messaggio di testo per aprirlo.

Invece, ci affidiamo al significato degli stati del gateway SMS mappati dal tuo fornitore di servizi. Ecco cosa significano solitamente questi stati nei log del tuo gateway SMS:

Per monitorare con precisione se un messaggio è stato effettivamente letto, le aziende utilizzano una combinazione di rapporti di consegna a livello di operatore e link di tracciamento intelligenti a livello di applicazione, che configureremo nei passaggi successivi.

Fase 2: Configurare il gateway SMS Android per verificare lo stato di consegna degli SMS

Per iniziare a tracciare i tuoi messaggi, hai bisogno di un gateway SMS che mostri nativamente i rapporti di consegna senza nasconderli dietro costosi contratti aziendali. I gateway tradizionali come Twilio richiedono una complessa registrazione A2P 10DLC, l'approvazione dell'operatore e applicano tariffe elevate per segmento. Un'alternativa più semplice ed economica per le piccole imprese è MySMSGate.

MySMSGate trasforma il tuo telefono Android e la tua scheda SIM in un gateway SMS. Poiché invii dal tuo numero di telefono locale, eviti i blocchi di registrazione degli operatori e puoi facilmente verificare lo stato di consegna degli SMS direttamente dalla tua dashboard o tramite API.

Per configurare il tuo gateway e iniziare a tracciare lo stato di consegna, segui questi passaggi:

1. Vai alla pagina di registrazione di MySMSGate e crea un account gratuito.
2. Scarica e installa l'applicazione Android di MySMSGate sul tuo telefono.
3. Scansiona il codice QR mostrato sulla dashboard web utilizzando l'app mobile per collegare istantaneamente il tuo telefono. Non è necessario digitare manualmente alcuna chiave API.
4. Invia un SMS di prova dalla dashboard web.

Una volta inviato il messaggio, il tuo telefono Android restituirà in tempo reale il rapporto di consegna dell'operatore alla tua dashboard di MySMSGate. Se un messaggio non viene consegnato, MySMSGate rimborsa automaticamente il tuo saldo, proteggendo i tuoi costi operativi.

Fase 3: Configurare il webhook di callback dello stato dei rapporti di consegna del gateway SMS Android

Per gli sviluppatori che integrano le notifiche SMS nel proprio CRM, motore di prenotazione o software personalizzato, effettuare il polling di un endpoint API per verificare lo stato di consegna è inefficiente. Dovresti invece configurare un callback per lo stato dei rapporti di consegna del gateway SMS Android utilizzando i webhook (android-sms-gateway delivery reports status callback).

Questa sezione spiega come ottenere lo stato di consegna degli SMS da un webhook API. Quando il tuo telefono Android connesso consegna il messaggio al dispositivo del destinatario, riceve un rapporto di consegna interno dall'operatore locale. MySMSGate cattura questo evento e invia istantaneamente l'aggiornamento di stato al tuo server.

Ecco un esempio di come gestire il payload del callback dello stato dei rapporti di consegna del gateway SMS Android (android-sms-gateway delivery reports status callback sms) in un'applicazione Python Flask:

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/webhooks/sms-status', methods=['POST'])
def handle_sms_status_callback():
    data = request.json
    
    # Extract key parameters from the MySMSGate webhook payload
    message_id = data.get('message_id')
    status = data.get('status')  # e.g., 'delivered', 'failed', 'sent'
    recipient = data.get('to')
    error_code = data.get('error_code')
    
    print(f"Message {message_id} to {recipient} updated to status: {status}")
    
    if status == 'delivered':
        # Update your database to mark notification as delivered
        # update_booking_notification_status(message_id, 'Delivered')
        pass
    elif status == 'failed':
        # Handle failed delivery (e.g., alert staff, retry via alternative channel)
        # log_failed_delivery(message_id, error_code)
        pass
        
    return jsonify({"status": "success"}), 200

if __name__ == '__main__':
    app.run(port=5000)

Implementando questo callback, la tua applicazione backend rimarrà sempre sincronizzata con lo stato in tempo reale dei tuoi messaggi in uscita, consentendoti di creare flussi di lavoro automatizzati per i tentativi di invio non riusciti.

Fase 4: Tracciare lo stato effettivo di "Lettura" utilizzando il tracciamento intelligente dei link

Poiché i protocolli SMS standard non supportano una ricevuta di "Lettura" nativa, in che modo le aziende di servizi intelligenti tracciano effettivamente se un cliente ha aperto e letto il messaggio? La soluzione standard del settore è il Tracciamento intelligente dei link (Smart Link Tracking).

Invece di inviare un semplice messaggio di testo, includi un link di tracciamento abbreviato e univoco nel tuo SMS. Quando il destinatario tocca il link, viene brevemente reindirizzato attraverso il tuo server di tracciamento prima di essere indirizzato alla destinazione finale (come una fattura, una conferma di prenotazione o la pagina dei dettagli dell'appuntamento). Questo reindirizzamento avviene in pochi millisecondi e funge da "Ricevuta di lettura".

Ecco il flusso di lavoro passo-passo per implementare questo sistema:

1. Genera un token univoco: per ogni SMS inviato, genera un identificatore breve e univoco (ad es. myshop.co/r/x89D2).
2. Mappa the token in your database: associa x89D2 al numero di telefono del destinatario, al messaggio specifico inviato e a uno stato di "Lettura" inizializzato su False.
3. Invia l'SMS: invia il messaggio contenente l'URL breve tramite l'API o la dashboard di MySMSGate.
4. Registra il reindirizzamento: quando l'utente tocca il link, il tuo server registra la richiesta in arrivo per x89D2, aggiorna il record del database su Read = True insieme al timestamp e reindirizza immediatamente l'utente alla pagina di destinazione effettiva.

Questo metodo ti offre un tracciamento della lettura accurato al 100% e fornisce dati preziosi sul coinvolgimento degli utenti, aiutandoti a ottimizzare i tuoi modelli di comunicazione.

Fase 5: Confrontare il tracciamento dello stato degli SMS tra i vari gateway

Quando si seleziona una piattaforma per la propria attività, è utile esaminare il modo in cui i diversi gateway gestiscono il tracciamento delle consegne, i prezzi e la complessità del sistema. Sebbene molti sviluppatori cerchino un tutorial sul callback dello stato di consegna degli SMS di Twilio (twilio sms delivery status callback tutorial), spesso scoprono che configurare e mantenere l'infrastruttura cloud di Twilio per semplici notifiche locali è eccessivamente complesso e costoso.

Di seguito è riportato un confronto diretto delle funzionalità di tracciamento e delle caratteristiche tra MySMSGate e i gateway cloud tradizionali:

Per le attività di servizi locali che operano al di fuori degli Stati Uniti, MySMSGate offre un approccio molto più pratico. Puoi leggere di più sulle opzioni alternative nella nostra guida completa sul confronto delle alternative a Twilio o consultare la nostra guida alle API SMS più economiche per ottimizzare il tuo budget di comunicazione.

Domande frequenti

Ecco le risposte alle domande più comuni sulla consegna degli SMS e sul tracciamento dello stato di lettura.

È possibile vedere se un SMS è stato letto o aperto?

No, il protocollo SMS cellulare standard non supporta le ricevute di lettura native. Per verificare se un SMS è stato letto, è necessario includere un link di tracciamento breve e univoco nel corpo del messaggio e monitorare quando il destinatario tocca quel link.

Qual è la differenza tra lo stato consegnato e letto?

Lo stato consegnato indica che la rete dell'operatore ha trasferito con successo il messaggio di testo al dispositivo mobile del destinatario. Lo stato letto significa che l'utente ha attivamente aperto e visualizzato il messaggio. Gli SMS standard tracciano solo la consegna; per tracciare lo stato di lettura sono necessari link di tracciamento a livello di applicazione.

Come posso ottenere rapporti di consegna in tempo reale utilizzando MySMSGate?

MySMSGate inoltra i rapporti di consegna direttamente dalla rete dell'operatore del tuo telefono Android al tuo account. Puoi visualizzare questi stati di consegna in tempo reale sulla tua dashboard web o configurare un webhook di callback dello stato per ricevere richieste POST istantanee sul tuo server.

Ho bisogno dell'approvazione dell'operatore o della registrazione 10DLC per tracciare lo stato di consegna?

No. Quando utilizzi MySMSGate, invii messaggi tramite il tuo telefono Android e la tua scheda SIM. Poiché utilizzi la tua linea mobile personale o aziendale, non hai bisogno della registrazione 10DLC, della verifica del brand o dell'approvazione dell'operatore per inviare e tracciare i tuoi messaggi.