Chat Pilot Documentation

Documentação do Chat Pilot

Documentação do poderoso assistente de IA concebida para o ajudar a configurar, personalizar e gerir o Chat Pilot com facilidade na sua loja Shopify.

Guia de Introdução e Configuração

Bem-vindo ao Chat Pilot

Quando abrir a aplicação pela primeira vez, verá o ecrã de inicialização. É aqui que começa a sua viagem com o assistente de compras com IA.

Como proceder:

  1. Reveja os detalhes do ecrã inicial.
  2. Clique no botão Começar na parte inferior da janela modal para iniciar a configuração.

Sincronize os seus produtos

Para garantir que o seu agente de IA consegue responder com precisão às questões dos clientes, apresentar coleções e recomendar produtos durante a conversa, ele precisa de compreender o stock da sua loja.

Como proceder:

  1. Clique no botão Sincronizar produtos destacado no centro.
  2. Aguarde alguns instantes enquanto a aplicação importa de forma segura o seu catálogo da Shopify.
  3. Assim que o estado da sincronização for atualizado, clique em Continuar para passar ao próximo passo.

Personalize a sua janela de chat

Adapte o aspeto, o estilo e o tom do seu widget de chat à identidade da sua marca. As alterações efetuadas aqui serão refletidas de imediato na sua loja.

Opções de configuração:

  • Nome do bot: Dê à sua IA uma personalidade distinta (ex: Assistente de IA, Guia da Loja ou o nome personalizado da sua marca).
  • Mensagem de boas-vindas: Escreva uma frase inicial apelativa para saudar os clientes quando clicarem no ícone de chat (ex: Olá! Como posso ajudar hoje?).
  • Cor da marca: Introduza o código HEX da cor principal da sua marca (ex: #1D4ED8) para colorir o cabeçalho do widget e as principais chamadas para ação.
  • Cor de fundo: Escolha uma cor de fundo simples para o layout principal da bolha de chat (o padrão é #FFFFFF).

Como proceder:

  1. Preencha todos os campos de identidade da marca.
  2. Clique em Guardar e continuar.

Adicionar uma página de informações da loja

Forneça ao seu agente de IA contexto imediato sobre as regras de funcionamento da sua loja, os prazos de envio e os procedimentos padrão, através da ligação de uma URL com informações essenciais.

Como proceder:

  1. Localize a caixa de introdução URL da página web.
  2. Cole um link para uma das páginas de políticas ativas da sua loja (por exemplo, https://yourstore.com/policies/returns, uma página de perguntas frequentes ou uma página Sobre Nós).
  3. Clique em Adicionar e continuar.
    (Nota: Pode facilmente adicionar mais fontes de base de conhecimento mais tarde, diretamente a partir do painel de Configuração da aplicação).

Ativar na sua montra (ativação em direto)

O passo final é tornar o widget visível aos visitantes da sua loja, ativando-o nas definições do seu tema através das Aplicações incorporadas.

Como proceder:

  1. Clique no botão azul Ativar widget de chat. Isto abrirá automaticamente o editor do tema ativo da sua loja Shopify numa nova aba do navegador.
  2. O editor de temas abrirá com o Chat Pilot pré-selecionado no separador Aplicações incorporadas na barra lateral esquerda.
  3. Ative o botão, depois clique em Guardar no canto superior direito do editor de temas da sua loja Shopify.
  4. Volte ao painel do Chat Pilot — o seu assistente de IA está agora oficialmente ativo!

Chat Pilot – Documentação da Funcionalidade e Guia do Utilizador

Visão Geral do Painel

O Painel serve como o seu centro de controlo principal. Fornece-lhe uma visão imediata do desempenho principal do seu agente de IA nos últimos 30 dias e acompanha o progresso da sua lista de verificação.

Principais métricas acompanhadas:

  • Conversas: O número total de interações com clientes geridas pela IA.
  • Mensagens: A troca cumulativa de mensagens individuais dentro desses chats.
  • Intenções iniciadas: O número total de vezes que a IA reconheceu com sucesso um objetivo específico do cliente (ex: rastrear uma encomenda ou perguntar sobre devoluções).

A partir daqui, pode acompanhar os passos de configuração concluídos, monitorizar conversas recentes em curso num relance, ou clicar em Ver chat ao vivo / Editar agente para fazer ajustes operacionais rápidos.

Configuração e Treino do Chatbot

O painel de Configuração é onde treina a sua IA e define como ela interage com os clientes. Garante que o seu assistente responde com precisão utilizando os dados exclusivos da sua marca.

Funcionalidades e Definições:

  • Estado do Treino da IA: Visualize uma barra de estado em tempo real que mostra o progresso da sincronização do conhecimento.
  • Base de Conhecimento: Gere as URLs e os recursos que a sua IA lê. Clique em + Adicionar Fonte para indexar páginas web adicionais (como perguntas frequentes personalizadas, links de blogue ou páginas de políticas).
  • Fluxos Automatizados: Ative ou desative facilmente fluxos de trabalho pré-construídos para clientes.Seguir Encomenda: Obtém o estado de processamento em tempo real diretamente da Shopify.Política de Devoluções / Troca de Artigos: Guia os clientes de forma fluida através de devoluções ou trocas de produtos, de acordo com as suas diretrizes.

A. Rastejamento de página web

Utilize esta opção para treinar a sua IA com um único layout web ativo (como tabelas de envio personalizadas, tabelas de tamanhos padrão ou páginas de destino dinâmicas e independentes).

Como adicionar uma fonte de página web:

  1. Abra o painel de Configuração e clique no botão + Adicionar fonte.
  2. Selecione a opção Uma página web no topo da janela modal.
  3. Cole o caminho exato da URL absoluta no campo URL da página web (ex: https://yourstore.com/pages/returns).
  4. (Opcional) Adicione um rótulo identificável no campo Nome de exibição para acompanhar facilmente este recurso nos registos de administração.
  5. Clique em Adicionar nova fonte para iniciar o rastreamento em segundo plano do sistema.

B. Carregamento de ficheiros PDF

Se a sua loja utiliza documentos estáticos — como manuais de produtos para revenda, lookbooks da marca, fichas técnicas ou documentos de políticas detalhados e com muito texto —, pode carregá-los diretamente.

Como adicionar uma fonte PDF:

  1. No menu de seleção modal, mude para a opção PDF.
  2. Clique na área de arrastar e largar de ficheiro PDF com o rótulo "Clique para escolher um PDF".
  3. Selecione e carregue o ficheiro .pdf pretendido (certifique-se de que o documento está carregado no diretório de Ficheiros da sua Shopify para uma leitura contínua dos dados).
  4. Forneça um título descritivo no campo Nome de exibição para que possa gerir ou eliminar o documento posteriormente.
  5. Clique em Adicionar nova fonte para compilar as informações do documento no motor central da IA.

C. Pares de perguntas e respostas manuais (estilo FAQ)

Para perguntas específicas e previsíveis dos clientes que exijam respostas exatas da marca (por exemplo, códigos de desconto precisos, slogans da marca ou horários personalizados da loja), utilize blocos estruturados de perguntas e respostas.

Como criar pares de perguntas e respostas manuais:

  1. Selecione o separador estilo FAQ dentro do layout da janela modal de origem.
  2. Dê à sua coleção um nome de categoria claro no campo de entrada Nome de exibição (por exemplo, FAQ de envios).
  3. Por baixo do bloco PAR 1, escreva a pergunta esperada do visitante no campo de texto PERGUNTA.
  4. Redija a política de resposta exata que pretende que o agente de IA declare palavra por palavra no campo RESPOSTA.
  5. Para criar várias respostas de uma só vez, clique no link + Adicionar par de P&R na parte inferior para abrir um novo bloco de par em branco.
  6. Assim que terminar de criar a sua base de dados de perguntas, clique em Adicionar nova origem para as publicar.

Gestão do Catálogo de Produtos

O separador Produtos apresenta a sua base de dados de stock da Shopify totalmente integrada, permitindo-lhe controlar que produtos o seu agente de IA recomenda aos clientes durante a conversa.

Métricas de desempenho do catálogo:

  • Total de produtos: O total de produtos ativos atualmente disponíveis na Shopify.
  • Indexados: Artigos totalmente analisados, compreendidos e prontos para recomendações de pesquisa por IA.
  • Sem stock: Produtos que são automaticamente excluídos das recomendações para evitar experiências negativas aos clientes.
  • Fixados / Excluídos: Sobrescritas personalizadas do comerciante para destacar ou ocultar produtos manualmente.

Ações em massa:

  • Utilize Selecionar produtos para selecionar manualmente os artigos.
  • Utilize Importar tudo para iniciar uma sincronização manual do seu catálogo de produtos a qualquer momento.

Aparência Avançada do Widget

Ajuste o design visual e o layout precisos da caixa de chat visível aos clientes no painel Aparência.

Ferramentas de personalização:

  • Identidade do bot: Atualize o nome oficial do seu bot e a sua mensagem de boas-vindas exclusiva.
  • Definições de cor: Defina códigos hexadecimais personalizados para a sua Cor principal da marca e para o Fundo do widget.
  • Tipografia: Altere as famílias de fontes (ex: Inter) e os tamanhos de fonte base (14 px) para corresponder ao design do tema da sua loja.
  • Pré-visualização em tempo real: Um elemento de maquete dinâmico no lado direito é atualizado em tempo real à medida que altera as configurações, mostrando exatamente o que os clientes verão antes de guardar.

Caixa de entrada do chat ao vivo e assistências de apoio

O separador Caixa de entrada permite-lhe ter uma visão direta das interações em tempo real com os clientes. Permite que os colaboradores de apoio humano monitorizem as conversas ou assumam o controlo quando for necessário um toque pessoal.

Principais funcionalidades da Caixa de entrada:

  • Perfil do agente: Clique em Editar perfil do agente para definir um apelido público amigável para os agentes de apoio humano.
  • Filtros de estado da conversa: Filtre rapidamente os pedidos de apoio por estado: Aberto, Pendente, Resolvido, Fechado ou Não lido.
  • Barra lateral do chat em tempo real: Visualize os tópicos ativos dos clientes com etiquetas que correspondem às categorias de intenção (ex: Seguimento de encomenda, Desconto de preços), juntamente com o acompanhamento do tempo decorrido desde a última mensagem.

Detalhes do tópico e intervenção humana

1. Selecione um tópico ativo

Na coluna de conversas, escolha qualquer sessão marcada com uma etiqueta de estado ativo (ex: Aberto). Ao clicar numa sessão, a janela principal do espaço de trabalho à direita é instantaneamente preenchida com a transcrição completa das mensagens.

2. Reveja as etiquetas de intenção da IA contextuais

Os registos de chat organizam claramente os detalhes da conversa, apresentando as marcas temporais exatas e as etiquetas contextuais (como Seguimento de Encomenda ou Desconto de Preço) que identificam o assunto sobre o qual o cliente está a perguntar antes de responder.

3. Utilize a caixa de resposta manual

Na parte inferior da janela de conversa encontra-se o bloco de texto Responder como:

  • Escreva a sua resposta pessoal ou solução personalizada no campo.
  • Pressione Ctrl + Enter (ou Cmd + Enter no Mac) para enviar instantaneamente a sua mensagem para o widget da loja.

⚠️ Nota importante sobre o comportamento da IA: O envio de uma resposta de texto manual pausa automaticamente o agente de IA para esse tópico específico do cliente. Isto garante que o bot automatizado não interrompe nem substitui o fluxo da sua conversa humana.

4. Resolver e fechar tickets

Depois de ter respondido totalmente à pergunta do cliente, utilize as ações de gestão no canto superior direito:

  • Clique em Resolver ou Fechar para arquivar a sessão e retirá-la da sua fila ativa de mensagens não lidas do painel.
  • Clique no ícone Atualizar/Repor para limpar as variáveis locais da sessão, se necessário.

Análise e Relatórios

O espaço de trabalho Análises e Relatórios monitoriza dados de conversão, tendências de desempenho e vetores de sentimento dos clientes.

Análise detalhada:

  • Exportação de dados: Clique em Exportar dados no canto superior direito para descarregar métricas detalhadas de conversas e intenções num ficheiro Excel ou CSV.
  • Tendências de chat ao longo do tempo: Um gráfico de linha temporal visual que monitoriza as quebras e picos do envolvimento total dos clientes em filtros personalizados de 30 dias.
  • Principais questões dos clientes: Uma barra de percentagem de dados que detalha exatamente o que os seus clientes mais valorizam (ex.: Dúvidas sobre produtos, Seguimento de encomendas, Descontos de preços).

Definições da conta

A vista Definições permite-lhe gerir os níveis de faturação, os dados de integração e as reposições do sistema em segurança.

Secções do painel:

  • Informações da conta: Consulte o identificador do domínio principal da sua loja e registe um endereço de e-mail dedicado para o apoio ao cliente.
  • Nível do plano: Acompanhe os seus limites de volume (ex: Plano Gratuito – Até 100 conversas por mês). Clique em Gerir plano para aumentar os seus limites de volume.
  • Integrações: Confirme as ligações ativas à API da Shopify ou ative o Transferência por e-mail para encaminhar automaticamente situações complexas que exijam intervenção para uma caixa de entrada de apoio partilhada.
  • Zona de perigo: Aceda à ferramenta Repor integração para eliminar as variáveis de configuração locais e reiniciar o assistente de configuração inicial da aplicação, passo a passo, do zero.

Centro Integrado de Ajuda e Suporte

O separador centralizado Ajuda e Suporte serve como um centro de referência de acesso rápido, direcionando-o diretamente para painéis de controlo específicos do backend para resolver problemas instantaneamente.

Mapa de navegação para configuração rápida:

  1. Instalar e ligar a loja: Verificação da sua ligação automática principal com a Shopify.
  2. Configurar o seu agente de IA: Botão de acesso direto ao portal para o painel de Configuração.
  3. Importar o seu catálogo de produtos: Acesso direto à sua grelha de produtos indexados (Ir para Produtos).
  4. Personalizar o widget de chat: Acesso instantâneo à tipografia e à paleta de cores da marca (Ir para Aparência).
  5. Ativar o widget no seu tema: Link de acesso direto de volta ao layout principal de ativação (Ir para Painel de Controlo).
  6. Monitorizar conversas e análises: Abrir instantaneamente a fila de respostas de chat ao vivo (Ir para Caixa de Entrada).