Wego Assistant

Configuração #

Esta seção é para donos e gestores de conteúdo — não precisa saber programar. A Helena, por exemplo, é dona de um salão de beleza e configurou o assistente inteiro pelo painel, sem ajuda de TI.

O que é o Wego Assistant #

O Wego Assistant é um assistente de IA que você instala no seu site como um chat. Ele responde às dúvidas dos seus clientes com base na sua informação — a sua base de conhecimento — e cita a fonte. Não inventa.

Funciona como um widget embarcável (uma "bolha" de chat no canto da página) e também por API, para integrações avançadas.

Criar conta e entrar #

1. 1 Acesse app.wegoassistant.com.br e clique em Criar conta.
2. 2 Informe seu e-mail e uma senha. Você recebe um e-mail de verificação — confirme para ativar.
3. 3 Faça login. Na primeira entrada você ganha um saldo de cortesia para testar (trial).

Criar seu primeiro app #

Um app é cada assistente que você publica. Você pode ter vários — um por site, marca ou finalidade.

1. 1 No painel, vá em Apps → Criar app.
2. 2 Dê um nome (ex.: "Atendimento Loja X").
3. 3 Ao abrir o app, um guia de ativação flutuante mostra os passos que ainda faltam.

Montar a base de conhecimento #

A base de conhecimento é o que o assistente "sabe". Quanto melhor a base, melhores as respostas.

1. 1 Na aba Conhecimento, crie uma base e adicione documentos (cole texto ou suba arquivos).
2. 2 Aguarde o processamento — o status vai de Processando para Pronto.
3. 3 O painel mostra um score de qualidade. Mire 70% ou mais — abaixo disso o assistente tem lacunas.

Dicas de qualidade #

• Escreva em linguagem direta, como você responderia a um cliente.
• Um assunto por trecho: horários, preços, políticas, trocas, etc.
• Inclua os detalhes que mais perguntam: formas de pagamento, prazos, exceções.
• Evite ambiguidade — "a partir de R$ X" é mais útil que "varia".

Personalizar o assistente #

Na aba Configuração você ajusta o comportamento:

• Nome da persona — o nome do assistente. Esse campo alimenta diretamente a saudação do chat: o visitante vê "Olá! Eu sou a Aurora, como posso te ajudar hoje?" (substituindo pelo nome que você definiu). Se ficar em branco, o assistente usa um nome genérico.
• Instruções do assistente — orientações de tom e regras específicas (ex.: "Seja formal", "Sempre ofereça agendamento ao final"). Complementa o comportamento padrão.
• Idioma principal — idioma das respostas (padrão: português do Brasil).
• Mensagem de fallback — o que dizer quando o assistente não consegue responder.
• Perguntas sugeridas — atalhos que aparecem no chat para guiar o cliente.

Conversa e privacidade #

No card Memória e privacidade (aba Configuração) você controla como a conversa é armazenada e se o visitante precisa consentir antes de começar.

Modo de memória #

• Contínua (padrão) — o assistente lembra o contexto da conversa. A sessão fica ativa por até 30 minutos de inatividade; ao recarregar a página dentro desse período o histórico reaparece. Ideal para atendimento em que perguntas de acompanhamento fazem sentido ("e o prazo?", "pode repetir?").
• Resposta única — cada mensagem é tratada de forma independente, sem memória de perguntas anteriores. Ideal para FAQs de alto volume onde a privacidade do histórico importa mais do que o contexto da conversa.

Consentimento (LGPD) #

Quando o toggle Exigir consentimento está ligado, o widget exibe um aviso antes do primeiro envio — o texto do aviso é configurável no painel. Só após aceitar o visitante pode conversar e o histórico passa a ser armazenado no navegador. Use quando sua política de privacidade ou o DPO exigir consentimento explícito antes do tratamento de dados de conversa.

Contagem de inatividade #

O widget exibe discretamente o status da sessão. Quando a inatividade se aproxima do limite (nos últimos ~5 minutos), o indicador muda para "Expira em M:SS". Cada nova mensagem reseta a contagem — isso mantém o visitante informado sem interromper o fluxo da conversa.

Aparência do widget #

Ainda em Configuração → Aparência:

• Cor primária — a cor do launcher e dos destaques.
• Posição — inferior direito ou inferior esquerdo.
• Texto do launcher — ex.: "Posso ajudar?".
• Tema — claro, escuro ou automático (segue o sistema do visitante).

Testar no Playground #

Na aba Playground, converse com o assistente exatamente como o cliente verá — antes de publicar.

• Faça perguntas que estão na base — o assistente deve responder e citar a fonte.
• Faça uma pergunta que não está na base — ele deve admitir que não tem a informação, sem inventar.

Saldo, créditos e preços #

• Trial — você começa com um saldo de cortesia para experimentar.
• Uso — cada mensagem respondida custa R$ 0,015.
• Conhecimento — a 1ª base é gratuita; bases adicionais consomem saldo.
• Recarga — adicione créditos por Pix ou cartão na aba de carteira/assinatura.

O saldo atual aparece na barra superior do painel.

Integração #

Esta seção é para desenvolvedores — o Rafael que integra o widget no site da Helena, por exemplo. Pressupõe conhecimento de HTML e JavaScript básico.

Instalação do widget #

Cole este trecho antes do fechamento do </body> do seu site:

<script src="https://widget.wegoassistant.com.br/widget.js"
        data-public-key="wpk_live_sua_chave_publica"
        data-app="seu-app"
        async></script>

• data-public-key obrigatório — a sua chave pública (começa com wpk_live_). É pública por natureza — pode ficar no HTML. Nunca exponha um secret aqui.
• data-app obrigatório — o identificador do app.

Atributos opcionais #

API programática — window.wego(...) #

O snippet expõe uma função global wego(ação, parâmetros) para controlar o widget por JavaScript:

wego('open');                 // abre o chat
wego('close');                // fecha o chat
wego('setContext', { context: { page: '/precos', locale: 'pt-BR' } });
wego('identify', { user: { signed_jwt: '<JWT_DO_SEU_BACKEND>', ref: 'cliente-123' } });

Identidade do usuário final (identify) #

Para personalizar por usuário logado do seu site, passe um JWT assinado pelo seu backend (HMAC-SHA256) em signed_jwt:

// Chame assim que tiver o JWT do seu backend
wego('identify', {
  user: {
    signed_jwt: 'eyJ...',  // gerado server-side, HMAC-SHA256
    ref: 'id-interno-do-usuario'
  }
});

• É um token assinado, não um secret — gerado server-side e entregue ao front.
• Permite cenários autenticados (o assistente sabe quem é o usuário).

Tema por código (override) #

Além da configuração no painel, o host pode sobrescrever a aparência na inicialização. Útil para combinar o widget com a identidade da página onde ele está embarcado:

• Cor primária e cor/ícone do launcher
• Logo, nome do assistente
• Posição, raio das bordas, tema claro/escuro

Analytics #

Eventos do widget são repassados ao window.dataLayer (se existir) com o prefixo wego:. Exemplos:

Plugue esses eventos direto no seu GTM/GA sem alteração de código.

Segurança e boas práticas #

• A chave pública (wpk_live_) não é secret — ela só abre sessão a partir da origem autorizada.
• Configure as origens permitidas do app (domínios onde o widget pode rodar).
• O widget roda em iframe com sandbox e nunca usa postMessage com origem *.
• Residência de dados no Brasil em conformidade com a LGPD.

Ferramentas — o assistente consulta seus sistemas #

O assistente pode chamar uma API sua (GET ou POST) em tempo real para buscar um dado vivo — por exemplo, o status de um pedido — e incluir o resultado na resposta ao visitante. O modelo decide quando acionar a ferramenta com base na descrição que você cadastra.

Como cadastrar #

App → aba Ferramentas → Nova ferramenta. Preencha os campos:

Salve e ative a ferramenta. Ela passa a estar disponível ao assistente nas conversas desse app.

Webhooks — avise seu sistema quando algo acontece #

Webhooks permitem que o Wego Assistant notifique o seu backend sobre eventos do assistente em tempo real.

Evento disponível hoje: conversation.handoff — disparado quando o assistente detecta que precisa passar o atendimento para um humano.

Como configurar #

1. 1 App → aba Webhooks → Novo webhook.
2. 2 Informe a URL https de destino. Rede interna e localhost são recusados.
3. 3 Clique em Criar. O painel exibe o signing secret uma única vez — guarde-o agora em lugar seguro.

Validar a assinatura no seu backend #

Cada POST vem com dois headers para autenticação e deduplificação:

Exemplo de validação em Node.js:

// rawBody: Buffer com o corpo bruto da requisição (não parsear antes)
// signature: valor do header X-Wego-Signature
// secret: o signing secret guardado no cadastro
function isValid(rawBody, signature, secret) {
  const expected = 'sha256=' + require('crypto')
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return require('crypto').timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signature)
  );
}

Perguntas frequentes #

As dúvidas mais comuns de quem está conhecendo o Wego Assistant.