Come configurare una piattaforma chatbot white label come amministratore

Accedi come amministratore white-label dedicato e apri Account dall'intestazione. L'account deve corrispondere al ruolo admin all'interno di un'organizzazione con tipo whitelabel. La barra laterale mostrerà quindi la sezione Admin limitata all'organizzazione con la voce Users; non deve mostrare le route a livello di superadmin come Organizations, Costs, Revenue o altre impostazioni globali.

Prendi nota del nome dell'organizzazione, dell'identità dell'account e dell'host corrente senza mostrare password, token di sessione o credenziali SMTP segrete. Se lo stato previsto, la scheda Branding, la scheda SMTP o il link Users non sono visibili, fermati. Non continuare con un utente normale, un membro del team o un superadmin della piattaforma.

Nella parte superiore di Account Settings, controlla il piano attuale, il pool di chatbot, i messaggi mensili, i caratteri per i dati di addestramento e il badge di verifica del dominio. Il primo numero indica l'utilizzo effettivo dell'intera organizzazione; il secondo rappresenta la capacità disponibile. Gli utenti riceveranno in seguito tetti massimi personali attinti da questo pool.

Puoi aprire le finestre di dialogo relative ad add-on, piani e funzionalità vocali per illustrare le opzioni disponibili, ma non accettare termini, non selezionare Buy now, non modificare quantità a pagamento, non cancellare livelli e non aprire il portale Stripe durante l'acquisizione del tutorial. L'anteprima dei costi non è un acquisto di prova.

Apri Set up whitelabel e inserisci solo il nome host approvato, senza https://,, percorsi o barre finali. Questo tutorial utilizza northstar-wl-tutorial.test, un valore riservato esclusivamente a test locali che non può dimostrare la proprietà del dominio, il routing pubblico o la disponibilità del certificato. Sostituiscilo con un sottodominio dedicato e controllato dall'organizzazione solo durante il rollout di produzione separato.

La modifica del dominio annulla la verifica precedente. Conferma l'host previsto con il responsabile DNS, il responsabile dell'identità e il team di supporto prima di salvare. Non riutilizzare il dominio di accesso di produzione per un tutorial e non puntare un dominio apex senza un piano verificato per DNS e impatto sulla posta.

La pagina di configurazione mostra la procedura per la produzione: copia esattamente tipo di record, nome, destinazione (target) e TTL nel pannello del provider DNS dell'organizzazione. CNAME è l'opzione consigliata; utilizza il record A alternativo proposto solo dopo che il responsabile DNS avrà valutato i compromessi operativi. Durante questo test locale riutilizzabile non è stato creato né interrogato alcun record DNS reale.

Lo stato verde mostrato nello screenshot è stato predisposto localmente per illustrare l'interfaccia. Per la produzione, attendi la propagazione, seleziona Check DNS now, richiedi che risulti DNS correct e Verified, quindi apri l'URL del tenant in HTTPS in un browser pulito per verificare certificato, host e schermata di accesso personalizzata. Nessuno di questi controlli DNS o HTTPS esterni è attestato dalle prove di questo tutorial.

In Branding & whitelabel, imposta il nome fittizio della piattaforma Northstar AI Studio, support@example.com, il colore primario #029cf5, “Powered by Northstar AI Studio”, https://example.com, un piè di pagina fittizio e i percorsi riservati per note legali e privacy sotto example.com. Carica il logo e la favicon di TEST approvati; l'organizzazione reale dovrà utilizzare i propri asset verificati e le proprie pagine legali.

Salva una volta e attendi il ricaricamento dell'applicazione. Controlla che nessun campo venga tagliato e che le proporzioni delle immagini siano corrette. Il colore primario genera la scala cromatica dell'interfaccia, mentre i link nel piè di pagina delle email sono indipendenti dal nome e dall'indirizzo del mittente SMTP.

Apri Dashboard dopo il salvataggio. Verifica il logo di Northstar, l'intestazione Welcome back, Northstar, la scheda reale No Chatbots Yet, il nome dell'organizzazione nel titolo del browser e il tema blu salvato. Questa schermata è volutamente diversa da Account Settings, dimostrando che il branding salvato viene applicato correttamente a un'altra route del prodotto.

Per il lancio in produzione, apri il dominio del tenant verificato in una sessione pulita separata. Controlla la favicon, il certificato, la pagina di accesso, lo stato del focus blu, lo stile dei pulsanti, i link dell'account e i contatti di supporto per i clienti. Esegui la verifica su desktop e su uno schermo ridotto senza passare alla modalità scura (Dark Mode).

Carica la sezione Email / SMTP prima di inserire qualsiasi dato. Utilizza host, porta, modalità SSL, nome utente, password, nome mittente e indirizzo mittente approvati per l'ambiente non di produzione dell'organizzazione. La password deve essere recuperata da un gestore di segreti e non deve mai comparire in screenshot, registrazioni audio, log, file sorgente o manifest. Lasciando il campo password vuoto, viene mantenuto il segreto già memorizzato.

Salva solo dopo che la configurazione corrente è stata caricata correttamente. Il pulsante Test connection può contattare il server SMTP, quindi eseguilo solo verso la sandbox approvata. Per una prova di recapito, invita unicamente una casella di posta controllata dopo che il test di connessione ha avuto successo. Il server rifiuta le email white-label se non è presente un SMTP personalizzato funzionante, per evitare fughe dell'identità del mittente di WebChatAgent; un test non riuscito blocca la fase di invito.

Apri Admin → Users. Le schede del pool dell'organizzazione mostrano la capacità attualmente utilizzata e la quantità già allocata. La tabella dei clienti mostra quindi lo stato dell'account, il numero effettivo di chatbot, le allocazioni personali, i provider di modelli interni consentiti e l'ultima attività.

Lascia un campo vuoto se il cliente deve attingere al pool condiviso dell'organizzazione. Inserisci un numero solo se il contratto o i limiti operativi richiedono un tetto massimo personale. I messaggi, i contenuti indicizzati e lo spazio di archiviazione utilizzati dai clienti di TEST consumano comunque le risorse del pacchetto, anche se i loro bot non conteggiano slot bot a pagamento.

Scegli Create directly anziché Invite user. Inserisci Northstar Demo Client e wl-client-tutorial@example.com, fornisci la password solo dall'ambiente di acquisizione protetto e attiva Test account. La creazione diretta non invia email, crea un utente standard e applica il contrassegno di eliminazione automatica dopo 14 giorni.

Verifica che compaia esattamente una nuova riga con il badge Test e l'indicazione della data di scadenza. Registra il nuovo ID utente all'esterno del materiale pubblico per consentire una pulizia precisa. Non utilizzare mai indirizzi di clienti, colleghi o caselle reali, e non pronunciare la password ad alta voce né digitarla se un ingrandimento dello schermo potrebbe renderla visibile.

Modifica solo la nuova riga di TEST. Assegna 1 chatbot, 2,000 messaggi al mese e 500,000 caratteri di addestramento. Limita i provider interni a Google Vertex (EU). Attiva l'accesso limitato alla dashboard e concedi Chatbots, Conversations e Analytics. Imposta Leads come anteprima bloccata (teaser); lascia nascosti Live Chat, Feedback, Questions, Bookings, Tickets e Calls.

Salva e riapri il cliente per confermare il salvataggio dei dati. Un'anteprima promozionale (teaser) non è un accesso reale: mostra una funzione sfocata e il modulo di contatto dell'organizzazione. Se si restringono i permessi di un cliente, vengono limitati anche quelli dei membri del suo team; rimuovere la restrizione in un secondo momento non ripristina automaticamente i permessi revocati.

Usa Log in as this user sulla riga attiva del cliente di TEST. Il banner arancione di impersonificazione deve indicare chiaramente wl-client-tutorial@example.com. Crea un assistente chiamato Northstar Client Test e verifica che sia possibile aprire Chatbots, Conversations e Analytics. Controlla che il cliente possa selezionare unicamente Google Vertex (EU).

Apri Leads e verifica che compaia l'anteprima bloccata anziché i dati reali. Prova ad accedere a un URL diretto come Bookings e verifica che avvenga il reindirizzamento alla Dashboard senza mostrare contenuti protetti. Il cliente non deve visualizzare Admin → Users, lo stato white-label dell'account, Branding, SMTP, opzioni di acquisto piani o gli assistenti di altri clienti. Registra separatamente le route consentite e quelle bloccate.

Esci dall'impersonificazione tramite il banner arancione e verifica che l'amministratore white-label torni a /settings/users. Disabilita l'utente di TEST specifico e controlla che la sua sessione attiva perda l'accesso autenticato. Riabilitalo solo per il tempo necessario a completare un controllo programmato, altrimenti procedi subito con l'eliminazione definitiva.

Elimina wl-client-tutorial@example.com e conferma l'avviso che segnala la rimozione del relativo assistente e dei dati associati. Esegui nuovamente una verifica dell'organizzazione per confermare che l'utente, il bot Northstar Client Test e i record collegati siano completamente assenti. Ripristina il layout del branding precedente, rimuovi i file del logo di TEST caricati, ripristina o rimuovi il dominio del tutorial, lascia inalterato l'SMTP a meno che non sia stata modificata una configurazione sandbox dedicata, e accertati che non siano stati avviati pagamenti, inviati inviti o inoltrate email a clienti reali.