Vai al contenuto
Busymate AI

Documentazione

Guida introduttiva

In questa pagina

Portare un white label in produzione significa creare il tuo spazio di lavoro — il tuo brand, il tuo dominio, i tuoi utenti — e puntare il tuo amico verso i tuoi strumenti. Il flusso è self-service nella Console Busymate AI: apri Console → Integrazione per lo spazio di lavoro 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 spazio di lavoro.

I cinque passi

1 · Spazio 2 · Dominio 3 · Identità 4 · Strumenti 5 · Pubblica

1. Il tuo spazio di lavoro

Uno spazio di lavoro è 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 spazio di lavoro e non è mai visibile ad altri. Un proprietario della piattaforma può crearlo da Console → Platform → Workspaces 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 spazio di lavoro:

  • Per iniziare, ogni spazio di lavoro riceve il proprio host <workspace-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 uno spazio di lavoro. 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 al tuo amico come sé stesso, così il tuo amico 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 il tuo amico faccia cose — non solo rispondere — collega il tuo server MCP. È così che il tuo amico 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 il tuo amico sul tuo sito

Oltre alla pagina ospitata, puoi integrare il tuo amico 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 spazio di lavoro), così l’assistente vive proprio dove i tuoi utenti già sono, sempre completamente con il tuo brand. È un solo tag script:

html
<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 il tuo amico esegua azioni.

Prossimi passi