Documentação

Primeiros passos

Nesta página

Colocar um white label no ar significa montar o seu espaço de trabalho — sua marca, seu domínio, seus usuários — e apontar o seu parceiro para as suas ferramentas. O fluxo é self-service no Console Busymate AI: abra Console → Integração para o espaço de trabalho selecionado e siga a checklist ao vivo. Essa seção é a fonte de verdade para URLs, identidade, snippets, preflight e publicação; ela substitui arquivos estáticos de handoff por espaço de trabalho.

Os cinco passos

1. Seu espaço de trabalho

Um espaço de trabalho é a sua área isolada na plataforma. Ele carrega o seu nome, um slug curto e a sua identidade visual. Tudo o que seus usuários fazem — conversas, histórico, contas conectadas — fica dentro do seu espaço de trabalho e nunca é visível para nenhum outro. Um proprietário da plataforma pode criá-lo em Console → Plataforma → Workspaces ou pelo MCP de gerenciamento do Busymate AI; o administrador convidado conclui a Integração sem handoff para um operador.

2. Seu domínio

Seu assistente é servido em um domínio que você escolhe, mapeado para o seu espaço de trabalho:

Para começar, cada espaço de trabalho recebe seu próprio host <workspace-slug>.busymate.ai.
Seu próprio domínio (por exemplo assistant.seudominio.com) assim que você o apontar para a plataforma e ele for verificado. A partir daí, seus usuários só veem o seu domínio.

Por baixo, cada domínio resolve para exatamente um espaço de trabalho. Um domínio que ainda não mapeamos fica neutro e sem marca — a sua marca aparece apenas quando o domínio é verificado e ativado, então nunca há uma janela meio-brandada na frente dos seus usuários.

3. A identidade dos seus usuários

Decida como seus usuários são conhecidos pelo assistente:

Autenticados como eles mesmos — você conecta o seu próprio login, e cada usuário chega ao seu parceiro como ele mesmo, para o seu parceiro poder agir sobre os dados dele (e só os dele).
Convidados anônimos — se preferir deixar qualquer pessoa conversar sem login, você pode ativar o modo convidado. Convidados recebem respostas e orientação, mas não ações sobre os dados privados de um usuário específico.

Você pode oferecer os dois: convidados na porta de entrada, sessões identificadas para usuários autenticados.

4. Suas ferramentas (opcional)

Se você quer que o seu parceiro faça coisas — não só responda — conecte o seu próprio servidor MCP. É assim que o seu parceiro lê e altera os dados dos seus usuários pela sua API, sob as suas regras. Isso é opcional: um assistente de conhecimento e respostas não precisa de ferramenta alguma. Veja Conectando suas ferramentas.

5. Publicar

Quando marca, domínio, identidade e (opcionalmente) ferramentas estiverem prontos, execute o preflight e publique pelo console. A alteração é preparada, validada e só então ativada. Um contrato de identidade incompleto, um conector inacessível ou uma política de ferramentas insegura bloqueia a publicação com um resultado acionável.

Incorporando o seu parceiro no seu próprio site

Além da página hospedada, você pode incorporar o seu parceiro diretamente no seu produto — um painel lateral ou um balão de chat nas suas próprias páginas. O embed roda na origem do seu site (que adicionamos à allowlist do seu espaço de trabalho), então o assistente vive exatamente onde seus usuários já estão, ainda totalmente com a sua marca. É uma única tag de script:

html

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

Página hospedada, embed, ou os dois — a decisão é sua, e você pode adicionar o embed depois sem refazer nada.

O que preparar

O nome do produto e os materiais de marca (logo, cores, uma mensagem curta de boas-vindas).
O domínio desejado (um subdomínio para começar, ou o seu próprio domínio para verificar).
Como seus usuários fazem login — ou se você quer acesso de convidados.
Opcionalmente, a URL do seu servidor MCP, se quiser que o seu parceiro execute ações.

A seguir

A experiência do assistente — o que seus usuários veem quando você está no ar.
Governança e política de modelos — ative recursos e defina a política de modelos.
Conectando suas ferramentas — deixe o seu parceiro agir sobre os dados dos seus usuários.