Ative o Olvio Advisor e adicione links do Advisor à sua loja

Os compradores abrem o Olvio Advisor clicando em um link do Advisor que aponta para uma página da sua loja. Para configurar isso, ative a incorporação de app Olvio Advisor no seu tema e coloque o link direto de um chip onde você quiser que os compradores comecem. O Olvio Advisor está disponível nos planos Growth e Scale.

Antes de começar

Sua loja está no plano Growth ou Scale. No plano Starter, a página Advisor mostra O Advisor está disponível a partir do plano Growth com um botão Ver planos.
Você criou e salvou pelo menos um chip na página Advisor. Consulte Crie chips de início e eixos de conversa do Advisor.
Sua chave de API da Anthropic está conectada, porque as respostas do Advisor a usam. Consulte Conecte sua chave de API da Anthropic (Claude).

Etapa 1: ative a incorporação de app Olvio Advisor

A incorporação de app carrega o Olvio Advisor em todas as páginas da sua loja. Ela não tem configurações próprias.

No admin da Shopify, acesse Loja virtual.
Encontre seu tema publicado e clique em Editar tema.
Na barra lateral, clique no ícone Incorporações de apps.
Ao lado de Olvio Advisor, clique no botão de alternância para ativá-la.
Clique em Salvar.

As incorporações de apps são ativadas tema por tema. Se você publicar outro tema depois, ative Olvio Advisor nesse tema também.

O Olvio também verifica isso para você. Quando você tem pelo menos um chip e a incorporação está desativada no seu tema publicado, a página Advisor mostra O Advisor ainda não está visível na sua loja. Clique em Abrir o Editor de temas para abrir o editor de temas em uma nova aba com Olvio Advisor selecionado, confirme que o botão de alternância está ativado e clique em Salvar. O banner desaparece na próxima vez que você abrir a página Advisor. Se depois você desativar a incorporação ou publicar um tema em que ela está desativada, o banner pode não aparecer imediatamente. Se o Olvio não conseguir ler seu tema, nenhum banner é exibido. Nos dois casos, verifique você mesmo o botão de alternância se os links não responderem.

Etapa 2: copie o link direto de um chip

No admin do Olvio, abra Widget e clique em Configurar no card Advisor.
Ao lado do chip para o qual você quer criar o link, clique em Editar.
Na seção Link direto, clique em Copiar ao lado de Hash da URL.

O hash tem este formato: #olvio_advisor=chip:chip_1a2b3c4d. Cada chip tem o seu. O campo Exemplo HTML logo abaixo contém uma tag de link pronta com o texto Advisor, com seu próprio botão Copiar, caso você prefira colar HTML. Esse link HTML só funciona em páginas da sua loja. Para itens de menu e e-mails, use o endereço completo da página com o hash, como mostrado na etapa 3.

A seção Link direto só aparece em chips salvos. Quando você salva um novo chip, o Olvio leva você de volta à página Advisor: clique em Editar no novo chip para obter o link dele.

O link de um chip continua funcionando quando você altera o rótulo ou os eixos dele. Se você remover o chip (clique em Remover e depois em Salvar), o link dele deixa de abrir o Advisor.

Etapa 3: adicione o link à sua loja

Adicione o hash ao final do endereço de qualquer página da sua loja que ainda não contenha um #, por exemplo https://your-store.com/collections/all#olvio_advisor=chip:chip_1a2b3c4d. A página carrega e o Advisor abre nesse chip.

Bons lugares para um link do Advisor:

Um item do seu menu de navegação
Um botão de chamada para ação, como o do banner da sua página inicial
Um banner nas suas páginas de produto
Um link em um e-mail de marketing

Para adicionar o link como item de menu:

No admin da Shopify, acesse Conteúdo → Menus.
Clique no título do menu que você quer editar.
Clique em Adicionar item de menu.
Insira um nome para o item de menu.
Cole o endereço completo com o hash no campo Pesquisar ou colar um link. Aguarde a lista suspensa exibi-lo e selecione-o. Se você pressionar Enter ou salvar sem selecioná-lo, o link não é adicionado.
Clique em Adicionar.
Clique em Salvar ou em Salvar menu.

O que os compradores veem

O painel de chat do Olvio abre e o rótulo do chip é enviado como mensagem do comprador, então o Advisor responde na hora. Se uma conversa do Advisor já estiver em andamento na mesma aba do navegador, o rótulo é adicionado a ela.
Um link para a página em que o comprador já está abre o painel sem recarregar a página.
O Olvio remove o hash da barra de endereço, então recarregar a página não envia o rótulo do chip de novo.
O cabeçalho do painel mostra o nome da sua loja, e o painel usa as cores, a fonte, o raio dos cantos e o CSS personalizado que você definiu na página Aparência.
A conversa continua quando o comprador vai para outra página da sua loja na mesma aba do navegador, por um tempo após a última resposta. Fechar o painel apaga a conversa da tela.
Se o comprador já teve uma conversa do Advisor, mesmo uma que ele fechou, abrir um link do Advisor novamente pode oferecer retomar de onde ele parou: o painel pergunta Já tem uma conversa com o nosso assistente. Deseja retomá-la ou recomeçar do zero? com os botões Continuar e Recomeçar. O rótulo do chip só é enviado se ele clicar em Recomeçar, o que inicia uma nova conversa. Continuar traz de volta a conversa anterior.

Teste seu link

Abra sua loja virtual em uma janela anônima do navegador.
Abra uma página da sua loja que não seja uma página de produto, como a página inicial, com o hash adicionado ao final do endereço, por exemplo https://your-store.com/#olvio_advisor=chip:chip_1a2b3c4d. Você também pode clicar no seu link onde o colocou, se ele levar a uma página que não seja uma página de produto.
Verifique se o painel de chat abre e se o Advisor responde.
No admin do Olvio, abra Conversas e selecione a aba Advisor. Sua conversa de teste aparece ali.

Páginas de produto que mostram o bloco Olvio podem abrir o Advisor mesmo com a incorporação de app desativada, então um teste nessas páginas não confirma que a incorporação está ativada.

Se um link não abrir o Advisor

A incorporação de app está desativada. Páginas de produto que mostram o bloco Olvio podem abrir o Advisor sozinhas. Se um link abre o Advisor nessas páginas de produto, mas não em outras páginas, como sua página inicial ou suas coleções, a incorporação de app Olvio Advisor está desativada. Ative-a no seu tema publicado e clique em Salvar.
Seu plano não inclui o Advisor. Os links só funcionam enquanto sua loja tiver uma assinatura ativa do Growth ou do Scale.
O chip foi removido ou o hash foi alterado. Se o hash foi alterado, copie-o novamente na seção Link direto do chip. Se o chip foi removido, substitua o link pelo link de um chip existente ou remova o link.
O endereço já continha um #. O Olvio não reconhece o hash do Advisor quando ele vem depois de outro #. Remova a parte #… existente do endereço e depois adicione o hash do Advisor.
A página está em um idioma que o Olvio não cobre. Quando Ocultar o widget nos idiomas que a Olvio não cobre está marcado no card Idiomas da aba Avançado de Aparência, os links do Advisor também não respondem nesses idiomas. Consulte Multilíngue: escolha quais idiomas o seu widget cobre.
Uma resposta ainda estava sendo escrita. Um clique em um link para a página atual é ignorado enquanto o Olvio escreve uma resposta. Aguarde a resposta e recarregue a página.

Se o painel abrir, mas responder Lamentamos, ocorreu um erro. Por favor, tente novamente., o link funciona e o problema está na resposta: consulte O chat responde "Lamentamos, ocorreu um erro. Por favor, tente novamente." para ver as soluções.