Panoramica

Twilio offre strumenti per analizzare l'attività di messaggistica tra Twilio e la tua applicazione. Se un messaggio non viene consegnato, è in ritardo o si comporta in modo imprevisto, la prima cosa da fare è consultare i Messaging Logs in Twilio. Questi log ti permettono di verificare lo stato di consegna, identificare errori e raccogliere dettagli per ulteriori attività di troubleshooting.

Schermata 1 — Come verificare i log di un SMS specifico se sei connesso al tuo account Twilio

Come navigare nei Messaging Logs e come usarli?

Guida passo-passo

1. Accedi a Twilio

2. Accedi ai Subaccount

  • Clicca su Account (al centro dello schermo) → Subaccounts.

Se ci sono troppi subaccount, torna su HITLEAD (HL) e copia l'Account SID della location.

In Twilio, cerca il Subaccount SID corrispondente e aprilo.

Cerca il Twilio Subaccount SID nelle Impostazioni a livello agenzia → Twilio

Incolla l'Account SID qui e cliccaci sopra:

3. Naviga ai Messaging Logs

  • Nel pannello di sinistra: Monitor > Logs > Messaging.

4. Cerca i messaggi

  • Usa il numero di telefono del contatto (senza formattazione) nei campi di ricerca:
    • Campo FROM → SMS in entrata (il contatto ha inviato un messaggio a Twilio).
    • Campo TO → SMS in uscita (Twilio ha inviato un messaggio al contatto).

Inserisci il numero di telefono del lead (rimuovi tutta la formattazione) nel campo TO:

5. Analizza le voci del log

  • Ogni riga del log mostra:
    • Message SID (identificatore univoco).
    • Numeri TO e FROM.
    • Status (accepted, delivered, failed, ecc.).
    • Segments (numero di parti se l'SMS è stato suddiviso).
    • Media (se è allegato un MMS).
  • Il log evidenzia i problemi:
    • Righe gialle o rosse indicano messaggi falliti o con anomalie.
    • Verde (status 200) indica successo.

Se risulta "delivered" ma il contatto non lo riceve, copia il Message SID e apri un ticket di supporto con Twilio.

6. Visualizza i dettagli del messaggio

  • Clicca sulla data con collegamento ipertestuale per vedere i dettagli completi, tra cui:
    • Delivery Steps: creazione della richiesta, tempo in coda, handoff al carrier.
    • Request Inspector: richieste/risposte tra Twilio e la tua applicazione.
    • Errors: status con codice colore (es. 404 se un endpoint webhook è mancante).
  • Passando il cursore sulle voci si visualizza l'anteprima del contenuto del messaggio.

Nella visualizzazione dettagliata del log messaggi trovi il Message SID (identificatore univoco di Twilio per questo messaggio), l'ora di creazione della risorsa, i numeri TO e FROM, i Delivery Steps e il Request Inspector.

La sezione Delivery Steps del log mostra quando è stata creata la richiesta, quanto tempo è rimasta in coda sulla piattaforma Twilio e quando è stata inviata al carrier partner per la consegna. Questi dati ti aiutano a determinare dove un messaggio non consegnato ha fallito, o a investigare problemi di latenza.

Il Request Inspector mostra tutte le richieste e risposte effettuate durante l'invio o la ricezione del messaggio. Puoi identificare facilmente gli errori sulle richieste grazie allo status con codice colore sulla destra.

Nella risposta qui sopra si vede che abbiamo ricevuto un errore 404 perché Twilio non è riuscito a trovare il tunnel per il webhook configurato per i messaggi.

Verifica della compatibilità MMS del numero Twilio

1. Vai su Explore Products → Scorri verso il basso → Phone Numbers.

2. Verifica se il numero ha le capacità MMS, o se può inviare/ricevere SMS solo verso numeri nazionali.