Torna al blog Connettività

Integrità della codifica negli SMS A2P: guida ai test e alla diagnosi

Come organizzare verifiche controllate del testo negli SMS A2P, confrontare le evidenze disponibili e comunicare chiaramente ciò che non è possibile verificare.

Schema di un flusso SMS A2P con punti di controllo per confrontare il testo e i registri disponibili

Cosa significa preservare la codifica

In questa guida, l’integrità del testo indica il confronto tra il contenuto previsto e le copie e i registri disponibili durante l’invio. Non implica che tutti i segmenti del percorso siano visibili, né che il testo mostrato in un registro sia necessariamente una copia esatta di quello ricevuto dal terminale.

È utile distinguere tre domande: quale testo ha generato l’applicazione? Quale contenuto è stato inviato all’interfaccia? Quali evidenze sono disponibili sul suo trattamento o sul suo stato? Una differenza tra due osservazioni aiuta a circoscrivere cosa indagare, ma da sola non dimostra quale componente l’abbia causata.

  • Registra separatamente il testo iniziale e ogni osservazione disponibile.
  • Distingui una discrepanza osservabile da una causa confermata.
  • Considera il confronto del contenuto e lo stato riportato come verifiche distinte.
Cosa significa preservare la codifica

Punti di osservazione: dall’applicazione al destinatario

Prima di effettuare le verifiche, disegna il percorso effettivo della tua integrazione. Includi l’applicazione e i relativi modelli, l’interfaccia che utilizzi, i componenti sotto il tuo controllo e i punti di osservazione che il provider potrebbe rendere disponibili. Aggiungi il destinatario come tappa del percorso, senza presumere di poter accedere al contenuto interno di altri sistemi.

Conserva una copia del testo prima dell’invio e registra le informazioni restituite da ciascun componente. Le implementazioni e i campi disponibili possono variare: non dare per scontato che un registro semplificato descriva tutte le trasformazioni o permetta di ricostruire l’intero percorso.

  • Annota la versione dell’applicazione, i componenti e la configurazione utilizzati in ogni verifica.
  • Conserva l’identificativo restituito dall’interfaccia e, quando disponibili, collegalo ai registri successivi.
  • Chiedi al provider cosa rappresenta ciascun registro e quali sono i suoi limiti.
Punti di osservazione: dall’applicazione al destinatario

Caratteri e rappresentazioni: cosa registrare

Il testo può essere rappresentato o trattato in modo diverso dai componenti di un’integrazione. Le evidenze disponibili in questa sede non consentono di specificare quale rappresentazione utilizzi un determinato percorso né quale trattamento applichi ciascun componente. Perciò, non dedurre questi dettagli soltanto dall’aspetto del testo in una console.

Prepara un elenco di caratteri basato sul contenuto che devi effettivamente inviare. Registra il testo esatto prima dell’invio e ogni dato sul suo trattamento che l’interfaccia rende disponibile e documenta. Non presumere che due sistemi calcolino la lunghezza o descrivano il contenuto nello stesso modo.

  • Salva una copia del testo previsto prima dell’invio.
  • Annota ogni modifica apportata dall’applicazione prima della chiamata all’interfaccia.
  • Registra dati aggiuntivi solo quando sono disponibili e documentati per quella specifica integrazione.
  • Non interpretare un contatore mostrato da un sistema come prova di come il testo sia stato rappresentato in un altro.

Progetta verifiche autorizzate e controllate

Utilizza solo destinatari e mittenti di prova per i quali disponi dell’autorizzazione. Mantieni costanti configurazione e testo durante il confronto dei risultati. Modifica una sola variabile alla volta per circoscrivere più facilmente le discrepanze.

Prepara casi piccoli e riproducibili con caratteri presenti nel contenuto che userai realmente. Ripeti una verifica se il risultato varia e annota ora, destinatario di prova, mittente, identificativo e configurazione. Le informazioni disponibili non permettono di stabilire criteri tecnici specifici per una determinata rappresentazione o lunghezza.

  • Verifica in anticipo di essere autorizzato a usare il destinatario e il mittente di prova.
  • Invia ogni caso separatamente e usa un’etichetta di prova che non contenga dati personali.
  • Confronta le configurazioni solo dopo aver ottenuto un riferimento stabile.
  • Non usare le verifiche per contattare destinatari senza autorizzazione o aggirare i controlli.

Confronta le evidenze senza raccogliere dati non necessari

Confronta il testo previsto con ogni copia disponibile nei tuoi sistemi e nei registri del provider. Se il provider non espone il contenuto elaborato, annota questa limitazione e richiedi le informazioni minime necessarie per circoscrivere il problema. Non dedurre il contenuto da una conferma o da uno stato riportato.

Per ridurre l’esposizione, usa messaggi sintetici e destinatari di prova autorizzati. Limita l’accesso ai registri ed evita di salvare il corpo completo quando basta un riferimento al caso o un confronto controllato. Se devi conservare del testo per riprodurre una discrepanza, definisci accesso e periodo di conservazione secondo le tue politiche e gli obblighi applicabili.

  • Mantieni una tabella con fase, valore osservato, fonte, ora e limitazioni.
  • Distingui i dati del tuo sistema da quelli comunicati dal provider.
  • Non includere nelle verifiche codici monouso reali, informazioni sensibili o dati personali.
  • Conserva evidenze sufficienti per riprodurre il caso, non una copia indiscriminata del traffico.

Interpreta le discrepanze senza attribuire subito una causa

Un carattere che appare diverso, manca o viene sostituito è un indizio da approfondire, non un’attribuzione automatica. Controlla prima il testo generato dall’applicazione, poi confronta le osservazioni successive disponibili. Se conosci solo il testo iniziale e uno stato finale, potrebbe non essere possibile determinare quale fase sia responsabile.

Se la discrepanza coincide con altre modifiche osservate, registrale senza presumere un nesso causale. Le differenze tra i dati di due sistemi non dimostrano da sole cosa sia accaduto nei segmenti intermedi o cosa sia stato mostrato sul terminale.

  • Riproduci il caso con un messaggio minimo che contenga il testo problematico.
  • Confronta una versione di controllo e documenta le osservazioni per entrambe.
  • Verifica se l’applicazione ha modificato il testo prima di attribuire il problema a un’altra fase.
  • Indica come non confermata ogni fase per la quale non esistono evidenze dirette.

Cosa dimostrano — e cosa non dimostrano — conferme, registri e DLR

Una conferma o un DLR va interpretato secondo la definizione della fonte che lo emette. Le evidenze disponibili non consentono di attribuire un significato specifico a uno stato restituito da un’interfaccia o da un provider. Non presentare automaticamente uno stato riportato come prova che l’utente abbia letto il messaggio o che il testo sia arrivato integro sullo schermo del terminale.

Prima di usare uno stato come criterio operativo, chiedi la definizione del codice e le limitazioni note. Se non esiste una verifica indipendente sul terminale, descrivi il risultato come stato riportato, non come ricezione verificata sul dispositivo.

  • Documenta il significato degli stati secondo la fonte che li emette.
  • Distingui la conferma di una richiesta, uno stato riportato e una verifica indipendente sul terminale.
  • Non usare un DLR come prova di lettura o come conferma dell’integrità del testo.

Procedura diagnostica e criteri di accettazione

Quando rilevi una differenza, conserva il caso minimo riproducibile e annota la configurazione. Controlla prima il testo generato dall’applicazione; poi confronta ciò che è stato inviato all’interfaccia con la risposta ricevuta; infine, chiedi al provider i registri disponibili per l’identificativo corrispondente. Quando segnali il problema, includi ora, destinatario autorizzato, mittente, testo di prova e osservazioni esatte. Chiedi di chiarire quale fase rappresenta ciascun registro.

Definisci criteri basati esclusivamente su ciò che puoi osservare e confrontare. Per esempio, puoi richiedere che il testo coincida nei punti accessibili e che le discrepanze siano riproducibili o circoscrivibili. Se non puoi verificare il contenuto in una fase, dichiara questo limite e concorda come gestire gli incidenti, senza trasformare un’ipotesi in un criterio di accettazione.

  • Stabilisci un riferimento con messaggi sintetici e mittenti e destinatari autorizzati.
  • Valuta il percorso rispetto a requisiti verificabili, non a supposizioni sulle fasi invisibili.
  • Chiedi al provider le definizioni di registri e stati, oltre a ogni informazione documentata che possa influire sulla tua integrazione.
  • Ripeti le verifiche dopo modifiche che potrebbero alterare il testo o i registri disponibili.
FAQ

Domande frequenti

Un DLR conferma che il testo è stato ricevuto integro sul cellulare?

Non è possibile concluderlo basandosi solo su un DLR. Interpretalo secondo la definizione della fonte che lo emette: da solo non dimostra quale testo sia stato mostrato sul terminale né che l’utente lo abbia letto.

Come posso sapere come è stato trattato il testo nella mia integrazione?

Confronta il testo previsto con le osservazioni disponibili in ogni fase e consulta la documentazione del provider. Il solo aspetto del testo in una console non basta a confermare il trattamento interno.

Quali casi è opportuno includere nelle verifiche?

Inizia dal contenuto effettivo che devi inviare e prova piccole variazioni riproducibili. Usa solo destinatari e mittenti autorizzati.

Una differenza tra il testo originale e un registro dimostra che il provider lo ha modificato?

No. Dimostra una discrepanza tra due osservazioni. Per circoscriverla, confronta le evidenze successive e verifica cosa rappresenta ciascun registro e quali informazioni non sono disponibili.

Cosa devo inviare al provider quando segnalo un problema?

Un caso minimo riproducibile con ora, identificativo, configurazione, destinatario autorizzato, mittente e confronto esatto tra il testo previsto e le osservazioni disponibili. Evita di includere dati personali o messaggi reali sensibili.

Fonti consultate

  1. 3GPP specifications3GPP
  2. ITU-T E.164International Telecommunication Union
  3. GSMA resourcesGSMA
  4. SMPP specificationSMPP Developers Forum
  5. HTTP semanticsIETF