Validazione dei file di caricamento massivo SMS A2P: guida operativa

Quali problemi evita la validazione prima della creazione dei messaggi

Un caricamento massivo può contenere dati corretti, record incompleti ed errori che impediscono di interpretare una riga. Validare prima di creare i messaggi consente di rilevare questi problemi in una fase controllata e di indicare quali record richiedono una verifica, anziché scoprirli dopo l'avvio dell'elaborazione.

La validazione va intesa come un controllo dei dati e delle regole definite in precedenza. Non dimostra che esista il consenso a contattare i destinatari, che un mittente sia autorizzato in una destinazione o che un messaggio verrà consegnato. Queste verifiche appartengono a processi distinti e dipendono dal contesto, dalle regole applicabili e dalle capacità disponibili.

• Concorda la struttura accettata dal sistema e il significato di ogni campo.
• Separa gli errori di lettura dalle violazioni delle regole operative.
• Mantieni un riferimento univoco tra ogni record originale e il relativo risultato.

Definire il contratto dei dati

Prima di accettare i file, documenta un contratto dei dati: formati ammessi, codifica prevista, intestazioni riconosciute, campi obbligatori e gestione dei valori vuoti. Se sono ammesse varianti, specificale esplicitamente. Non basarti su supposizioni, come l'ordine delle colonne o l'interpretazione automatica di date e numeri.

Durante la lettura del file, verifica che sia possibile interpretarlo nel formato dichiarato e che siano presenti le colonne richieste. Distingui un file che non può essere analizzato da uno leggibile ma con righe incomplete. Il primo caso riguarda l'intero file; il secondo può solitamente essere segnalato per singolo record.

Le informazioni disponibili non indicano una convenzione unica per la codifica, le intestazioni o i campi obbligatori di tutti i caricamenti massivi A2P. Perciò queste regole devono essere definite per ogni integrazione e comunicate a chi prepara i file.

• Pubblica un modello e la definizione di ogni colonna, inclusi i formati e i valori consentiti.
• Specifica se sono ammesse colonne aggiuntive, campi vuoti o intestazioni alternative.
• Usa errori distinti per file illeggibile, intestazione mancante e dato obbligatorio vuoto.

Validazioni per record: numero, mittente e contenuto

Per ogni riga, verifica che il numero del destinatario sia presente e interpretabile secondo le regole concordate per l'integrazione. Se viene applicata una normalizzazione, definiscine e documentane il comportamento; non aggiungere prefissi, eliminare caratteri o modificare l'interpretazione sulla base di supposizioni. La raccomandazione E.164 è un riferimento per la numerazione internazionale, ma le informazioni disponibili qui non consentono di illustrarne le regole né di concludere che una stringa conforme sia instradabile.

Verifica che mittente e contenuto siano presenti quando richiesto dal caso d'uso e che possano essere rappresentati nel formato previsto. La sintassi valida di un mittente non dimostra che sia autorizzato per la destinazione. Allo stesso modo, la leggibilità del testo non conferma che siano rispettate le regole sul consenso, le politiche applicabili o le restrizioni di una rotta.

Tieni separate le verifiche dei dati dalle decisioni di invio. Una riga può essere sintatticamente valida e richiedere comunque un controllo di autorizzazione, conformità alle politiche o idoneità prima dell'elaborazione.

• Definisci i formati numerici ammessi e i casi da rifiutare o sottoporre a verifica.
• Valida il mittente secondo le regole configurate per il contesto, senza trattare la validazione sintattica come un'autorizzazione.
• Verifica che il contenuto sia interpretabile e che siano disponibili i campi di personalizzazione obbligatori.

Rilevare i duplicati senza alterare l'intento

Due righe simili non sono necessariamente duplicati: possono rappresentare invii legittimi alla stessa persona, per esempio in momenti diversi o per scopi differenti. Prima di segnalare duplicati, definisci quali combinazioni di campi e quale periodo, se pertinente, useresti per individuare le corrispondenze. Non eliminare né unire automaticamente i record senza una regola concordata con il responsabile del processo.

È utile distinguere tra duplicato esatto nel file, corrispondenza secondo una regola di business e ripetizione legittima. La decisione può consistere nel mostrare un avviso, bloccare il record o lasciarlo passare; deve essere esplicita, verificabile e coerente con la finalità dell'invio.

• Definisci la chiave di confronto e l'ambito del rilevamento prima di implementarlo.
• Conserva i record originali e indica quali righe corrispondono.
• Non presentare una corrispondenza come prova di errore o frode.

Classificare gli errori per fase

Una classificazione utile distingue almeno tre livelli. Gli errori di formato impediscono di leggere il file o interpretare un campo. Gli errori delle regole di business indicano che un valore non soddisfa una condizione concordata. Le restrizioni di invio comprendono decisioni successive sull'autorizzazione, sulle politiche o sulla possibilità di elaborare il traffico. Non riunire queste categorie in un unico stato generico di «non valido».

Un errore correggibile può essere risolto modificando il file o il dato e ripetendo la validazione. Un rifiuto definitivo, secondo le regole configurate, indica che il record non deve procedere in quel processo. Evita di definire definitivo un errore se significa soltanto che mancano informazioni o che serve una verifica. La classificazione deve riflettere la causa nota, non una conclusione che il controllo non può dimostrare.

• Usa stati distinti per file illeggibile, dato correggibile, regola non rispettata e verifica in sospeso.
• Spiega quale azione può intraprendere chi prepara il caricamento.
• Non trasformare un errore di validazione in un'affermazione sul consenso, sull'identità o sulla consegna.

Risultati utili e riferimento alla riga

Ogni risultato della validazione dovrebbe indicare quale record è stato valutato e la causa dell'avviso o del rifiuto. A questo scopo, conserva un riferimento stabile al record di origine, come il numero della riga nel file ricevuto e, se disponibile, un identificativo del caricamento. Il riferimento deve restare invariato anche se il sistema trasforma o normalizza i valori per elaborarli.

Descrivi il campo interessato, la regola applicata e una possibile azione. Evita messaggi ambigui come «errore numero» se puoi specificare che manca il destinatario o che il valore non rispetta il formato previsto. Le informazioni restituite devono bastare per correggere il problema, senza esporre dati personali non necessari.

• Includi identificativo del caricamento, riferimento alla riga, campo, esito e motivo comprensibile.
• Distingui gli avvisi dai rifiuti e spiega cosa fare dopo.
• Proteggi i dati personali nei report, nei log e nei canali di assistenza.

Caricamenti di grandi dimensioni, batch e nuovi invii

La dimensione massima del file, il numero di record per batch e la strategia di elaborazione dipendono dal sistema che riceve il caricamento. Non ci sono qui informazioni sufficienti per consigliare limiti numerici universali. Definisci i limiti in base alle capacità verificate dell'implementazione e pubblicali prima che i team preparino i file.

Se l'elaborazione avviene in batch, conserva l'identificativo del caricamento e la posizione di ogni riga in tutte le fasi. Progetta i nuovi invii in modo che un errore parziale non trasformi silenziosamente una ripetizione in nuovi messaggi. La semantica dei tentativi e della deduplicazione deve essere specificata dall'integrazione: non si può dedurre dal solo fatto che il file sia stato inviato di nuovo.

• Documenta i limiti e i comportamenti verificati nell'integrazione specifica.
• Registra quali parti sono state validate ed elaborate, senza nascondere gli esiti parziali.
• Definisci come riconoscere un caricamento ripetuto prima di consentire nuovi invii.

Tracciabilità e conservazione proporzionata

Mantieni un collegamento verificabile tra il file ricevuto, ogni riga, il risultato della validazione e ogni messaggio eventualmente creato. Questa tracciabilità aiuta a indagare sugli errori e a rispondere alle domande operative, ma deve limitarsi ai dati necessari per la finalità definita.

Stabilisci una politica di conservazione per i file e i risultati, specificando chi può accedervi, quali dati vengono conservati e quando vengono eliminati. Le informazioni disponibili non determinano un periodo adeguato né sostituiscono gli obblighi applicabili in ciascuna giurisdizione. Definisci questi limiti con i responsabili di privacy, sicurezza e conformità ed evita di conservare copie complete quando è sufficiente un riferimento minimo.

• Conserva gli identificativi del caricamento e delle righe necessari a ricostruire l'esito senza duplicare inutilmente i dati.
• Limita gli accessi ed evita di includere numeri o messaggi completi nei log se non sono necessari.
• Determina i periodi di conservazione in base alla finalità e agli obblighi applicabili.