Instale o Olvio na sua loja Shopify
O Olvio é um app do Shopify que você instala pela Shopify App Store. A instalação passa pela tela de instalação padrão do Shopify: você não cria uma conta nem uma senha separadas no Olvio.
Como instalar
Abra a página do Olvio na Shopify App Store e clique em Instalar.
Na tela Instalar app do Shopify, revise os acessos que o Olvio solicita e clique em Instalar.
O Shopify abre o Olvio dentro do seu admin do Shopify. Para voltar a ele depois, abra Apps no seu admin do Shopify e selecione o Olvio.
O admin do Olvio abre no idioma do seu admin do Shopify quando ele está em inglês, francês, alemão, espanhol, italiano ou português, e em inglês para qualquer outro idioma. Para mais detalhes, consulte Altere o idioma do admin do Olvio.
Escolha um plano para desbloquear o Olvio
Até você escolher um plano, todas as páginas do admin do Olvio levam você para a página Planos, e o menu do app mostra apenas Olvio.
Se a sua loja ainda pode usar o teste gratuito, a página mostra Comece seu teste gratuito de 14 dias e os botões dos planos mostram Iniciar teste de 14 dias. Você não é cobrado até o fim do teste.
Se você já usou seu teste gratuito, a página mostra Escolha seu plano e os botões mostram Assinar Starter, Assinar Growth ou Assinar Scale. A cobrança começa assim que você aprova a assinatura no Shopify.
Um plano que inclui menos produtos do que o seu catálogo tem aparece esmaecido, e o botão dele mostra Catálogo grande demais.
Depois de aprovar a assinatura no Shopify, você volta para a página Planos. Ela mostra o banner Ativando sua assinatura… enquanto o Shopify confirma e, em seguida, o título da página muda para Você está no plano Growth (com o nome do seu plano). Se demorar mais que o esperado, esse banner muda para A ativação está demorando mais que o esperado, com um botão Atualizar status. Consulte Problemas na página Planos: ativação travada ou "Catálogo grande demais". O menu completo do app aparece quando o plano está ativo. Para mais detalhes, consulte Assine um plano e inicie seu teste gratuito e Compare os planos Starter, Growth e Scale.
O que o Olvio pode acessar
O Olvio solicita cinco permissões de acesso, todas somente leitura. Ele não tem permissão para editar seus produtos, pedidos ou clientes.
read_products: para importar seus produtos e coleções, assim o Olvio pode responder a perguntas sobre eles.read_orders: para ver quais pedidos vêm depois de uma conversa com o Olvio, assim o seu Painel pode mostrar a receita atribuída ao Olvio. Para cada pedido feito na sua loja virtual enquanto você tem um plano (incluindo o teste gratuito), o Olvio guarda o ID do pedido, os IDs dos produtos, o total do pedido e a moeda, além de um ID de sessão anônimo quando o pedido vem depois de uma conversa. Ele não guarda o nome, o e-mail, o telefone nem o endereço do cliente.read_themes: para verificar se o seu tema publicado é compatível com o bloco do Olvio (Online Store 2.0) e, nos planos Growth e Scale, se a incorporação de app Olvio Advisor está ativada.read_locales: para ler os idiomas publicados na sua loja virtual, assim o widget pode funcionar no idioma certo.read_metaobjects: para ler o conteúdo dos metaobjetos referenciados nos metacampos dos seus produtos, assim o Olvio vê esse conteúdo, e não apenas uma referência.
O que o Olvio adiciona à sua loja
Instalar o Olvio não altera seu tema, seus produtos nem seus pedidos. O widget só aparece nas suas páginas de produto depois que você adiciona o bloco Olvio — Product page ao modelo de produto no editor de temas.
Quando você começa a usar o app, o Olvio grava duas coisas:
As configurações do seu widget. Quando seu plano fica ativo, e sempre que você salva configurações como Aparência ou Chave de API, o Olvio salva uma cópia das configurações do seu widget em metacampos que pertencem ao app. Os blocos do Olvio no seu tema usam essas configurações para exibir o widget.
Um atributo de carrinho chamado
_olvio_session. Depois que o Olvio responde à mensagem de um comprador, o widget adiciona esse atributo, com um ID de sessão anônimo, ao carrinho do comprador, e o Shopify o copia para o pedido. É assim que o Olvio vincula um pedido a uma conversa. Ele não foi feito para ser mostrado aos compradores, mas, dependendo do seu tema e dos modelos de notificação, pode aparecer na página do carrinho ou nos e-mails de pedido.
O que o Olvio armazena sobre sua loja
Na primeira vez que você abre o Olvio, ele cria um registro para sua loja vinculado ao seu domínio .myshopify.com, junto com o token de acesso que o Shopify emite para o app. O banco de dados do Olvio é hospedado pela Cloudflare na região da Europa Ocidental. O índice de busca do Olvio, o cache dele, o cálculo dos dados de busca e o próprio app rodam na rede global da Cloudflare, que não é restrita à União Europeia.
A equipe do Olvio (Topicimes) pode ver os dados da sua loja por meio de um console interno somente leitura. Ele mostra os mesmos painéis, listas de conversas, transcrições (com o pedido vinculado, quando houver) e mapa de perguntas que o seu admin do Olvio, além de informações de conta e de operação, como seu plano, a data de instalação, a receita atribuída e a saúde técnica. O console é usado apenas para suporte, diagnóstico de incidentes e controle de qualidade do serviço. O acesso é restrito às pessoas autorizadas pela Topicimes e protegido por login único, e todo acesso é registrado.
Cerca de 48 horas depois que você desinstala o Olvio, o Olvio exclui permanentemente os dados da sua loja do banco de dados e do índice de busca dele. Para mais detalhes, consulte Que dados o Olvio armazena sobre sua loja, Onde meus dados estão hospedados? e O que acontece com meus dados quando desinstalo o Olvio.
O que fazer em seguida
Na primeira vez que você abre o admin do Olvio com um plano ativo, o Olvio começa a importar seu catálogo do Shopify em segundo plano. O Painel, a página que abre quando você clica em Olvio no menu do app, mostra o progresso e se atualiza automaticamente quando a importação termina.
Depois, siga o card Prepare o Olvio para seu primeiro cliente no Painel:
Adicione sua chave de API da Anthropic. O Olvio funciona com a sua própria chave de API do Claude da Anthropic. Consulte Conecte sua chave de API da Anthropic (Claude).
Personalize sua IA. Descreva seu negócio na página Configuração de IA. Consulte Configure sua Configuração de IA.
Personalize a aparência do widget. Abra a página Aparência. Consulte Personalize as cores do widget.
Adicione o bloco Olvio à sua página de produto. Isso exige um tema Online Store 2.0. Consulte Adicione o widget Olvio às suas páginas de produto.
Cada etapa é marcada como concluída automaticamente. A etapa do bloco é marcada na primeira vez que o widget carrega em um produto ativo que o Olvio já importou. Se a importação do catálogo ainda estiver em andamento, abra a página do produto novamente alguns minutos depois que ela terminar. Consulte Seu guia de configuração: prepare o Olvio para seu primeiro cliente.
Se o seu tema publicado usa o formato antigo Online Store 1.0, o Painel mostra Seu tema não é compatível com o widget do Olvio. Consulte Online Store 1.0 não suportada — o que fazer.
Se precisar de ajuda em qualquer etapa, use o chat de suporte no admin do Olvio. Ele está disponível em todas as páginas, incluindo Planos. Consulte Contate-nos e horário de suporte.