--- title: "Riferimento delle impostazioni dell'organizzazione" description: "Gestisci un'organizzazione ThunderPhone: profilo, lingua della dashboard, membri, conferma delle chiamate in uscita, chiamanti bloccati, webhook, SSO, chiavi API, avvisi, fatturazione, limiti di spesa e cronologia." --- Apri **Impostazioni dell'organizzazione** (`/dashboard/organization`) per gestire l'organizzazione attiva e il tuo account. Le impostazioni sono suddivise in sei schede; il tuo ruolo determina quali controlli puoi modificare. ## Il mio account La scheda **Il mio account** contiene le impostazioni dell'utente che ha effettuato l'accesso, non dell'intera organizzazione: - Nome, cognome, email e URL dell'avatar. - Lingua di visualizzazione della dashboard. - Download dell'app desktop per macOS. - Aggiunta, verifica, elenco e rimozione delle passkey. - Preferenze sui cookie. - Disconnessione dal dispositivo corrente. Quando accedi tramite l'SSO dell'organizzazione, il provider di identità gestisce la tua email, che qui è di sola lettura. Consulta [Account e sicurezza](/it/guides/account-and-security) per il flusso dettagliato relativo a passkey e profilo. ## Generali ### Conformità delle chiamate in uscita Per le organizzazioni a cui si applica il requisito, un proprietario o un amministratore deve esaminare e registrare la conferma una tantum per le chiamate in uscita prima che gli agenti possano effettuare chiamate in uscita. I membri possono vedere che è richiesta un'azione, ma non possono inviarla. Consulta [Norme sulle chiamate in uscita](/it/guides/outbound-calling-laws). ### Reportistica Fuso orario, orari lavorativi settimanali e numeri di test dell'organizzazione. Gli orari lavorativi determinano quali chiamate contano come fuori orario nei numeri dei report sulle chiamate nella Home, nella scheda **Chiamate** di ciascun agente e nei Portali clienti, nonché nel filtro **Orari lavorativi** della Cronologia chiamate. Se non selezioni alcun giorno, le chiamate fuori orario non vengono monitorate e ogni chiamata conta come effettuata durante l'orario lavorativo. Le chiamate da o verso un numero di test sono escluse da tutti i conteggi dei report, dagli elenchi dei portali, dai numeri della Panoramica e dalle esportazioni CSV; non possono essere aperte in un portale. Un agente può avere il proprio fuso orario e i propri orari in **Reportistica** nel builder dell'agente, che si applicano solo alle chiamate di quell'agente. I proprietari e gli amministratori modificano queste impostazioni in **Generale → Reportistica**. Scegli il fuso orario e seleziona ogni giorno di apertura, quindi inserisci gli orari di apertura e chiusura. In **Numeri di test**, inserisci ciascun numero e seleziona **Aggiungi**. Quindi seleziona **Salva impostazioni di reportistica**. Finché non viene salvato un fuso orario, i report usano UTC; la pagina propone il fuso orario del browser come modifica non salvata. Una volta impostati gli orari lavorativi, i giorni non selezionati contano come fuori orario per le chiamate che usano tale pianificazione. #### Configurare la reportistica tramite l'API I proprietari e gli amministratori possono usare `PATCH /v1/orgs/{id}/` con `timezone`, `business_hours` e `excluded_numbers`: - `timezone`: un nome di fuso orario IANA come `America/Los_Angeles`, fino a 64 caratteri. - `business_hours`: chiavi dei giorni della settimana da `mon` a `sun`, ciascuna con un elenco di al massimo quattro intervalli `{start, end}` nel formato a 24 ore `HH:MM`, con ogni fine successiva al relativo inizio. `{}` indica che non è prevista alcuna suddivisione fuori orario. - `excluded_numbers`: fino a 50 numeri di telefono, memorizzati in formato E.164. A un numero nordamericano di 10 cifre senza prefisso viene aggiunto il prefisso nazionale `+1`. ```bash curl -X PATCH https://api.thunderphone.com/v1/orgs/42/ \ -H "Authorization: Bearer sk_live_YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "timezone": "America/Los_Angeles", "business_hours": { "mon": [{"start": "09:00", "end": "17:00"}], "sat": [{"start": "10:00", "end": "14:00"}] }, "excluded_numbers": ["+14155550199"] }' ``` ### Chiamanti bloccati I numeri in questo elenco non possono contattare i tuoi agenti. Quando un numero bloccato chiama uno qualsiasi dei numeri di telefono della tua organizzazione, ThunderPhone riaggancia prima che un agente risponda e non addebita la chiamata. La chiamata appare comunque nella Cronologia chiamate, come chiamata in entrata non riuscita con motivo di fine **Chiamante bloccato**. Le chiamate con ID chiamante nascosto o anonimo non vengono mai associate e le chiamate in uscita verso un numero bloccato non sono interessate. Un chiamante che blocchi durante una chiamata non viene interrotto; il blocco si applica dalla chiamata successiva. Ogni membro può vedere l'elenco; i proprietari e gli amministratori lo modificano in **Generale → Chiamanti bloccati**: - Per bloccare un numero, inseriscilo con una nota facoltativa e seleziona **Blocca numero**. Usa `+` e il prefisso nazionale; funziona anche un formato nazionale come `(415) 555-0123` quando tutti i numeri di telefono della tua organizzazione si trovano nello stesso Paese. - Per bloccarne molti contemporaneamente, seleziona **Incolla un elenco**, incolla fino a 500 numeri (uno per riga o separati da virgole) e invia. Il risultato mostra quanti numeri sono stati aggiunti, erano già bloccati o non validi, ed elenca le voci non valide. - Per sbloccare un numero, seleziona **Rimuovi** nella relativa riga e conferma. Puoi anche aprire una chiamata in entrata nella **Cronologia chiamate** e selezionare **Blocca questo chiamante**. Un'organizzazione può bloccare fino a 10.000 numeri. Per gestire l'elenco tramite l'API, consulta [Chiamanti bloccati](/api-reference/blocked-callers). ### Identità e membri dell'organizzazione La scheda dell'organizzazione mostra l'ID dell'organizzazione, il tuo ruolo di membro e il nome dell'organizzazione modificabile. La scheda del team riunisce i membri attivi e gli inviti in sospeso. | Ruolo | Accesso tipico | | --- | --- | | **Membro** | Crea e gestisce agenti e controlla le chiamate. | | **Amministratore** | Accesso da membro, oltre ad amministrazione di team, chiavi, portali, connessioni, avvisi, fatturazione e sicurezza. | | **Proprietario** | Accesso da amministratore, oltre alle azioni dell'organizzazione a livello di proprietà. | I proprietari e gli amministratori possono invitare un **Membro** o un **Amministratore**, revocare un invito in sospeso, modificare i ruoli dei membri idonei e rimuovere membri. Gli inviti sono specifici per email e scadono dopo sette giorni. Consulta [Invita il tuo team](/it/guides/invite-your-team). La zona pericolosa consente a un utente idoneo di lasciare un'organizzazione o eliminarla definitivamente. L'eliminazione rimuove gli agenti, i numeri, la cronologia delle chiamate e i dati di fatturazione dell'organizzazione e non può essere annullata. Per eliminare il tuo account, apri la scheda **Account** e seleziona **Elimina account**. La finestra di dialogo elenca le organizzazioni che verranno eliminate (quelle in cui sei l'unico membro) e quelle che lascerai. Le chiavi API che hai creato in un'organizzazione che lasci vengono revocate. L'eliminazione è bloccata se sei l'unico proprietario di un'organizzazione che ha altri membri (nomina prima un'altra persona proprietaria), se hai creato voci personalizzate in un'organizzazione che rimane, se è in corso una chiamata o se si applica un blocco legale; la finestra di dialogo elenca ciò che la sta bloccando. Non può essere annullata. ### Webhook predefinito Imposta un URL webhook legacy per ricevere eventi da tutti i widget web e i numeri di telefono dell'organizzazione. Per segreti, sottoscrizioni, cronologia di consegna e nuovi tentativi per endpoint, utilizza invece gli [endpoint webhook](/it/webhooks/endpoints) consigliati. ### SSO Enterprise Configura una o più connessioni SSO, domini email consentiti, provisioning just-in-time, il ruolo predefinito e mappature facoltative da gruppo a ruolo. La Politica di sicurezza può richiedere SSO, consentire l'accesso di emergenza con password agli amministratori e richiedere passkey per l'accesso all'organizzazione. Consulta [SSO](/it/guides/sso). ## Chiavi La scheda **Chiavi** gestisce le chiavi API server segrete `sk_live_`. Ogni riga mostra nome, prefisso, stato attivo/revocato, ora di creazione, ultimo utilizzo e ora di revoca. Il segreto completo viene mostrato una sola volta, immediatamente dopo la creazione. Copialo allora e memorizzalo in un gestore di segreti. La revoca è permanente e interrompe ogni integrazione che utilizza la chiave. Consulta [Chiavi API](/it/guides/api-keys). Le chiavi pubblicabili `pk_live_` appartengono ai **Widget web**, perché sono credenziali del browser con restrizioni di origine anziché chiavi server. ## Avvisi Crea regole metriche per tasso di successo, tasso di errore, punteggio medio, volume di chiamate o regressioni della suite. Una regola include: - Comparatore e soglia numerica. - Finestra di valutazione da 1 a 720 ore. - Fino a 10 destinatari email. - URL webhook in entrata Slack facoltativo. - Consegna webhook per sviluppatori facoltativa. - Intervallo di raffreddamento in minuti interi e stato di attivazione. La stessa scheda elenca le attivazioni recenti. Consulta [Avvisi](/it/guides/alerts). ## Impostazioni di fatturazione Gestisci il saldo dell'organizzazione e il comportamento di pagamento: - Aggiungi o sostituisci la carta di pagamento predefinita. - Aggiungi fondi manualmente. - Abilita la ricarica automatica e imposta la relativa soglia e l'importo di ricarica. - Imposta o rimuovi un limite mensile di spesa. Il limite mensile sospende nuove chiamate e utilizzo al 100% e rimane attivo anche quando la ricarica automatica è disattivata. Consulta [Prezzi](/it/guides/pricing) e [Fatturazione e ricariche](/it/guides/billing-and-topups). ## Cronologia di fatturazione Usa **Cronologia di fatturazione** per controllare il saldo e la spesa di oggi, degli ultimi 7 giorni, 30 giorni, 90 giorni o di sempre. Include: - Andamento del saldo. - Ripartizione della fatturazione tra addebiti delle chiamate, report, tariffe dei numeri di telefono e ricariche. - Spesa principale per agente. - Tabella delle transazioni con data, categoria, descrizione, tipo, importo e saldo risultante. - Filtraggio per categoria ed esportazione CSV o JSON della cronologia visualizzata. La dashboard segnala quando vengono visualizzate solo le transazioni più recenti; le righe precedenti oltre tale limite non sono incluse nemmeno nell'esportazione. La [API di fatturazione](/api-reference/billing) supporta la paginazione programmatica.