Guida introduttiva

Portare un white label in produzione significa creare il tuo tenant — il tuo brand, il tuo dominio, i tuoi utenti — e puntare bro verso i tuoi strumenti. Il flusso è self-service nella Console Busymate AI: apri Console → Integrazione per il tenant selezionato e segui la checklist live. Questa sezione è la fonte di verità per URL, identità, snippet, preflight e pubblicazione; sostituisce i file statici di handoff per tenant.

I cinque passi

1. Il tuo tenant

Un tenant è il tuo spazio isolato sulla piattaforma. Porta il tuo nome, uno slug breve e la tua identità di brand. Tutto ciò che fanno i tuoi utenti — conversazioni, cronologia, account collegati — resta dentro il tuo tenant e non è mai visibile ad altri. Un proprietario della piattaforma può crearlo da Console → Piattaforma → Tenant o tramite il management MCP di Busymate AI; l’amministratore invitato completa poi l’integrazione senza passaggio a un operatore.

2. Il tuo dominio

Il tuo assistente è servito su un dominio che scegli tu, mappato al tuo tenant:

• Per iniziare, ogni tenant riceve il proprio host <tenant-slug>.busymate.ai.
• Il tuo dominio (per esempio assistant.tuodominio.com) quando lo punti alla piattaforma e viene verificato. Da quel momento, i tuoi utenti vedono solo il tuo dominio.

Sotto il cofano, un dominio risolve esattamente a un tenant. Un dominio non ancora mappato resta neutro e senza brand — il tuo brand appare solo quando il dominio è verificato e attivato, così non esiste mai una finestra a metà brandizzata davanti ai tuoi utenti.

3. L’identità dei tuoi utenti

Decidi come l’assistente conosce i tuoi utenti:

• Autenticati come sé stessi — colleghi il tuo login, e ogni utente arriva a bro come sé stesso, così bro può agire sui suoi dati (e solo sui suoi).
• Ospiti anonimi — se preferisci lasciare chiunque chattare senza accesso, puoi abilitare la modalità ospite. Gli ospiti ricevono risposte e indicazioni, ma non azioni sui dati privati di un utente specifico.

Puoi offrire entrambi: ospiti come porta d’ingresso, sessioni identificate per gli utenti autenticati.

4. I tuoi strumenti (opzionale)

Se vuoi che bro faccia cose — non solo rispondere — collega il tuo server MCP. È così che bro legge e modifica i dati dei tuoi utenti tramite la tua API, secondo le tue regole. È opzionale: un assistente di conoscenza e risposte non ha bisogno di strumenti. Vedi Collegare i tuoi strumenti.

5. Pubblica

Quando brand, dominio, identità e (opzionalmente) strumenti sono pronti, esegui il preflight e pubblica dalla console. La modifica viene preparata, validata e poi attivata. Un contratto di identità incompleto, un connettore irraggiungibile o una policy strumenti non sicura blocca la pubblicazione con un risultato operativo.

Integrare bro sul tuo sito

Oltre alla pagina ospitata, puoi integrare bro direttamente nel tuo prodotto — un pannello laterale o una bolla di chat nelle tue pagine. L’embed gira sull’origine del tuo sito (che aggiungiamo alla allowlist del tuo tenant), così l’assistente vive proprio dove i tuoi utenti già sono, sempre completamente con il tuo brand. È un solo tag script:

<script
  src="https://busymate.ai/embed/v1.js"
  data-assistant="your-tenant-slug"
  data-label="Ask us"
  async
></script>

Pagina ospitata, embed, o entrambi — decidi tu, e puoi aggiungere l’embed più avanti senza rifare nulla.

Cosa preparare

• Il nome del prodotto e i materiali di brand (logo, colori, un breve messaggio di benvenuto).
• Il dominio desiderato (un sottodominio per iniziare, o il tuo dominio da verificare).
• Come i tuoi utenti accedono — o se vuoi l’accesso ospite.
• Facoltativamente, l’URL del tuo server MCP se vuoi che bro esegua azioni.

Prossimi passi

• L’esperienza dell’assistente — cosa vedono i tuoi utenti quando sei live.
• Governance e policy dei modelli — attiva le funzioni e definisci la policy dei modelli.
• Collegare i tuoi strumenti — lascia che bro agisca sui dati dei tuoi utenti.