Seu guia de configuração: prepare o Olvio para seu primeiro cliente
Depois que você escolhe um plano, o Painel do Olvio mostra um card chamado Prepare o Olvio para seu primeiro cliente. Ele lista quatro etapas de configuração, leva você à tela certa para cada uma e marca automaticamente cada etapa concluída. Este guia percorre cada etapa e, depois, mostra o que configurar em seguida.
Encontre o guia de configuração
Abra o Olvio no admin da Shopify. O card fica perto do topo do Painel, a página que abre quando você clica em Olvio no menu do app.
O card só aparece depois que você escolhe um plano. Até lá, o Olvio abre a página Planos no lugar dele. Veja Assine um plano e inicie seu teste gratuito.
Abaixo do título do card, uma linha como 1 de 4 etapas concluídas acompanha seu progresso. Cada etapa concluída mostra uma marca de seleção sobre fundo verde, e o rótulo do botão dela muda, por exemplo, de Adicionar chave para Gerenciar chave.
Você pode concluir as etapas em qualquer ordem. Uma etapa que você conclui em outro lugar do Olvio também é marcada na próxima vez que você abrir o Painel.
Etapa 1: adicione sua chave de API da Anthropic
O Olvio responde aos seus compradores com os modelos Claude da Anthropic, usando sua própria chave de API da Anthropic. A Anthropic cobra você diretamente pelo seu uso.
Clique em Adicionar chave. A página Chave de API é aberta.
Cole sua chave no campo Chave de API. Se você ainda não tem uma, crie-a no Claude Console (o endereço console.anthropic.com mostrado na página Chave de API abre o mesmo console). Se sua conta da Anthropic não tiver créditos, compre créditos lá primeiro: o Olvio envia uma pequena solicitação de teste à Anthropic quando você clica em Salvar e, sem créditos, a Anthropic a recusa.
Escolha um Modelo Claude. A lista marca o Claude Haiku 4.5 como recomendado.
Clique em Salvar.
Se a solicitação de teste falhar, a chave não é salva. Se der certo, o Olvio criptografa a chave antes de armazená-la. A etapa é marcada como concluída assim que uma chave é salva, e o Status na página Chave de API mostra Conectada.
Enquanto nenhuma chave for salva, o widget continua aparecendo nas suas páginas de produto, mas sem perguntas sugeridas, e não consegue responder aos compradores.
Mais detalhes: Conecte sua chave de API da Anthropic (Claude) e Escolha seu modelo Claude.
Etapa 2: personalize sua IA
Clique em Abrir Configuração de IA.
Em Descrição do negócio, descreva sua loja, o que você vende e quem são seus clientes (até 10.000 caracteres).
Se quiser, adicione palavras-chave das suas áreas de especialização em Categorias / Palavras-chave e regras de Fazer e Evitar em Regras de conversa.
Clique em Salvar.
A etapa é marcada como concluída assim que uma descrição do negócio é salva. Palavras-chave e regras não afetam a lista de etapas.
Mais detalhes: Configure sua Configuração de IA e Escreva regras de conversa eficazes.
Etapa 3: personalize a aparência do widget
Clique em Abrir Aparência.
Use as abas Página de produto, Painel de chat e Estilo para definir o texto, o avatar, as cores e a fonte do widget. A Pré-visualização ao vivo mostra suas alterações conforme você as faz.
Se você alterou algo, clique em Salvar.
Esta etapa é marcada como concluída na primeira vez que você abre a página Aparência, mesmo que você mantenha o visual padrão.
Mais detalhes: Personalize as cores do widget e Mude o nome do especialista, a pergunta de chamariz e o avatar do widget.
Etapa 4: adicione o bloco Olvio à sua página de produto
O chat aparece nas suas páginas de produto depois que o bloco Olvio — Product page é adicionado ao modelo de produto do seu tema. Isso requer um tema Online Store 2.0.
Clique em Abrir editor de temas. O editor de temas abre em uma nova aba no seu modelo de produto padrão, com o bloco Olvio — Product page adicionado em uma nova seção Apps para você pré-visualizar.
Arraste a nova seção Apps que contém o bloco até onde você quer que o chat apareça.
Clique em Salvar no editor de temas.
Depois de salvar, abra uma página de produto na sua loja virtual e confirme que o widget aparece onde você o posicionou.
O atalho adiciona o bloco ao seu modelo de produto padrão. Se alguns produtos usam outro modelo de produto, adicione o bloco nele também: veja Adicione o widget Olvio às suas páginas de produto.
A etapa é marcada como concluída na primeira vez que o widget carrega em um produto ativo que o Olvio já importou. Se ainda houver outras etapas pendentes, o botão dela passa a ser Ver conversas; se essa era a última etapa, o card desaparece. A etapa também pode ser marcada como concluída enquanto você pré-visualiza o bloco no editor de temas, então ela não confirma que você salvou. Sempre clique em Salvar no editor de temas e depois verifique uma página de produto na sua loja virtual. Se o Painel ainda mostrar Configurando seu catálogo de produtos ou Sincronização do catálogo em andamento, aguarde a importação terminar e abra a página de produto novamente alguns minutos depois.
Se o seu tema usa o formato antigo Online Store 1.0, o Painel mostra Seu tema não é compatível com o widget do Olvio e o bloco não pode ser adicionado. Veja Online Store 1.0 não suportada — o que fazer.
Mais detalhes: Adicione o widget Olvio às suas páginas de produto. Se você não encontrar o bloco, veja Não consigo encontrar o bloco Olvio no editor de temas.
Oculte o guia de configuração
O card desaparece sozinho quando as quatro etapas são concluídas.
Para removê-lo antes, clique em Ocultar ao lado do título do card. O card não volta depois de ocultado, mas cada tela continua disponível no menu do app: Chave de API, Configuração de IA e Aparência.
Para adicionar o bloco Olvio depois que o card sumir, siga as etapas manuais em Adicione o widget Olvio às suas páginas de produto.
Enquanto isso, seu catálogo é importado
Na primeira vez que você abre o Olvio depois de escolher um plano, ele começa a importar seus produtos da Shopify em segundo plano. Não é preciso clicar em nada.
Um banner no Painel mostra Configurando seu catálogo de produtos e depois Sincronização do catálogo em andamento. A importação costuma levar de 2 a 10 minutos, mais para catálogos grandes, e o banner se atualiza sozinho. Quando termina, um selo Catálogo sincronizado mostra quantos produtos o Olvio tem. Se, em vez disso, o Painel mostrar Alguns produtos não estão totalmente indexados, clique em Ressincronizar.
O chat não consegue responder em uma página de produto até que esse produto tenha sido importado. Até lá, um comprador que fizer uma pergunta nessa página vê uma mensagem de erro (em português: Lamentamos, ocorreu um erro. Por favor, tente novamente.).
Se sua loja ainda não tem produtos, a importação termina com Falha na sincronização do catálogo. Adicione seus produtos no admin da Shopify (novos produtos são sincronizados com o Olvio automaticamente) e clique em Tentar sincronizar novamente para concluir a importação. Se o banner mostrar Falha na sincronização do catálogo por outro motivo, clique em Tentar sincronizar novamente. Se Ressincronizar, ao lado do selo Catálogo sincronizado, estiver esmaecido, passe o mouse sobre ele para ver quando voltará a ficar disponível. Veja Como o Olvio mantém seu catálogo sincronizado.
Próximas etapas recomendadas
Teste o chat como um comprador faria: Teste o Olvio na sua loja.
Dê à IA mais material para trabalhar, como perguntas frequentes, guias e páginas web públicas, em Arquivos de conhecimento e Páginas web externas na Configuração de IA: Adicione arquivos e páginas web à base de conhecimento do Olvio.
Revise ou substitua as duas perguntas sugeridas exibidas em cada página de produto na página Questions: Personalize as perguntas sugeridas nas suas páginas de produto.
Deixe os compradores escolherem uma variante e adicioná-la ao carrinho sem sair do chat com Ativar adicionar ao carrinho no chat, no card Adicionar ao carrinho no chat da aba Avançado em Aparência: Mostre cards de produto e permita adicionar ao carrinho pelo chat.
Se sua loja publica vários idiomas, confira o card Idiomas na aba Avançado em Aparência. O Starter cobre somente seu idioma principal, o Growth cobre seu idioma principal e mais um (o Olvio escolhe esse idioma até você escolher), e o Scale cobre todos os idiomas publicados compatíveis com o Olvio, a menos que você tenha desmarcado todos os idiomas quando estava no Growth: Multilíngue: escolha quais idiomas o seu widget cobre.
Nos planos Growth e Scale, configure o Advisor, uma conversa guiada que os compradores abrem a partir de links que você adiciona à sua loja. Ele também precisa que a incorporação de app Olvio Advisor esteja ativada no seu tema: O que é o Olvio Advisor?
