Configurazione dominio e branding white-label

Configurazione white-label

Tre elementi trasformano la tua organizzazione in una piattaforma completamente personalizzata con il tuo marchio: un dominio personalizzato, il tuo branding e il tuo server SMTP personale. Dominio e SMTP sono obbligatori per una configurazione di produzione; il branding può essere perfezionato in qualsiasi momento.

1. Dominio personalizzato

I tuoi clienti accedono tramite il tuo dominio personale (ad es. chat.your-agency.com). La procedura guidata di configurazione in Account → Configurazione white-label ti guida passo dopo passo:

  1. Inserisci il tuo dominio: è consigliato un sottodominio come chat.your-agency.com.
  2. Crea un record DNS presso il tuo provider DNS:
    TipoNomeValoreTTL
    CNAMEchat.your-agency.comconnect.webchatagent.com300
  3. Fai clic su Verifica DNS ora. Una volta propagato il record (di solito minuti, fino a 24 ore a seconda del provider), il dominio viene contrassegnato come Verificato.

Il certificato TLS per il tuo dominio viene emesso automaticamente alla prima visita, senza necessità di caricare alcun certificato.

Il dominio deve puntare direttamente a connect.webchatagent.com (solo DNS). Se utilizzi Cloudflare per la tua zona, imposta il record su "Solo DNS" (nuvola grigia), non con proxy.

Una volta verificato, il dominio compare in Impostazioni → Account con un badge verde e la tua piattaforma è raggiungibile all'indirizzo https://chat.your-agency.com.

2. Branding

In Impostazioni → Account → Branding puoi controllare l'aspetto della piattaforma per i tuoi clienti:

CampoUtilizzato in
Nome piattaformaTitolo del browser, intestazione della dashboard, tutte le email
URL del logoBarra laterale della dashboard, pagina di login, intestazione delle email
URL della faviconScheda del browser
Colore primarioPulsanti, link, elementi in risalto in tutta la dashboard
Testo Powered-by e URLRiga di attribuzione opzionale nel Widget di chat
Testo piè di pagina emailPiè di pagina di ogni email inviata ai tuoi clienti
URL note legali e privacyLink legali nelle email, collegali a pagine presenti sul tuo Sito Web

Le modifiche vengono applicate a livello di piattaforma dopo il salvataggio.

3. SMTP (il tuo server email)

Tutte le email destinate ai tuoi clienti, come inviti, reimpostazioni della password e notifiche, vengono inviate tramite il tuo server SMTP con il tuo indirizzo mittente. Questo passaggio è obbligatorio: senza una configurazione SMTP funzionante, non viene inviata alcuna email per la tua organizzazione (la piattaforma non ricorre mai al proprio mittente predefinito, poiché ciò rivelerebbe l'identità della piattaforma e comprometterebbe SPF/DKIM).

Configuralo in Impostazioni → Account → Email / SMTP:

CampoEsempio
Host SMTPsmtp.your-domain.com
Porta587 (predefinito)
TLS/SSLa seconda del tuo server
Nome utente / passwordle tue credenziali SMTP
Nome mittenteYour Brand
Indirizzo mittentenoreply@your-domain.com

Usa l'opzione per inviare un'email di prova per verificare la configurazione prima di invitare i clienti.

Assicurati che i record SPF/DKIM per il tuo dominio di invio includano il tuo provider SMTP, altrimenti i tuoi inviti potrebbero finire nello spam.

4. Incorporamento del Widget con il tuo marchio

Lo script del Widget servito dal tuo dominio utilizza tag di elementi indipendenti dal marchio: fornisci ai tuoi clienti finali gli snippet con <chat-widget> (flottante) o <chat-agent-inline> (in linea), caricati dal tuo dominio white-label:

<script src="https://chat.your-agency.com/widget/chat-widget.js" async></script>
<chat-widget chatbot-id="THEIR_CHATBOT_ID"></chat-widget>

Lo stesso vale per i Dati di contesto della sessione: oltre all'attributo neutro context-data, il Widget accetta i nomi JavaScript indipendenti dal marchio window.chatWidgetContext (variabile globale, definibile prima del caricamento dello script) e l'evento chat-widget:context. Per il consenso sui cookie, l'evento neutro chat-widget:consent funziona in parallelo a quello con il marchio. Documenta questi nomi neutri per i tuoi clienti finali, in modo che le loro pagine non debbano mai fare riferimento alla piattaforma.