# Guida rapida al White-Label Un percorso mirato in sei passaggi da "Ho appena eseguito l'upgrade ad Agency" a una piattaforma completamente personalizzata a cui il tuo primo cliente può accedere. Niente complicazioni, niente impostazioni avanzate: solo la linea più breve tra una dashboard generica e un prodotto che sembra *tuo*. Ogni passaggio ha una stima dei tempi e un link alla pagina di approfondimento se desideri maggiori dettagli in seguito. Pianifica circa mezz'ora del tuo tempo, più fino a un'ora di attesa affinché il DNS diventi attivo in background. Se incontri un ostacolo in qualsiasi passaggio, vai avanti: potrai tornarci in seguito. ::: walkthrough white-label-quickstart ::: *** ## Cosa avrai alla fine - Il tuo dominio personalizzato (ad esempio, `app.youragency.com`) che punta alla piattaforma - Un certificato di sicurezza valido (l'icona del lucchetto nel browser) - Il nome della tua azienda, logo, icona (favicon), colori e testo SEO che sostituiscono quelli predefiniti - Una decisione chiara su **come** integrerai i clienti (gestito vs. rivendita) - Un sotto-account di prova che ha effettuato l'accesso al tuo dominio personalizzato Una volta che tutto funziona, ogni nuovo cliente riceverà automaticamente la stessa esperienza personalizzata: dovrai eseguire questa configurazione una sola volta. *** ## Prima di iniziare Devi disporre del piano di abbonamento **Agency**. Il white-label non è disponibile nei piani inferiori. Se non hai ancora il piano Agency, vai su **Impostazioni → Fatturazione** (sotto Area di lavoro) ed esegui prima l'upgrade: la voce **White Labeling** non apparirà in Impostazioni → Avanzate finché non lo farai. Avrai inoltre bisogno di: - Un dominio di tua proprietà (o un sottodominio su un dominio di tua proprietà). La maggior parte delle agenzie utilizza qualcosa come `app.youragency.com` piuttosto che il semplice `youragency.com`, in modo che il sito di marketing e l'app rimangano separati. - Accesso al tuo registrar di domini (GoDaddy, Cloudflare, Namecheap, ecc.), nello specifico alla pagina delle impostazioni DNS. Se non hai le credenziali di accesso, recuperale prima di iniziare. - Due file immagine per il tuo brand: - **Logo** — un logo orizzontale, PNG, WebP o SVG, fino a 5 MB. - **Favicon** — un'icona quadrata utilizzata come favicon della scheda del browser, PNG, WebP o SVG, fino a 5 MB. 256×256 pixel è una dimensione ideale. *** ## Passaggio 1 — Decidi come integrerai i clienti (≈ 5 min) Prima di toccare qualsiasi impostazione, prendi una decisione: come pagheranno e si iscriveranno i clienti? Questo influisce sull'esperienza complessiva del percorso. - **Modalità gestita.** Crei tu stesso ogni sub-account dalla pagina **Sub Accounts**. Fatturi al cliente fuori dalla piattaforma (bonifico bancario, il tuo strumento di contabilità, qualsiasi cosa tu stia già utilizzando). Il cliente non vede mai una pagina dei prezzi. Ideale per configurazioni "chiavi in mano", paesi non serviti da Stripe o agenzie con sistemi di fatturazione esistenti. - **Modalità rivenditore.** I clienti si registrano autonomamente tramite un link di pagamento, configurato in **Modalità SaaS**. Pagano tramite il tuo account Stripe collegato con il tuo ricarico applicato automaticamente. Ideale per la vendita self-service su larga scala e pacchetti di prodotti. Non devi impegnarti per sempre, ma passare un singolo sotto-account da una modalità all'altra in seguito richiede un lavoro manuale. Scegli il modello più adatto alla *maggior parte* dei tuoi clienti. Analisi completa: [Gestione dei sotto-account dei clienti](sub-accounts.md). *** ## Passaggio 2 — Scegli il tuo dominio personalizzato (≈ 2 min) Decidi l'indirizzo web esatto che i tuoi clienti utilizzeranno per accedere. Alcune regole generali: - **Un sottodominio è più semplice.** `app.youragency.com` è lo standard. Mantieni `youragency.com` per il tuo sito di marketing: è un singolo record DNS, contro i due (e più fragili se cambi provider DNS) per un dominio nudo/apex. - **Mantienilo breve e ovvio.** `app.`, `platform.`, `dash.` o `clients.` funzionano tutti. Evita nomi ingegnosi che i clienti devono ricordare. - **Puoi gestire fino a tre white label.** La maggior parte delle agenzie ne ha bisogno solo di una, ma puoi aggiungere fino a **tre** domini sullo stesso account agenzia, ognuno con il proprio dominio, branding e invio di email: un secondo brand per un mercato diverso, o un dominio Lead Finder per i tuoi clienti. I domini extra oltre al primo sono inclusi nel [Champions Circle](../billing/champions-circle.md). Questa guida rapida configura il tuo primo dominio; vedi [Fino a tre White Label](white-labeling.md#up-to-three-white-labels) per aggiungerne altri. Annota il dominio scelto: lo incollerai nel passaggio successivo. *** ## Passaggio 3 — Aggiungi il dominio nella tua dashboard (≈ 2 min) 1. Nella barra laterale principale, fai clic su **Impostazioni** (vicino al fondo, sotto Sub Accounts). 2. Nel menu Impostazioni, scorri fino al gruppo **Avanzate** e fai clic su **White Labeling**. 3. Scorri fino alla scheda **Dominio personalizzato**. 4. Nel campo **Dominio app**, digita il dominio scelto nel passaggio 2 (ad esempio `app.youragency.com`). Non includere `https://` o una barra finale: solo il dominio stesso. 5. Fai clic su **Salva**. Una volta salvato, la scheda mostra il record CNAME che devi aggiungere presso il tuo registrar: il tuo dominio a sinistra, `tenants.youraiconnector.com` a destra. ::: master-only
La scheda Dominio personalizzato nella v2, che mostra il campo Dominio app e le istruzioni CNAME per tenants.youraiconnector.com

La scheda Dominio personalizzato dopo il salvataggio: il tuo dominio, la destinazione CNAME da copiare e i domini app/API/docs una volta verificati.

::: **Lascia aperta questa scheda**: stai per copiare quel valore nel tuo registrar. *** ## Passaggio 4 — Aggiungi il record DNS presso il tuo registrar (≈ 10 min) I record DNS sono la rubrica di Internet: indicano ai browser dove trovare il tuo dominio personalizzato. Ora stai comunicando al mondo che `app.youragency.com` dovrebbe puntare alla piattaforma. 1. Accedi al sito dell'azienda presso cui hai acquistato il dominio (il tuo "registrar": GoDaddy, Cloudflare, Namecheap, ecc.) in una **scheda del browser separata**. 2. Trova la pagina delle **impostazioni DNS** per il tuo dominio. A volte è chiamata "Gestione DNS" o "Record DNS". 3. Aggiungi un record **CNAME**: - **Host / Nome** — per un sottodominio come `app.youragency.com`, solitamente è solo `app` presso la maggior parte dei registrar (aggiungono il resto automaticamente). - **Valore / Destinazione / Punta a** — `tenants.youraiconnector.com`, esattamente come mostrato nella scheda Dominio personalizzato. - Lascia il **TTL** al valore predefinito (o 3600 / 1 ora se richiesto). 4. Fai clic sul pulsante **Salva** del tuo registrar. > **Attenzione ai conflitti.** Se esiste già un record dello stesso tipo per quell'host (ad esempio, un vecchio record A che punta altrove), eliminalo o aggiornalo prima: due record in conflitto impediranno la verifica. > **Usi Cloudflare?** Puoi lasciare il proxy (l'interruttore a forma di nuvola arancione accanto al record) attivo: la verifica e i certificati funzionano in entrambi i casi. Un'impostazione però è importante: vai su **SSL/TLS → Overview** e assicurati che la modalità di crittografia sia **Full (strict)**, non **Flexible**. Con Flexible, il tuo dominio si rifiuterà di caricarsi con un errore di "troppi reindirizzamenti". > **NON visitare ancora il tuo dominio personalizzato.** Visitare il sito prima che la configurazione sia completa può memorizzare nella cache del browser una pagina non funzionante. Attendi finché non avrai confermato che carichi la schermata di accesso nel passaggio 5. Le modifiche DNS possono richiedere da pochi minuti a qualche ora per propagarsi, sebbene la maggior parte dei registrar (specialmente Cloudflare e Namecheap) si aggiorni entro un'ora. Se dopo un giorno non è ancora risolto, ricontrolla il record per eventuali errori di battitura e salvalo di nuovo. *** ## Punto 5 — Attendi il certificato di sicurezza (≈ da pochi minuti a un'ora, automatico) Una volta che il tuo CNAME è attivo, la piattaforma lo rileva automaticamente, ne verifica la proprietà e fornisce un certificato di sicurezza (SSL) per il tuo dominio: è questo che ti garantisce l'icona del lucchetto nel browser e il prefisso `https://`. - Non devi acquistare o installare nulla. Il certificato viene creato e rinnovato per te per sempre. - Solitamente il processo si completa entro 5–30 minuti dalla messa online del record DNS. Una volta pronto, apri il tuo dominio personalizzato in una nuova scheda del browser. Dovresti vedere la schermata di accesso della piattaforma, servita tramite HTTPS, al tuo indirizzo web. La parte tecnica è terminata. ::: master-only
Una pagina di accesso white-label su un dominio personalizzato, che mostra il nome e il logo dell'agenzia senza alcun marchio della piattaforma

Cosa vedono i tuoi clienti: la pagina di accesso sul tuo dominio, con il tuo nome e il tuo logo — nessuna traccia di noi.

::: > **Carica il tuo logo prima di condividere il link.** Finché non viene caricato un logo nel passaggio di branding qui sotto, la pagina di accesso mostrerà un errore di immagine non trovata dove dovrebbe apparire il logo. Completa il Passaggio 6 prima di mostrare il dominio a chiunque. *** ## Punto 6 — Personalizza il brand della piattaforma (≈ 15 min) Il dominio è attivo, ma la piattaforma mostra ancora un nome segnaposto neutro ("DM Champ") e la nostra icona. È il momento di risolvere il problema. Tutto ciò che segue si trova nello stesso pannello **Impostazioni → Avanzate → White Labeling**, nelle schede sopra la scheda Dominio personalizzato. ### 6a. Brand Nella scheda **Brand**, compila: - **Nome dell'app** — il nome del brand visualizzato in tutta l'app, in ogni email e nella scorciatoia della schermata iniziale. Obbligatorio: finché non viene impostato, viene visualizzato "DM Champ". - **Nome dell'azienda** — il nome legale/aziendale, utilizzato nei piè di pagina e nelle email. - **Email di supporto** — l'indirizzo a cui rimanda "Contatta il supporto" e l'indirizzo di risposta nelle email di sistema. - **URL dei termini di servizio** e **URL dell'informativa sulla privacy** — le tue pagine legali. La pagina di registrazione sul tuo dominio rimanda a queste; se lasciate vuote, non verrà mostrato alcun link (mai il nostro). - **Titolo SEO** e **Descrizione SEO** — ciò che viene visualizzato nelle schede del browser e nei risultati di ricerca. Fai clic su **Salva** nella scheda Brand. ::: master-only
La scheda Brand nel pannello delle impostazioni White Label, con i campi Nome dell'app, Nome dell'azienda, Email di supporto, URL dei termini di servizio, URL dell'informativa sulla privacy, Titolo SEO e Descrizione SEO e un pulsante Salva nell'intestazione della scheda

La scheda Brand — Nome dell'app, Nome dell'azienda, Email di supporto, URL dei termini di servizio, URL dell'informativa sulla privacy, Titolo SEO e Descrizione SEO, tutto in un unico salvataggio.

::: ### 6b. Logo e favicon Nella scheda **Logo e Favicon**, fai clic su **Carica** sotto **Logo** e seleziona il tuo logo orizzontale (PNG/WebP/SVG, fino a 5 MB). Fai lo stesso per la **Favicon** (quadrata, 256×256 è l'ideale). Questi vengono salvati immediatamente al caricamento: non c'è un pulsante Salva separato. ::: master-only
La scheda Logo e favicon, che mostra quattro slot di caricamento — Logo, Logo (modalità scura), Favicon, Icona app (quadrata) — e un cursore per le dimensioni del logo sottostante impostato su 48 px

La scheda Logo e Favicon — quattro slot (Logo, logo in modalità scura, Favicon, Icona app). Ogni pulsante Carica salva istantaneamente non appena selezioni un file. La dimensione del logo sottostante imposta quanto grande viene visualizzato il tuo logo; quella impostazione richiede il salvataggio.

::: ### 6c. Colori Nella scheda **Colori**, fai clic sul quadrato **Colore primario** e imposta il colore principale del tuo brand (l'impostazione predefinita è il verde di WhatsApp, `#25D366`), quindi fai lo stesso per il **Colore accento**. Fai clic su **Salva**. ::: master-only
La scheda Colori nella v2, che mostra i campioni di Colore primario, Colore accento, Successo e Pericolo, oltre a sei palette predefinite

La scheda Colori: Primario e Accento sono i due che userai oggi; Successo, Pericolo e le palette predefinite sono scorciatoie opzionali.

::: ### 6d. Rifiniture successive (opzionale) Caratteri, densità e uno sfondo di accesso personalizzato si trovano più in basso nello stesso pannello; non sono necessari per un white-label funzionante, quindi sentiti libero di saltarli oggi e tornare in seguito. Riferimento completo: [White-Labeling e domini personalizzati](white-labeling.md). Dopo aver salvato, esegui un aggiornamento forzato del tuo dominio personalizzato (Ctrl+Shift+R su Windows, Cmd+Shift+R su Mac) e conferma che la scheda del browser ora mostri il tuo nome e la tua icona, e che i pulsanti utilizzino il tuo colore primario. *** ## Passaggio 7 — Crea un sub-account di prova e accedi come tale (≈ 10 min) Non hai finito finché l'esperienza del cliente reale non funziona dall'inizio alla fine. Crea un sub-account per te stesso (usa un'email personale che puoi controllare) e conferma che il flusso sia corretto. 1. Nella barra laterale principale, fai clic su **Sub Accounts** (la sua pagina dedicata, subito sopra Impostazioni). ::: master-only
La pagina Sotto-account nella v2, che mostra i riquadri delle statistiche, la barra di ricerca e il pulsante Aggiungi account

La pagina Sotto-account: è qui che creerai l'account di test e, in seguito, ogni cliente reale.

::: 2. Fai clic sul pulsante verde **Aggiungi account** in alto a destra. 3. Inserisci i dettagli del test nel modulo in 3 passaggi: - **Account**: il tuo nome, cognome e un'email personale che puoi controllare. - **Business**: un nome aziendale (obbligatorio); il resto può rimanere vuoto per il test. - **Funzionalità**: lascia le impostazioni predefinite. ::: master-only
Il modale Aggiungi sotto-account nel passaggio Account, che mostra l'avanzamento in 3 passaggi (Account, Azienda, Funzionalità) con i campi nome, cognome ed email

Il modale Aggiungi account, passaggio 1 di 3. L'email che inserisci qui diventa il login del cliente di test.

::: 4. Fai clic su **Crea account**. 5. Una schermata di conferma mostra la **password generata**. **Copiala ora**: non potrai più visualizzarla. Il cliente riceverà questa password anche via email. 6. Apri l'email: **verifica che mostri il tuo Nome App (Passaggio 6a) come brand del mittente, non il nostro**. Se mostra ancora il nostro nome, il branding non si è ancora propagato: attendi 1 minuto e ricontrolla. 7. Disconnettiti dal tuo account agenzia (menu utente in alto a destra → Disconnetti). 8. Apri il tuo dominio personalizzato in una **finestra di navigazione in incognito/privata** e accedi con l'email e la password copiata del sub-account di test. 9. Segui i primi 30 secondi dell'esperienza del sub-account: - La pagina di login mostra il nome e il logo del tuo brand? - L'interfaccia della dashboard utilizza il tuo colore primario? - I titoli delle pagine (scheda del browser) utilizzano il tuo Nome App? - Se hai disattivato "Mostra menu di aiuto", conferma che non ci sia la voce Aiuto nella barra laterale. - I link a Termini/Privacy (se li hai aggiunti) rimandano ai tuoi URL? Se qualcosa mostra ancora il nome o il colore sbagliato, torna al Passaggio 6 e correggilo. Guida completa per il flusso del sub-account: [Gestione Sub-Account](sub-accounts.md). *** ## E adesso? Hai un white-label funzionante, attivo e con il tuo brand. Il resto riguarda la scalabilità e il perfezionamento: - **Imposta i prezzi di rivendita.** Se hai scelto la rivendita nel Passaggio 1, configura il ricarico sui crediti e i prezzi del piano in [Account Agenzia](agency-accounts.md#credit-reselling-aka-saas-mode) prima di inviare il link di pagamento ai clienti reali. Ogni piano può essere fatturato **mensilmente, annualmente o ogni N settimane** e può iniziare con una **prova gratuita** — entrambi vengono impostati sul piano stesso nel [Passaggio 3 — Configura i livelli di prezzo](agency-accounts.md#step-3--set-up-pricing-tiers). - **Configura la ricarica automatica per i clienti.** La [Ricarica automatica del sub-account](sub-account-auto-recharge.md) impedisce ai clienti di esaurire i crediti alle 2 del mattino. - **Personalizza il mittente dell'email.** Per impostazione predefinita, le email transazionali provengono dal nostro dominio. Collega il tuo dominio di invio nella pagina [Provider email personalizzato](../settings/email-provider.md) in modo che le email dei clienti provengano invece da `noreply@youragency.com`. Sono disponibili un'opzione Mailgun e un'opzione SMTP (Postmark, SES, EmailIt, self-hosted). - **Fai l'onboarding del tuo primo cliente reale.** La [Gestione dei sub-account](sub-accounts.md) copre le attività quotidiane di gestione dei clienti: assegnazione dei crediti, accesso come cliente, blocco e sblocco, ecc. Se qualcosa in questa guida non ha funzionato come previsto, la pagina [White-Labeling and Custom Domains](white-labeling.md) contiene la sezione completa per la risoluzione dei problemi. *** ## Venderlo: cosa forniamo noi e cosa spetta a te I rivenditori ci chiedono materiale di vendita, casi studio, indicazioni sui prezzi e modelli legali. Ecco la suddivisione onesta. **Cosa esiste oggi:** - **Casi studio e playbook** che puoi utilizzare nella tua presentazione, pubblicati su [dmchamp.com/resources](https://dmchamp.com/resources/) — incluso il [playbook per agenzie da 10k MRR](https://dmchamp.com/resources/agency-10k-mrr-playbook/). Sono pagine pubbliche, quindi puoi inviare il link a un potenziale cliente o inserire i numeri nella tua presentazione. - **Una demo che puoi eseguire davanti a un potenziale cliente** senza toccare il tuo account: il **link demo cliente** del widget chat posiziona il tuo widget sopra il *loro* sito web. Vedi [Mostrare il widget sul sito web di qualcun altro](../get-started/chat-widget.md#show-the-widget-on-someone-elses-website). - **[Snapshot](snapshots.md)** — una configurazione cliente completa che puoi applicare a ogni nuovo sub-account, così il tuo secondo cliente richiederà minuti anziché ore. Questa è la cosa più vicina a un'offerta standardizzata che la piattaforma ti offre. - **Gli strumenti di determinazione dei prezzi stessi** — i tuoi piani, i tuoi prezzi, il tuo checkout, in [Modalità SaaS](agency-accounts.md#credit-reselling-aka-saas-mode). **Cosa non forniamo:** - Presentazioni di vendita o brochure già pronte. L'abbonamento al [Champions Circle](../billing/champions-circle.md) include modelli di siti web per agenzie già pronti, istantanee degli agenti e analisi mensili, e questo è tutto il materiale di vendita che forniamo. - Modelli legali: nessun modello di MSA, SLA o contratto per i clienti. Sei tu la parte contraente con i tuoi clienti, quindi questi devono essere tuoi e revisionati dal tuo avvocato. - Prezzi al dettaglio consigliati per il tuo mercato. Il valore di un cliente a Milano non è lo stesso di Manila, e una cifra fornita da noi sarebbe solo una supposizione sul tuo mercato. **Una regola che si applica ai tuoi prezzi:** i tuoi Termini di Servizio ti impegnano a non offrire prezzi inferiori a quelli ufficiali diretti della piattaforma. Prezzare al di sopra, includerlo in un pacchetto con i tuoi servizi o integrarlo in un canone mensile va benissimo ed è ciò che fa la maggior parte delle agenzie. Se preferisci indirizzare i clienti invece di gestire la tua piattaforma, esiste anche il [programma di affiliazione](../billing/affiliate-program.md): 40% di commissione ricorrente su ogni pagamento dell'abbonamento. Benvenuto nella gestione della tua piattaforma.