Documentação · início rápido

Do zero ao widget publicado.

Configure a hierarquia, o modelo, o conhecimento e a experiência antes de instalar uma única tag no seu site.

01

Entrar na sua conta

Cadastro temporariamente indisponível

O que preencher

Faça login e confirme que o dashboard abre no próprio domínio widport.com.

Abrir configuração →
02

Criar organização, projeto, ambiente e namespace

Essa hierarquia define propriedade e isolamento. Crie nesta ordem: Organização (empresa ou time) → Projeto (site/produto) → Ambiente (production, staging ou development) → Namespace (base de conhecimento do widget).

O que preencher

Use nomes estáveis. Exemplo: Aletheion-Eco → Website → production → suporte. Aguarde o status ready; se aparecer partial_failure, use Reconciliar na organização antes de continuar.

Abrir configuração →
03

BYOK ou Managed AI

Managed AI

Não é necessário conectar uma chave própria de modelo. Siga para a criação do deployment.

BYOK

Escolha o ambiente, mantenha DeepSeek como padrão ou selecione outro provedor, cole a API key e use Testar conexão. O status deve ficar active/ready.

Custos do provedor são separados. Nunca coloque a chave no HTML do site.

Configurar BYOK →
04

Criar o deployment e autorizar domínios

O deployment produz a chave pública usada pelo widget e limita quais sites podem chamar a API.

O que preencher

Escolha o namespace, dê um nome e informe origens completas, incluindo https:// e sem caminhos. Separe várias origens por vírgula, ponto e vírgula ou quebra de linha: https://example.com, https://www.example.com.

Abrir configuração →
05

Ativar o roteamento automático

O IntentParse primeiro escolhe o domínio e depois executa o schema especializado. O cliente não precisa decidir o schema.

O que preencher

Abra Schemas e mantenha Automático (recomendado). Fixe um schema somente quando quiser um override avançado para um deployment dedicado.

Abrir configuração →
06

Adicionar conhecimento

Cadastre conteúdo que o widget tem autorização para usar: documentação, FAQ, políticas e instruções revisadas.

O que preencher

Em Fontes de conhecimento, escolha o namespace, informe nome, URL HTTPS de procedência, idioma, classificação e cole o conteúdo aprovado.

Abrir configuração →
07

Escanear, revisar e publicar

Salvar uma fonte não a torna evidência automaticamente. O scan normaliza e gera um candidato; a revisão humana decide o que chega ao GQueries.

O que preencher

Execute o scan, abra a Fila de revisão e escolha Aprovar e publicar. Confirme a nova entrada em Memórias publicadas. Revogar remove a evidência do índice.

Abrir configuração →
08

Configurar a experiência

Defina aparência, capabilities, schema, políticas e atendimento humano. O widget herda claro/escuro e a cor accent do site quando o tema está em auto.

O que preencher

Revise cada aba. Mantenha require evidence ativo para respostas factuais; configure fallback/handoff e somente habilite ações que o seu backend suporta.

Abrir configuração →
09

Instalar o widget

Copie a tag antes do fechamento de </body> em todas as páginas onde o Widport deve aparecer.

O que preencher

Troque wp_pub_your_deployment_key pela chave pública mostrada em Deployments. Ajuste data-locale e data-position; nunca coloque uma chave BYOK no HTML. O botão fechado pode vibrar visualmente por 3 segundos a cada 10 segundos visíveis. Use data-attention="off" para desativar no site, ou o controle no widget para desativar neste navegador. Movimento reduzido sempre desativa a animação.

<script
  src="https://cdn.widport.com/v1/widget.js?v=1.5.1"
  data-project="wp_pub_your_deployment_key"
  data-locale="pt-BR"
  data-position="bottom-right">
</script>
Abrir configuração →
10

Testar ponta a ponta

Abra seu site em uma origem autorizada e faça perguntas cobertas e não cobertas pelo conhecimento publicado.

O que preencher

Uma resposta coberta deve mostrar evidências. Uma pergunta sem evidência deve esclarecer ou oferecer atendimento humano. Acompanhe os eventos em Jornadas e Uso.

Abrir configuração →