Risoluzione dei problemi relativi agli SMS

Conflitto tra diversi account esterni

Se l’istanza dispone di più account esterni SMS, è necessario verificare che i problemi non siano causati da un conflitto tra account esterni.

Adobe Campaign tratta gli account esterni come entità non correlate.

Se disponi di più account, segui questa procedura per isolare l’account esterno che causa problemi:

1. Disattiva tutti gli account esterni.
2. Abilita un account esterno.
3. Prova a riprodurre il problema.
4. Se il problema iniziale non compare sempre, eseguire una quantità ragionevole di tentativi prima di concludere.
5. Se il problema non viene visualizzato con l'account singolo, disattivarlo e riavviare il sistema al passaggio 2 dell'account successivo.

Una volta verificato ogni singolo account, esistono due possibili scenari:

• Il problema è apparso su uno o più account

  In questo caso, puoi applicare altre procedure di risoluzione dei problemi su ogni singolo account. È consigliabile disabilitare altri account durante la diagnosi di un account per ridurre il traffico di rete e il numero di registri.

• Il problema non è stato visualizzato quando è attivo un solo account alla volta

  Si è verificato un conflitto tra gli account. Come accennato in precedenza, Adobe Campaign tratta gli account singolarmente, ma il provider può trattarli come un singolo account.

  • Stai utilizzando combinazioni di login/password diverse tra tutti i tuoi account.
    Contattare il provider per diagnosticare potenziali conflitti.

  • Alcuni degli account esterni condividono la stessa combinazione di login/password.
    Il provider non ha modo di distinguere da quale account BIND PDU esterno proviene, quindi trattano tutte le connessioni dagli account multipli come uno solo. Potrebbero aver instradato MO e SR in modo casuale sui due account, causando problemi.
    Se il provider supporta più codici brevi per la stessa combinazione di login/password, dovrai chiedere dove inserire il BIND PDU codice breve in. Tieni presente che questa informazione deve essere inserita all'interno del BIND PDU , e non in SUBMIT_SM , poiché l' BIND PDU è l'unico luogo che permetterà correttamente il routing MOs.
    Vedi le informazioni in ogni tipo di sezione PDU per sapere quale campo è disponibile in BIND PDU , di solito Aggiungi il codice breve in address_range , ma questo richiede un supporto speciale da parte del provider. Contattateli per sapere come si aspettano di instradare più codici brevi in modo indipendente.
    Adobe Campaign supporta la gestione di più codici brevi sullo stesso account esterno.

Problema con l’account esterno in generale

• Verifica se il connettore è stato modificato di recente e da chi (controlla Account esterni come gruppo).

  select saccount, (sserver ||':'||sport) as serverPort, iextaccountid, CASE WHEN N0.iactive=1 THEN 'Yes' ELSE 'No' END as "(x) Enabled",
  
  (select X1.sname from xtkoperator X1 where N0.icreatedbyid = X1.ioperatorid) as "Created By",
  
  (select X1.sname from xtkoperator X1 where N0.imodifiedbyid = X1.ioperatorid) as "Last Modified By",
  
  N0.slabel as "External Account", N0.tslastmodified as "LastModifiedDate"
  
  from nmsextaccount N0 LEFT JOIN xtkoperator X0 ON (N0.icreatedbyid=X0.ioperatorid) order by 8 DESC LIMIT 50;
  

• Indagare (nella directory/postupgrade) se il sistema è stato aggiornato e quando

• Verificare se i pacchetti che influiscono su SMS potrebbero essere stati aggiornati di recente (/var/log/dpkg.log?lang=it).

Problema durante la connessione al provider

• BIND PDUSe restituisce un codice diverso da zero command_status , rivolgetevi al provider per ulteriori informazioni.

• Verifica che la rete sia configurata correttamente in modo che la connessione TCP possa essere effettuata al provider.

• Chiedi al provider di verificare che gli IP siano stati aggiunti correttamente al inserisco nell'elenco Consentiti di dell’istanza di Adobe Campaign.

• Verifica Account esterno impostazioni. Chiedi al provider il valore dei campi.

• Se la connessione ha esito positivo ma è instabile, controllare Problema con connessioni instabili sezione.

• Se i problemi di connessione sono difficili da diagnosticare, un'acquisizione di rete può fornire informazioni. Verificare che l'acquisizione di rete venga eseguita contemporaneamente mentre il problema viene visualizzato per essere analizzato in modo efficiente. È inoltre necessario prendere nota dell'ora esatta in cui viene visualizzato il problema.

Problemi di connessione instabile

Una connessione è considerata instabile se si verifica una delle seguenti situazioni:

• Il riavvio dell’MTA correggerà temporaneamente gli elementi. Significa che una connessione instabile attiva la limitazione dell’MTA su Adobe Campaign Standard e il riavvio dell’MTA cancella la limitazione. Succederà di nuovo finché non viene trovata la causa principale.

• Il provider invia UNBIND PDUs.

• enquire_link va in timeout, sul lato Adobe Campaign o sul lato provider. Potresti vedere ENQUIRE_LINK_RESP con un codice di errore diverso da zero in questo caso.

• Ci sono molti BIND PDUs. Non dovrebbero essercene più di alcuni in un giorno, a seconda del numero di connessioni. Deve essere emesso un avviso da più di 1 PDU BIND all'ora.

Come risolvere i problemi di stabilità della connessione:

• Le connessioni instabili sono raramente la causa principale, spesso è il risultato di un altro problema che attiva una disconnessione. Trovare la causa principale è la priorità.

• Abilita tracce SMPP dettagliate. Saranno necessarie per vedere cosa accade al riavvio della connessione.

• Se il provider invia BIND PDUs, qualcosa potrebbe andare storto. Chiedi al tuo provider perché UNBING viene inviato.

• L'acquisizione di una rete a volte è l'unico modo per vedere come viene chiusa la connessione.

• Se il provider chiude le connessioni inviando una TCP FIN o un TCP RST pacchetto, chiedere al provider ulteriori informazioni.

• Se il provider chiude la connessione dopo l’invio di un errore pulito, ad esempio DELIVER_SM_RESP con un codice di errore, devono correggere il connettore in caso contrario, impedendo la trasmissione di altri tipi di messaggi e attivando la limitazione dell’MTA. Ciò è particolarmente importante nella modalità ricetrasmettitore, dove la chiusura della connessione influisce sia su MT che su SR.

Problema durante l’invio di un messaggio MT (SMS regolare inviato a un utente finale)

• Verificare che la connessione sia stabile. Una connessione SMPP deve rimanere attiva per almeno 1 ora di seguito. Consulta la sezione Problema con connessioni instabili.

• Se il riavvio dell’MTA fa sì che l’invio di messaggi MT torni a funzionare per un breve periodo di tempo, probabilmente si hanno limitazioni a causa di una connessione instabile. Consulta la sezione Problema con connessioni instabili.

• Verificare che l'ampio registro sia presente e che lo stato sia corretto con le date corrette. In caso contrario, potrebbe trattarsi di un problema di consegna o di preparazione della consegna.

• Verifica che l’MTA elabori effettivamente il messaggio. In caso contrario, potrebbe non trattarsi di un problema SMS.

• Verifica che il connettore SMS sia effettivamente associato all’apparecchiatura del provider. Chiedere al provider di fornire un feedback per verificare che tutti i sistemi comunichino correttamente. Consulta BIND_TRANSMITTER e BIND_TRANSCEIVER PDUs per informazioni sul processo di associazione. Per una corretta risoluzione dei problemi, potrebbe essere necessario abilitare le tracce SMPP.

• Con le tracce SMPP abilitate, verifica che SUBMIT_SM PDU contiene le informazioni corrette.

• Verifica che il provider risponda con un SUBMIT_SM_RESP PDU con un valore "OK" (codice 0). Assicurati che la PDU arrivi con un ritardo ragionevole: qualsiasi elemento di durata superiore a 1 secondo deve essere discusso con il provider, in genere arriva in meno di 100 ms.

• Se tutti questi passaggi funzionano, si può essere certi che il problema è sul lato del fornitore. Dovranno risolvere i problemi sulla loro piattaforma.

• Se funziona ma la velocità effettiva non è coerente, prova a regolare la finestra di invio e ad abbassare la velocità effettiva di MT. Per regolare l’impostazione, dovrai collaborare con il provider. Adobe Campaign è in grado di inviare messaggi molto rapidamente, in modo che l'apparecchiatura del provider possa presentare problemi di prestazioni.

MT sono duplicati (lo stesso SMS viene inviato più volte di fila)

I duplicati sono spesso causati da nuovi tentativi. È normale disporre di duplicati quando si ritenta il messaggio, è invece consigliabile provare a rimuovere la causa principale dei nuovi tentativi.

• Se vedi duplicati inviati a distanza di esattamente 60 secondi, è probabile che si tratti di un problema dal lato del fornitore, che non invia un SUBMIT_SM_RESP abbastanza velocemente.

• Se ne vedi molti BIND/UNBIND, la connessione è instabile. Consulta laProblema con connessioni instabili sezione per le soluzioni prima di tentare di risolvere i problemi relativi ai messaggi duplicati.

Riduzione della quantità di duplicati in caso di un nuovo tentativo:

• Abbassare la finestra di invio. La finestra di invio deve essere sufficientemente grande da coprire SUBMIT_SM_RESP latenza. Il valore rappresenta il numero massimo di messaggi che è possibile duplicare se si verifica un errore mentre la finestra è piena.

Problema durante l’elaborazione di SR (conferme di consegna)

• Per eseguire qualsiasi tipo di risoluzione dei problemi SR, è necessario abilitare le tracce SMPP.

• Verifica che la DELIVER_SM PDU proviene dal provider e ha un formato corretto.

• Controlla che Adobe Campaign risposte con successo DELIVER_SM_RESP PDU in modo tempestivo. In Adobe Campaign Standard, questo garantisce che l'intera logica di elaborazione sia stata applicata, se questo non è il caso, è garantito un messaggio di errore nei log che raccontano perché l'elaborazione non è riuscita.

Se il DELIVER_SM PDU riconoscimento non viene riconosciuto correttamente, verifica quanto segue:

• Controlla la regex relativa all’estrazione degli ID e all’elaborazione degli errori nel Account esterno. Potrebbe essere necessario convalidarli in base al contenuto della DELIVER_SM PDU.

• Verifica che il provisioning degli errori sia stato eseguito correttamente in broadLogMsg tabella.

• Per Adobe Campaign Standard, verifica che broadLog e broadLogExec le tabelle sono sincronizzate correttamente.

Se hai risolto tutto, ma alcuni non valido SR sono ancora nel buffer del provider, puoi ignorarli utilizzando l' opzione di conferma ID non valida. Questo deve essere usato con cautela e resettato a 0 il più rapidamente possibile dopo che i buffer sono puliti.

Problema durante l'elaborazione di MO (e DenyList/auto reply)

• Abilitare le tracce SMPP durante i test. Se non abiliti TLS, devi effettuare un'acquisizione di rete durante la risoluzione dei problemi di MO per verificare che le PDU contengano le informazioni corrette e siano formattate correttamente.

• Durante l'acquisizione di traffico di rete o l'analisi delle tracce SMPP, assicuratevi di catturare l'intera conversazione con il MO e la sua risposta MT se è configurata una risposta.

• Se il simbolo MO (DELIVER_SM PDU) non viene visualizzato nelle tracce, il problema si trova sul lato del fornitore. Dovranno risolvere i problemi sulla loro piattaforma.

• Se il DELIVER_SM PDU viene visualizzato, verifica che sia confermato da Adobe Campaign con un DELIVER_SM_RESP PDU (codice 0) Questo RESP garantisce che tutta la logica di elaborazione sia stata applicata da Adobe Campaign (risposta automatica e inserisce nell'elenco Bloccati consenti/). In caso contrario, cerca un messaggio di errore nei registri MTA.

• Se sono abilitate le risposte automatiche, verificare che SUBMIT_SM è stato inviato al provider. In caso contrario, troverà sicuramente un messaggio di errore nei registri MTA.

• Se il SUBMIT_SM MT PDU contenente la risposta si trova nelle tracce ma l'SMS non arriva al telefono cellulare, dovrai contattare il provider per assistenza sulla risoluzione dei problemi.

Problema durante la preparazione della consegna che non esclude i destinatari in quarantena (messi in quarantena dalla funzione di risposta automatica)

• Verifica che il formato del numero di telefono sia esattamente lo stesso nella tabella di quarantena e nel registro di consegna. In caso contrario, fai riferimento a questo sezione in caso di problemi con il prefisso più del formato del numero di telefono internazionale.

• Controlla i codici brevi. Le esclusioni possono verificarsi se il codice breve del destinatario è uguale a quello definito nell’account esterno o se è vuoto (vuoto = qualsiasi codice breve). Se viene utilizzato un solo codice breve per l’intera istanza di Adobe Campaign, è più semplice lasciare tutto codice breve campi vuoti.

Problemi di codifica

Passaggio 1: Contatta il provider

Contattali e vedi cosa c'è di sbagliato con loro. Dovrebbero essere in grado di dirti se il problema è dalla loro parte o da quella di Adobe Campaign. Se il problema è in Adobe Campaign, dovrebbe essere in grado di dirti esattamente quale campo non è corretto.

Passaggio 2: conoscere il contenuto del messaggio

Unicode consente molte varianti per caratteri simili e Adobe Campaign non è in grado di gestirli tutti.

La causa più comune di problemi è il copia-incolla da un elaboratore di testi, che cambia i caratteri usuali in versioni tipograficamente corrette: spazi modificati in spazi unificatori, virgolette doppie modificate in virgolette di apertura e chiusura, segni meno modificati in vari tipi di trattini, ecc.

Non copiare e incollare il messaggio durante il test, digitalo sempre direttamente nell’interfaccia.

Con esadecimale, puoi distinguere la differenza tra caratteri simili. Una L minuscola, una I maiuscola, O, 0, tutti i diversi tipi di virgolette, codifiche non latine o anche diversi tipi di spazi possono tutti avere lo stesso aspetto o anche non essere visualizzati affatto.

Per convertire Unicode in esadecimale, puoi utilizzare strumenti online quali Convertitore di codice Unicode sito Web. Digita il testo, assicurati che non siano presenti dati PII come i numeri di telefono e fai clic su Converti. I valori esadecimali sono visualizzati nella parte inferiore (zona UTF-32).

Quando apri ticket sui problemi di codifica, sia con il provider che con il supporto Adobe Campaign, includi sempre una versione esadecimale di ciò che digiti e ciò che visualizzi.

Passaggio 3: sapere cosa inviare

Determina la codifica che prevedi di utilizzare e cerca online la tabella dei caratteri corrispondente. Verifica che i caratteri che intendi inviare siano effettivamente disponibili nella tabella codici di destinazione. Verifica che la data_coding è corretto e corrisponde a quello che tu e il fornitore vi aspettate.

Passaggio 4: sapere cosa è stato inviato

Per visualizzare esattamente i byte inviati al provider, è necessario l'output di debug del connettore. I problemi di codifica vengono visualizzati in SUBMIT_SM PDUs, assicurati di catturarli. Invia messaggi molto distinti e facili da trovare nel registro.

Invia diversi tipi di caratteri speciali durante il test. Ad esempio, la codifica GSM7 dispone di caratteri estesi molto distinti nella loro forma esadecimale, che sono facili da individuare poiché non compaiono in nessun’altra codifica.

Elementi da includere durante la comunicazione relativa a un problema SMS

Ogni volta che chiedi assistenza su un problema relativo agli SMS, che si tratti dell’apertura di un ticket di supporto ad Adobe Campaign, al provider SMS o a qualsiasi tipo di comunicazione su tale problema, dovrai includere le seguenti informazioni per assicurarti che sia qualificato correttamente. I problemi correttamente qualificati sono fondamentali per risolverli più rapidamente.

• Abilita messaggi SMPP dettagliati quando viene visualizzato il problema. La maggior parte dei problemi relativi agli SMS è impossibile da risolvere senza questo.

• Se il problema è relativo al traffico SMS, contatta prima il provider. La loro piattaforma è ideale per una diagnosi efficiente dei problemi di traffico SMS in tempo reale.

• Includere una breve descrizione del problema.

• Includi una descrizione del risultato previsto.

• Includi il feedback del provider.

• Includere registri e/o acquisizioni di rete pertinenti. Quando si eseguono le acquisizioni, assicurarsi di riprodurre il problema durante la cattura.

• Se si includono registri, tracce o acquisizioni, individuare la posizione esatta nel file quando viene visualizzato il problema.

• Se fai riferimento a messaggi, PDU o registri, indica chiaramente la marca temporale per semplificarne la ricerca.

• Prova a riprodurre il problema in un ambiente di test. Se non sei sicuro di un’impostazione, prova nell’ambiente di test e verifica il risultato con le tracce SMPP. In genere è meglio segnalare i problemi replicati negli ambienti di test piuttosto che segnalare direttamente i problemi negli ambienti di produzione.

• Includi eventuali modifiche apportate alla piattaforma. Inoltre, includi eventuali modifiche apportate dal provider al proprio lato.

Acquisizione di rete

L’acquisizione di rete non è sempre necessaria, in genere è sufficiente disporre di messaggi SMPP dettagliati. Di seguito sono riportate alcune linee guida utili per determinare se è necessario acquisire una rete:

• Problemi di connessione, ma i messaggi dettagliati non mostrano alcun BIND_RESP PDU.

• Disconnessioni non spiegate senza messaggio di errore, il solito comportamento del connettore quando rileva un errore di protocollo di basso livello.

• Il provider si lamenta del processo di annullamento binding/disconnessione.

• Problemi di codifica nei campi TLV opzionali.

• Si sospetta che il traffico sia misto tra connessioni diverse.

In tutte le altre situazioni, prova ad analizzare prima i messaggi SMPP dettagliati e a richiedere un’acquisizione di rete solo se è chiaro che mancano informazioni nei registri dettagliati.

In alcuni casi, non è necessario acquisire il traffico di rete. Di seguito sono riportate le situazioni più comuni:

• TLS abilitato: per definizione, TLS traffico è crittografato in modo che non possa essere catturato.

• Problemi di prestazioni: i registri contengono tutte le informazioni necessarie per tracciare i problemi di prestazioni.

• Problemi di tempistica (retry timing, enquire_link periodo, limitazione della velocità effettiva, ecc.)

• Analisi ed elaborazione SR: i registri dettagliati forniscono molto più contesto e una presentazione migliore.

• Elaborazione MO (risposte automatiche, quarantena).

• Errori che non coinvolgono il traffico SMPP effettivo: preparazione della consegna, problemi API del Centro messaggi, problemi del flusso di lavoro, ecc.

Abilitazione delle tracce SMPP

Il nuovo connettore supporta la registrazione estesa tramite tracce: SMPP. Le tracce vengono generate nel registro MTA, non nell’output standard.

Abilitazione per account esterno (metodo preferito)

1. In Account esterno, seleziona Abilita tracce SMPP dettagliate nel file di registro.
2. Salva, il connettore si riconnetterà con le tracce abilitate.

Attivazione immediata

L’MTA di Adobe Campaign Standard dispone di un’interfaccia di controllo HTTP che consente di modificare istantaneamente il filtro di traccia.
Una chiamata POST può abilitare/disabilitare le tracce. Esempio di URL per abilitare le tracce SMPP:

POST http://host:7780/mta/trace?filter=SMPP

Per disattivare le tracce, impostare un filtro vuoto:

POST http://host:7780/mta/trace?filter=

Abilitazione nella configurazione

In config-instance.xml file, impostare i seguenti parametri:

<mta args="-tracefilter:SMPP"/>

Verifica del numero di connessioni aperte in un contenitore

Per verificare il numero di connessioni aperte in un contenitore, è possibile utilizzare questo comando:

(for pid in $(ss -neopts  | sed -n ‘s/^.*:3600[ \t].*users:(([0-9A-Za-z”]*,pid=\([0-9]*\),.*$/\1/p’ | sort ); do  cat /proc/$pid/cmdline; echo  ” $pid” ;done;) | uniq --count

Elenca il numero di connessioni aperte per una determinata porta. In questo caso viene utilizzata la porta 3600.

Il risultato dovrebbe essere il seguente:

4 nlserversms -noconsole -tracefile:sms@INSTANCE_NAME -instance:INSTANCE_NAME -detach 15180
2 nlservermtachild -tracefile:mtachild@INSTANCE_NAME -instance:INSTANCE_NAME -detach 1838
2 nlservermtachild -tracefile:mtachild@INSTANCE_NAME -instance:INSTANCE_NAME -detach 24025
2 nlservermtachild -tracefile:mtachild@INSTANCE_NAME -instance:INSTANCE_NAME -detach 24029
2 nlservermtachild -tracefile:mtachild@INSTANCE_NAME -instance:INSTANCE_NAME -detach 29088
2 nlservermtachild -tracefile:mtachild@INSTANCE_NAME -instance:INSTANCE_NAME -detach 30390

4 connessioni aperte per il processo sms e 2 per elemento secondario mta con 5 elementi secondari.