Capire l'audit log

Audit è l'ultima voce della barra laterale ed è la risposta alla domanda "chi ha cambiato questa cosa, e quando?". È un registro in sola aggiunta: le righe le scrive il sistema mentre lavori e nulla nell'interfaccia può modificarle o cancellarle. È limitato alla tua agenzia, quindi vedi le azioni del tuo team e di nessun altro.

L'intestazione conta l'intera storia — "N azioni registrate · orari in Europe/Rome." — e la tabella sotto mostra 50 righe per pagina, dalla più recente.

Le quattro colonne

• Quando — data e ora dell'azione, sempre in Europe/Rome, al secondo.
• Utente — l'email di chi l'ha fatta. Le voci automatiche sono registrate con system, e una riga senza utente noto mostra —.
• Azione — un nome breve leggibile dalla macchina, in un badge, nella forma famiglia.oggetto.verbo: agent.prompt.save, client.update, team.member.role. Il nome è stabile, il che rende facile scorrere (o cercare con il "trova" del browser) un singolo tipo di modifica.
• Risorsa — che cosa è stato toccato, nella forma tipo/id (per esempio agent/…, client/…). Le azioni senza un oggetto unico mostrano —.

Chi può vederlo

Audit è una delle otto aree di permesso. Titolare e admin lo vedono sempre. Un collaboratore vede la pagina solo se un admin gli ha dato almeno Viewer su Audit; altrimenti la pagina mostra il pannello "Quest'area non è abilitata per te" e la voce non compare nella sua barra laterale.

Qui non c'è un vero comportamento da editor: nessuno scrive nel registro a mano — ogni riga la scrive il sistema. Vedi Invita il tuo team per come si assegnano le aree.

Che cosa viene registrato

Modifiche di configurazione, connessioni e gestione del team: le azioni che cambiano il comportamento della piattaforma.

• client.* — client.create, client.update e client.sync quando i sub-account vengono importati da GoHighLevel.
• agent.* — agent.create, agent.prompt.save, agent.prompt.rollback, agent.settings.save, agent.identity.save, agent.call_policy.save, agent.numbers.save, agent.fieldmappings.save, agent.integrations.sync.
• connection.* — connection.retell.connect, connection.twilio.connect, connection.ghl.connect. La riga prova che un provider è stato connesso; la credenziale non ne fa mai parte.
• number.retell.register — un numero di telefono registrato su Retell perché l'AI possa usarlo.
• setting.update e setting.delete — modifiche nella pagina Impostazioni (concorrenza, fascia oraria, registrazione, modalità rigorosa, nomi dei tag CRM).
• lead.block e lead.unblock — un lead messo, o tolto, dalla tua lista do-not-call; vedi Do-Not-Call: bloccare e sbloccare i lead.
• team.* — team.invite.create, team.invite.resend, team.invite.revoke, team.invite.accept, team.member.role, team.member.permissions, team.member.remove.
• alert.fired — scritta con utente system la prima volta che un allarme operativo scatta nella sua finestra. È la traccia durevole dietro il banner "Attenzione richiesta" della dashboard: Leggere la dashboard.

Ogni riga porta anche un piccolo payload selezionato — qualche campo rilevante, mai l'intero modulo e mai un segreto. Token di invito, chiavi API e password non sono conservati qui.

Che cosa NON viene registrato

• Le letture. Aprire una pagina, filtrare una lista o ascoltare una registrazione non lascia nessuna riga. Il registro segna i cambiamenti, non la navigazione.
• L'attività di chiamata. Chiamate, esiti, trascrizioni e registrazioni stanno in Chiamate e Lead: quella è la storia operativa, e duplicarla qui seppellirebbe le modifiche di configurazione.
• L'acquisto di un numero. Viene registrata solo la sua registrazione su Retell (number.retell.register); l'acquisto in sé si vede nella pagina Numeri.
• Le chiamate di prova fatte con il tester dell'agente nel browser.

Un'ultima sfumatura: la scrittura dell'audit è a prova di errore per costruzione. Se la scrittura del registro fallisce, l'azione che stava registrando va comunque a buon fine: questo compromesso evita che un intoppo di logging blocchi il tuo lavoro, al prezzo di una riga mancante in casi rarissimi.

Sfogliare la storia

Il paginatore in fondo percorre tutto il registro, non solo una fetta recente: il contatore nell'intestazione dice quante azioni esistono in totale e l'indicatore di intervallo mostra quali stai guardando. Poiché le righe sono ordinate dalla più recente, "che cosa è cambiato adesso" è sempre a pagina 1, e indagare su una modifica più vecchia significa tornare indietro fino al giorno che ti interessa.