A app de pesquisa Buskara chega às lojas Shopify

Em resumo

• O Buskara instala-se numa loja Shopify como qualquer aplicação: instala-se, aprovam-se acessos só de leitura, e liga-se um interruptor no editor do tema. Sem código e sem tokens à vista.
• O catálogo chega ao índice em tempo real, pela própria Shopify: um produto ou um stock alterado aparece na pesquisa segundos depois, em todas as línguas publicadas da loja.
• O botão de produtos semelhantes e o carrossel "também pode gostar" são blocos do editor do tema, que se arrastam para a ficha de produto.
• As encomendas ligam-se à sessão de pesquisa ou de assistente que as originou, e é assim que o painel mostra a receita que a pesquisa trouxe.
• A sincronização do dia-a-dia é gratuita. Só forçar uma reindexação completa custa 1 bToken por cada 1.000 documentos, e o painel diz a conta antes de confirmar.

A pesquisa de uma loja online é a parte do site onde o cliente diz, com as suas palavras, o que quer comprar. É também a parte que mais lojas Shopify deixam como veio: a barra do tema, a responder com o que a plataforma dá de série.

O Buskara é uma app de pesquisa para Shopify que substitui essa barra, e fá-lo de uma forma que um módulo não permitia: sem chave para copiar, sem módulo para descarregar, sem ninguém a abrir um ficheiro do tema. Já fazia o mesmo em lojas PrestaShop, com um módulo que não toca no tema. Este artigo explica o que muda, o que fica onde está, e o que custa.

O que muda numa loja Shopify com o Buskara

A barra e a lupa de pesquisa do tema ficam onde estão. O que muda é quem responde quando alguém escreve nelas: em vez do motor da plataforma, abre-se o painel de pesquisa do Buskara, com o cursor pronto a escrever.

A pesquisa que aparece corrige gralhas e mostra o que corrigiu, percebe sinónimos e intenção, e desenha os filtros a partir do que os resultados têm: marcas, tipos, tamanhos, o que os produtos realmente trouxerem. Quando uma pesquisa ia acabar em zero resultados, a IA traduz a frase em termos do catálogo e volta a tentar. E as perguntas que não são produtos, como "quanto tempo demora a entrega", encontram resposta no conteúdo da loja, num bloco à parte que não rouba lugar aos produtos.

Do lado de quem gere, aparece o painel: as pesquisas que voltaram vazias, os sinónimos que a IA sugere e se aprovam com um clique, as regras de merchandising com datas, e a receita atribuída à pesquisa e ao assistente, dia a dia.

O que fica exatamente como estava importa tanto como o que muda:

Instalação num clique, sem código

Instalar o Buskara numa loja Shopify são três gestos, e nenhum deles é técnico.

1. Instalar a aplicação. Escreve-se o endereço da loja, a Shopify mostra o ecrã de consentimento, e aprova-se. Os acessos pedidos são todos de leitura: produtos, inventário, publicações, idiomas, mercados e encomendas. O Buskara não pede nenhuma autorização de escrita sobre a loja.
2. Esperar pela primeira sincronização. Arranca sozinha assim que a aplicação é instalada. Um catálogo pequeno demora menos de um minuto; um grande, alguns.
3. Ligar o interruptor no editor do tema. Em Loja online → Personalizar, nas incorporações de aplicações, liga-se Buskara e guarda-se. A partir desse momento a pesquisa é a do Buskara.

Não há chave de API para copiar, não há token para colar, não há tag para injetar no tema. Desligar o interruptor devolve a pesquisa nativa da Shopify no momento. Os passos estão, com capturas de ecrã e os nomes exatos dos menus, no guia ligar uma loja Shopify.

Blocos no editor do tema: semelhantes e "também pode gostar"

As duas peças que vivem nas fichas de produto não obrigam a tocar em código: são blocos do editor do tema, e arrastam-se para onde o lojista os quiser.

• Buskara: botão produtos semelhantes. Um botão discreto na ficha, que abre o painel de semelhantes com filtros e comparação. O sítio habitual é por baixo do botão de compra.
• Buskara: bloco também pode gostar. O carrossel de recomendações, alimentado pelo que se vê e se compra na loja. Numa ficha de produto, as sugestões partem desse produto; noutra página qualquer, mostra os recomendados gerais da loja.

Os dois blocos só se desenham quando há resultados para mostrar. Um bloco sem nada para dizer não ocupa lugar na página.

Catálogo em tempo real, por webhooks

Numa loja Shopify o índice do Buskara mantém-se em dia por dois caminhos, e nenhum precisa de configuração.

O primeiro é o tempo real: a própria Shopify avisa o Buskara sempre que um produto é criado, alterado ou apagado, ou que o stock mexe, e a alteração chega ao índice segundos depois. É por aqui que passa quase tudo, e é o que faz o preço e o stock na pesquisa serem os mesmos da loja.

O segundo é a rede periódica: em ciclos regulares, o Buskara confere na Shopify o que mudou desde a última passagem, para nada ficar para trás se um aviso se perder pelo caminho. Não depende de nenhum endereço da loja estar acessível do exterior, que era a condição que a sincronização periódica pedia no PrestaShop.

O índice segue as línguas publicadas da loja: uma loja em português e inglês fica com a pesquisa nas duas, com as traduções de produtos que existirem na Shopify e o original onde não existirem. As variantes entram no documento, para a pesquisa poder pôr no carrinho o tamanho ou a cor certa. A mecânica está em como o catálogo é indexado.

Um assistente que só vende o que existe

O visitante que não sabe o nome do que precisa pode simplesmente descrevê-lo. O assistente do Buskara recomenda a partir do catálogo real e do stock real, nunca inventa produtos nem preços, e passa a conversa ao apoio da loja quando não sabe a resposta. Pode encher o carrinho durante a conversa e levar o cliente até ao checkout.

O que o distingue de um chatbot genérico é o que ele recusa fazer, e isso está explicado em um assistente que não sabe dizer «não sei» é um problema. Como se configura, que fontes usa e como se lhe dá uma base de conhecimento está no guia do assistente.

Vendas atribuídas à pesquisa e ao assistente

A pergunta que decide se uma pesquisa vale o que custa é "quanto vendeu?", e numa loja Shopify o Buskara responde-lhe sem que ninguém instale nada. Cada encomenda que a Shopify comunica liga-se à sessão de pesquisa ou de assistente que a originou, quando existe uma.

Por omissão só entram na atribuição as encomendas tocadas pela pesquisa: uma compra que nasceu de uma pesquisa, de um clique num resultado ou de uma conversa com o assistente conta; uma que chegou por uma campanha e nunca passou pela caixa de pesquisa não conta. É uma atribuição conservadora de propósito, para o número que o painel mostra ser um número em que se pode confiar. O porquê de a correlação entre pesquisa e compra enganar tanto está em quem pesquisa compra mais, e isso não quer dizer o que parece; o que o painel mostra está no guia de analytics.

O que custa a indexação

Nada, no dia-a-dia. O tempo real, a rede periódica e a primeira sincronização quando a loja se liga não custam nada: não encostam no limite do plano nem geram excedente. Manter o catálogo em dia não deve ser uma decisão de orçamento.

O que tem preço é forçar. O botão Reindexar tudo, na ficha da loja no painel, limpa e reconstrói os motores a partir do catálogo, e custa 1 bToken por cada 1.000 documentos enviados; um catálogo de 8.000 produtos são 8 bTokens. A janela de confirmação diz a conta antes de arrancar, e o que se gasta aparece no gráfico de uso. Quando é que vale a pena carregar nele, e quando não vale, está em reindexar o catálogo.

Prós e contras de trocar a pesquisa nativa da Shopify

A pesquisa que vem com a Shopify não é má, e convém ser justo com ela. Segundo a documentação da plataforma, tolera uma gralha em palavras de 3 a 5 letras e duas a partir de 6, e a aplicação Search & Discovery, gratuita, acrescenta sinónimos, filtros e destaques de produtos por termo. Numa loja pequena com vocabulário estável, costuma chegar.

A primeira linha da direita é a objeção séria. A resposta possível é a da primeira linha da esquerda: o interruptor das incorporações de aplicações desliga o Buskara no momento, e a pesquisa nativa volta tal como estava.

Experimentar na loja, com o catálogo real

O Buskara experimenta-se na própria loja, com o catálogo real e o tráfego real: são 30 dias grátis, sem pagar nada antecipadamente. No fim escolhe-se um plano, ou não se escolhe nada. Os planos partilham o mesmo núcleo de pesquisa e mudam na capacidade, e o registo leva à instalação da aplicação em três passos.

Perguntas frequentes

O Buskara altera o tema da Shopify?

Não altera secções, ficheiros nem CSS. Liga-se como uma incorporação de aplicação no editor do tema, e os blocos de semelhantes e de recomendados são blocos normais do editor, que se arrastam e se removem como qualquer outro. Desligar a incorporação devolve a pesquisa nativa no momento.

Que acessos a aplicação pede?

Só leitura: produtos, inventário, publicações, idiomas, mercados e encomendas. Não há nenhuma autorização de escrita sobre a loja, e o acesso às encomendas serve apenas para atribuir vendas à pesquisa e ao assistente.

Com que rapidez uma alteração de stock chega à pesquisa?

Segundos. A Shopify avisa o Buskara por webhook quando um produto ou o inventário mudam, e a alteração entra no índice sem esperar por nenhuma sincronização. Uma rede periódica confere, em ciclos regulares, que nada ficou para trás.

A pesquisa funciona nas várias línguas da loja?

Sim. O índice segue as línguas publicadas na Shopify, com as traduções de produtos que existirem e o original onde não existirem. Cada língua tem o seu motor, com os seus sinónimos e os seus pesos.

Como é que a receita é atribuída à pesquisa?

Cada encomenda que a Shopify comunica liga-se à sessão de pesquisa ou de assistente que a originou. Por omissão só contam as encomendas que passaram pela pesquisa, por um clique num resultado ou por uma conversa com o assistente; as outras ficam de fora, para o número ser conservador.

Quanto custa manter o catálogo indexado?

Nada. O tempo real, a rede periódica e a primeira sincronização são gratuitos. Só forçar uma reindexação completa tem preço, 1 bToken por cada 1.000 documentos enviados, e o painel mostra a conta antes de confirmar.

Preciso de programar alguma coisa?

Não. A instalação é a aprovação da aplicação e um interruptor no editor do tema. Lojas headless ou montagens fora do comum podem ligar-se com um token de acesso criado à mão, e isso está no guia de ligação da loja Shopify.

O que acontece se desinstalar a aplicação?

A pesquisa da loja volta a ser a da Shopify. O índice do lado do Buskara continua a existir, apenas deixa de ser alimentado; voltar a instalar liga a loja à mesma conta e nada se perde.