Riferimento delle impostazioni dell

Gestisci un

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 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.

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.

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.

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.

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.

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 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.

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.

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.

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 e Fatturazione e ricariche.

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 supporta la paginazione programmatica.