Este artigo reúne respostas rápidas às dúvidas mais comuns sobre a instalação, configuração, funcionamento e solução de problemas da Brilliant.
Instalação e acesso
-
Como instalo a Brilliant na minha loja?
Você pode instalar a Brilliant pela Shopify App Store.
-
Onde posso instalar a Brilliant?
Você pode instalar a Brilliant em qualquer loja que use a plataforma Shopify.
-
Quais permissões o app solicita durante a instalação?
A Brilliant solicita apenas as permissões necessárias para analisar seu catálogo e oferecer recomendações precisas:
-
read_inventory: para ler o estoque dos seus produtos. -
read_locales: para saber quais idiomas estão disponíveis na sua loja. -
read_publications: para ver onde os produtos estão publicados (canais). -
read_translations: para ver as traduções dos produtos. -
read_themes: para ler o status de ativação da Brilliant no tema atual. -
read_content: para ler os blogs e as páginas da sua loja e usá-los como base de conhecimento do assistente. -
read_online_store_navigation: para entender como seus produtos são organizados e categorizados na navegação da sua loja. -
read_orders: para que o assistente possa responder aos seus clientes sobre o status e o rastreamento dos pedidos. -
write_markets: para adicionar metadados aos mercados. -
write_products: para adicionar metadados aos produtos. -
write_metaobject_definitions: para criar definições de metaobjetos. -
write_metaobjects: para criar ou editar os metaobjetos necessários para a Brilliant.
-
-
Por que a Brilliant me pede para aprovar novas permissões se eu já tinha o app instalado?
Alguns recursos novos, como a sincronização de blogs e páginas ou a consulta de pedidos, exigem permissões adicionais.
Se você instalou a Brilliant antes de esses recursos estarem disponíveis, verá um aviso no painel com as novas permissões solicitadas e sua finalidade.
Clique em Continuar na Shopify para acessar a Shopify, revisar as permissões e aceitá-las. Até que você as aprove, os recursos que dependem delas não estarão disponíveis.
-
Como sei se a instalação foi concluída corretamente?
Ao finalizar o processo na Shopify, você acessará o painel de controle da Brilliant, onde um assistente de boas-vindas orientará você durante os primeiros passos.
Primeiro, você deverá ativar a Brilliant Control Center no tema da sua loja.
-
Como ativo a Brilliant no meu tema da Shopify?
No assistente de boas-vindas, clique em Ativar na Shopify. Você acessará o editor de temas com a Brilliant Control Center ativada.
Clique em Salvar e volte para a Brilliant para continuar a instalação.
Essa configuração só é necessária uma vez e permite que o assistente seja exibido na sua loja. Seus clientes não verão a Brilliant até que você a ative no painel.
-
Como sei que minha loja está pronta?
Depois que a Brilliant Control Center for ativada no tema, a Brilliant começará a importar e processar automaticamente seu catálogo
Em Início, você verá a mensagem "Estamos preparando sua loja" e uma barra com o progresso dos produtos processados.
Quando o processamento for concluído, aparecerá a mensagem "A Brilliant já está pronta para ser ativada na sua loja!" e você poderá clicar em Ativar a Brilliant.
-
Posso testar a Brilliant antes que meus clientes a vejam?
Sim. Em Início, clique em Visualização para abrir sua loja e testar o assistente.
Durante a visualização, somente você poderá ver a Brilliant. Seus clientes não a verão até que você a ative.
A visualização estará disponível quando o catálogo terminar de ser processado e exige que a Brilliant esteja ativa no tema da Shopify.
-
Como ativo ou desativo a Brilliant na minha loja?
Em Início, use Ativar a Brilliant ou Desativar a Brilliant.
Se você a desativar, o assistente deixará de ser exibido na sua loja, mas toda a configuração será mantida e você poderá ativá-lo novamente quando quiser.
-
Posso usar a Brilliant em várias lojas?
Sim, você pode instalar a Brilliant em todas as lojas da Shopify que gerenciar de forma independente.
Idiomas, mercados e moedas
-
Preciso criar um agente para cada idioma e moeda?
Não. A Brilliant funciona de forma unificada para toda a sua loja, portanto você não precisa criar agentes independentes para cada combinação de idioma e moeda.
A configuração de design, habilidades, treinamento e gerenciamento de produtos é feita uma única vez e aplicada a toda a loja.
-
Em quais mercados a Brilliant é exibida?
A Brilliant detecta automaticamente os mercados configurados na Shopify e é exibida em todos os mercados ativos.
Se você criar, modificar ou excluir um mercado na Shopify, a Brilliant será atualizada automaticamente.
-
Em qual idioma a Brilliant responde aos meus clientes?
A Brilliant adapta suas respostas ao idioma de cada cliente e usa as traduções dos produtos configuradas na Shopify.
Se você adicionar ou excluir idiomas na sua loja, a Brilliant os detectará automaticamente.
-
A Brilliant exibe os preços na moeda de cada mercado?
Sim. A Brilliant exibe os produtos e seus preços na moeda correspondente ao mercado pelo qual cada cliente está navegando.
-
Preciso configurar a Brilliant em cada idioma?
Não. Você pode concluir o treinamento da Brilliant no seu idioma.
O assistente adaptará suas respostas ao idioma de cada conversa, portanto você não precisa adicionar o mesmo conteúdo em vários idiomas.
Catálogo e gerenciamento de produtos
-
Quanto tempo a Brilliant leva para processar o catálogo?
O processamento inicial pela Brilliant pode levar de alguns minutos a várias horas, dependendo do tamanho do seu catálogo.
Você pode acompanhar o progresso em Início.
-
O que a Brilliant faz com meu catálogo durante o processamento?
A Brilliant importa seus produtos da Shopify e os enriquece usando inteligência artificial.
Durante esse processo, ela categoriza os produtos, gera descrições e destaques, prepara perguntas frequentes, identifica produtos nas imagens e calcula kits e combinações. Ela também gera sugestões de busca com base no seu catálogo.
-
O que acontece se eu adicionar, modificar ou excluir produtos na Shopify?
A Brilliant é sincronizada automaticamente com o catálogo da Shopify.
Os novos produtos, as modificações e as exclusões serão refletidos na Brilliant sem que você precise importar o catálogo novamente.
-
Quais produtos a Brilliant exibe?
A Brilliant exibe apenas os produtos ativos e publicados na sua loja virtual.
Você também pode excluir determinados produtos usando a lista de bloqueio.
-
Posso editar a taxonomia (estrutura do catálogo) criada automaticamente pela IA?
Sim. Em "Configurações > Estrutura do catálogo", você pode modificar os nomes das categorias e as etiquetas dos atributos, como cor ou tamanho.
-
Posso indicar as novidades do meu catálogo?
Sim. Em "Configurações > Estrutura do catálogo", você pode adicionar as etiquetas da Shopify que identificam seus novos produtos.
Os produtos que contiverem alguma dessas etiquetas serão exibidos na tela inicial da Brilliant.
-
Posso destacar produtos do meu catálogo?
Sim. Em "Configurações > Estrutura do catálogo", você pode adicionar as etiquetas dos produtos que deseja destacar.
Os produtos que contiverem alguma dessas etiquetas aparecerão na primeira posição dos resultados de busca.
-
Posso excluir produtos do meu catálogo?
Sim. Em "Configurações > Estrutura do catálogo", você pode adicionar à lista de bloqueio as etiquetas dos produtos que deseja excluir da Brilliant.
Os produtos com essas etiquetas não aparecerão nas buscas nem nas recomendações, e a Brilliant também não poderá interagir com eles na sua loja.
-
Posso usar meus metacampos (metafields) da Shopify?
Sim. A Brilliant usa automaticamente as informações básicas dos seus produtos, como título ou descrição.
Além disso, em "Treine sua IA > Metadados", você pode selecionar os metacampos adicionais que a Brilliant levará em conta para melhorar suas respostas e recomendações.
Somente os tipos de metacampos compatíveis serão exibidos.
Treine sua IA
-
Como posso ensinar informações sobre minha loja à Brilliant?
Em "Treine sua IA > Base de conhecimento", você pode adicionar informações que a Brilliant usará para responder aos seus clientes, como políticas de envio e devolução, guias de tamanhos ou perguntas frequentes.
Você pode adicionar:
- Textos: informações escritas diretamente no painel.
- URLs: páginas da web cujo conteúdo será analisado pela Brilliant. Você pode configurar uma nova varredura diária, semanal ou desativá-la.
- Arquivos: documentos TXT, DOCX, MD ou PDF de até 5 MB.
Você pode adicionar até cinco conteúdos de cada tipo. As alterações podem levar alguns minutos para aparecer no assistente.
-
A Brilliant pode usar os blogs e as páginas da minha loja da Shopify?
Sim. Nas abas Blogs e Páginas da base de conhecimento, você pode selecionar até 50 artigos de blog e 50 páginas da sua loja
A Brilliant sincronizará automaticamente esses conteúdos para usá-los nas respostas.
-
O que significa quando um conteúdo da base de conhecimento apresenta o status “Erro”?
Significa que a Brilliant não conseguiu processá-lo. Isso pode acontecer, por exemplo, se uma URL não existir mais, exigir login ou apontar para um arquivo que a Brilliant não consiga ler, como uma imagem ou um vídeo.
Passe o cursor sobre o status para consultar o motivo do erro. Depois, você pode corrigir a entrada ou usar Tentar processar novamente.
-
Posso definir como a Brilliant se comporta e responde?
Sim. Em "Treine sua IA > Comportamento", você pode configurar:
- Diretrizes: adicione até 10 instruções para definir o tom e o estilo da Brilliant, além do que ela deve ou não deve fazer.
- Estilo de resposta: selecione a extensão das respostas “concisa”, “equilibrada” ou “detalhada” e seu formato “simples”, “estruturado” ou “enriquecido”.
-
Para que serve o perfil da empresa?
Em "Treine sua IA > Perfil da empresa", você pode informar o que sua loja vende, para qual público ela é direcionada e qual é o seu setor.
Essas informações fornecem à Brilliant mais contexto sobre sua empresa e seus clientes para adaptar suas recomendações e respostas.
Habilidades e design
-
Quais habilidades a Brilliant oferece?
Em Habilidades, você pode consultar e gerenciar os recursos do assistente:
- Busca inteligente: interpreta a linguagem natural do cliente e exibe os produtos mais relevantes.
- Análise de produtos: responde a perguntas sobre as características, os materiais e os usos dos produtos.
- Produtos semelhantes: exibe alternativas semelhantes em estilo ou características.
- Produtos que combinam: recomenda produtos complementares.
- Kits de produtos: propõe combinações de produtos em kits.
- Comparação: compara vários produtos para ajudar o cliente durante a decisão.
- Buscar por imagem: permite enviar uma imagem e encontrar produtos semelhantes ou combinações.
- Produtos nas imagens do catálogo: permite selecionar elementos visíveis nas imagens dos seus produtos.
- Perguntar sobre meu pedido: permite que o cliente consulte o status, o rastreamento e os detalhes dos pedidos.
As habilidades Busca inteligente e Análise de produtos são necessárias para o funcionamento do assistente e não podem ser desativadas.
-
Posso exibir carrosséis ou perguntas sugeridas nas minhas páginas de produto?
Sim. No editor de temas da Shopify, você pode adicionar os seguintes blocos da Brilliant às suas páginas de produto:
- Carrossel de produtos semelhantes.
- Carrossel de produtos que combinam.
- Perguntas sobre o produto.
Em Habilidades , você também pode clicar em Adicionar na Shopify ou Editar na Shopify para gerenciá-los.
-
Posso alterar a posição do balão do assistente?
Sim. No editor de temas da Shopify, em Brilliant Control Center, você pode configurar a posição do balão principal, suas margens e o z-index.
Você também pode usar uma configuração diferente para dispositivos móveis, ativar uma mensagem de boas-vindas ao lado do balão e configurar o balão que aparece sobre os cards de produto.
-
Posso personalizar a aparência da Brilliant?
Sim. Em Design, você pode adaptar a Brilliant à identidade visual da sua marca configurando:
- Cores: defina sua cor primária para gerar a paleta.
- Botões: raio da borda e transformação do texto
- Logo: envie o logo da sua loja (PNG, JPG, JPEG, WebP ou SVG, de até 5 MB).
- Ícones: escolha ou envie o ícone do balão principal e do balão de produto (SVG ou PNG, de até 500 KB).
- Card de produto: proporção da imagem, forma de exibição, raio da borda e contorno.
Você pode consultar na visualização como as alterações serão exibidas nas diferentes telas do assistente. Quando você ativar a Brilliant, a fonte se adaptará automaticamente à fonte da sua loja.
Análises e conversas
-
Como posso medir o impacto da Brilliant nas minhas vendas?
Em Análises , você pode consultar métricas sobre o desempenho da Brilliant, como compras assistidas em comparação com o total da sua loja, taxa de conversão, ticket médio, ROI, funil de compras ou conversas por dispositivo.
Você também pode consultar quais elementos da Brilliant, como balões, carrosséis ou perguntas sugeridas, geram mais interação.
-
Posso conectar a Brilliant ao Google Analytics?
Sim. Em “Configurações > Google Analytics”, você pode ativar a integração e inserir seu ID do Google Analytics para medir o desempenho da Brilliant na sua loja.
-
Em qual idioma a Brilliant responde aos meus clientes?
Sim. Em Início, no card “Conversas de chat”, você pode consultar o número total de conversas, as conversas da última semana e do último dia.
Clique em Baixar chats para baixar as conversas.
-
A Brilliant exibe os preços na moeda de cada mercado?
Sim. A Brilliant exibe os produtos e seus preços na moeda correspondente ao mercado pelo qual cada cliente está navegando.
Plano e limites
-
O que meu plano inclui?
Você pode consultar o uso do seu plano em Início, no card “Uso do plano”.
Cada plano inclui um número máximo de produtos no catálogo e de conversas por mês.
-
O que acontece se eu atingir o limite de conversas?
A Brilliant deixará de ser exibida na sua loja até que o limite seja redefinido.
O contador de conversas é reiniciado automaticamente no início de cada mês. No card “Uso do plano” de Início , você pode consultar os dias restantes até a próxima redefinição.
-
O que acontece se meu catálogo ultrapassar o limite de produtos do meu plano?
A Brilliant exibirá um aviso no painel informando que sua loja precisa de um plano mais avançado.
No mesmo aviso, você poderá solicitar acesso prioritário aos planos disponíveis para catálogos maiores.
Suporte e recursos adicionais
-
A Brilliant não aparece na minha loja. O que posso verificar?
Verifique se:
- A Brilliant Control Center está ativada e as alterações foram salvas no tema publicado da Shopify.
- A Brilliant está ativada em Início.
- O catálogo terminou de ser processado.
- Você não atingiu o limite de conversas do seu plano.
- O cliente está navegando por um mercado ativo da sua loja.
Se você verificou esses pontos e a Brilliant ainda não aparece, entre em contato com o Suporte.
-
Onde posso entrar em contato com o suporte?
Você pode escrever diretamente para support@getbrilliant.ai para esclarecer qualquer dúvida técnica ou de configuração.
Quer saber mais?