Ligue a sua loja BigCommerce ao seu chatbot ChatLab. Uma vez ligado, o chatbot pesquisa os seus produtos, indexa todo o catálogo para o AI Search, permite que os clientes adicionem produtos ao carrinho a partir do chat e consulta o estado das encomendas diretamente na sua loja.
Exemplo de conversa
Consultar uma encomenda
Requer uma loja associada e a respetiva ação de encomendas ativada. Os campos disponíveis dependem da integração. A correspondência de um endereço de e-mail não constitui prova de identidade.
Visitante: Onde está a minha encomenda?
Reproduza o exemplo ou leia-o abaixo. Não são utilizados dados reais de clientes.O cliente pergunta sobre uma encomenda existente.
A reprodução pausa quando este exemplo sai do ecrã. Isto é uma simulação, não um chat em direto. Os controlos do widget dentro da reprodução não são interativos.Ler o exemplo completo
- O cliente pergunta sobre uma encomenda existente.
Visitante: Onde está a minha encomenda?
- A pesquisa predefinida necessita de ambos os identificadores.
Assistente: Por favor, indique o número da sua encomenda e o endereço de e-mail utilizado na finalização da compra.
- Utilize dados fictícios neste exemplo.
Visitante: 41982, anna@example.com
- A ação consulta a loja associada.
A verificar a encomenda 41982...
- Apresente apenas as informações devolvidas pela loja.
Assistente: A encomenda 41982 está marcada como enviada. A transportadora é a DPD. Por favor, consulte a página de acompanhamento para ver atualizações sobre a entrega.
O exemplo ilustra a experiência do cliente. As ações disponíveis e as informações devolvidas dependem desta integração e da sua configuração.
Importante: boas práticas para e-commerce
Depois de concluir a integração abaixo, leia o guia detalhado sobre como otimizar o seu chatbot para e-commerce: Como configurar o ChatLab para a sua loja de e-commerce
O que a integração oferece
Pesquisa de produtos por IA - Os clientes descrevem o que precisam pelas suas próprias palavras e o chatbot encontra os produtos correspondentes no seu catálogo. A resposta contém:
- Nome e descrição do produto
- Preço atual na moeda da sua loja e, para produtos em promoção, também o preço normal
- Imagem do produto
- Ligação direta para a página do produto na sua loja
- Disponibilidade, SKU, marca, categorias e opções de produto (tamanhos, cores) quando o produto os tiver
Pesquisa de produtos por termo - Uma pesquisa simples por palavras-chave no seu catálogo BigCommerce. A pesquisa de produtos por IA substitui-a automaticamente assim que o catálogo estiver indexado.
Estado da encomenda - O cliente fornece o número da encomenda e o endereço de e-mail utilizado no checkout, e o chatbot responde com o estado da encomenda, os artigos encomendados, os totais e os detalhes de rastreio quando a encomenda tiver sido enviada. As encomendas são sempre validadas com o e-mail do cliente, pelo que um número de encomenda adivinhado nunca revela a encomenda de outra pessoa.
Adicionar ao carrinho - Os cartões de produto no chat podem apresentar um botão Add to cart (Adicionar ao carrinho). Na sua montra BigCommerce, o botão adiciona o produto diretamente ao carrinho do cliente e o contador do carrinho no cabeçalho da página é atualizado. Para produtos com opções como tamanho ou cor, o cliente escolhe primeiro a variante no chat. Para produtos com opções que o chat não consegue preencher (por exemplo, um campo de texto obrigatório para uma gravação), o botão abre a página do produto.
Widget de chat na sua montra - O ChatLab adiciona o widget de chat à sua montra através do Script Manager do BigCommerce, pelo que não precisa de colar nenhum código.
Veja a experiência com o carrinho
Para ver um exemplo do carrinho e instruções de teste na montra, consulte Adicionar produtos ao carrinho. A sequência abaixo é ilustrativa; não executa uma operação real de carrinho no BigCommerce.
Escolha uma variante antes de adicionar ao carrinho
Sequência ilustrativa: os botões reais do carrinho e os seletores de variantes dependem da plataforma e da loja. Esta demonstração não executa nenhuma operação no carrinho.
Vestido traçado verde-esmeralda, $79. Viscose, comprimento midi.
Reproduza o exemplo ou leia-o abaixo. Não são utilizados dados reais de clientes.Os resultados de pesquisa apresentam um cartão de produto com controlo de carrinho nas lojas suportadas.
A reprodução pausa quando este exemplo sai do ecrã. Isto é uma simulação, não um chat em direto. Os controlos do widget dentro da reprodução não são interativos.Ler o exemplo completo
- Os resultados de pesquisa apresentam um cartão de produto com controlo de carrinho nas lojas suportadas.
Vestido traçado verde-esmeralda, $79. Viscose, comprimento midi.
- O cliente escolhe um produto e o tamanho através dos controlos de carrinho suportados.
Visitante: Vestido traçado verde-esmeralda, tamanho 38.
- Confirme o sucesso apenas após a loja aceitar a operação do carrinho.
Assistente: Resultado de exemplo: a variante selecionada foi adicionada ao carrinho da sua loja.
- O pagamento e a finalização da compra são feitos diretamente na loja.
Assistente: Reveja o carrinho na loja para confirmar a quantidade, o preço e a entrega antes de avançar para o checkout.
O que a integração não oferece
- Pagamento (checkout) no chat. O cliente conclui a compra na sua loja BigCommerce.
- Alertas de stock em tempo real. Os preços e a disponibilidade são lidos a partir do BigCommerce quando o chatbot responde, mas o chatbot não notifica os clientes sobre alterações posteriores.
- Adicionar ao carrinho em montras headless. O botão do carrinho funciona em montras construídas sobre temas BigCommerce. Numa montra headless, este abre a página do produto e o widget de chat tem de ser adicionado ao site manualmente.
Requisitos
- Uma loja BigCommerce na qual seja o proprietário da loja ou um utilizador com permissão para instalar aplicações ou criar contas de API.
- A integração BigCommerce incluída no seu plano ChatLab.
- Para a pesquisa de produtos por IA: capacidade de AI Search atribuída ao chatbot suficiente para os seus produtos visíveis. Verifique a capacidade disponível em Shop (Loja) > Products (Produtos).
- Nenhuma outra integração de loja ligada ao mesmo chatbot.
Escolha uma das duas formas abaixo. Ambas conduzem ao mesmo resultado.
Opção A: Instalar a aplicação ChatLab
- No painel de controlo do BigCommerce, aceda a Apps (Aplicações), localize ChatLab e clique em Install (Instalar).
- Reveja as permissões e clique em Confirm (Confirmar). O ChatLab solicita acesso só de leitura a produtos, encomendas, clientes e informações da loja, bem como acesso ao conteúdo da montra para adicionar o seu widget de chat.
- A página do ChatLab abre-se dentro do seu painel de controlo. Clique em Continue setup (Continuar configuração). O processo de integração (onboarding) do ChatLab abre-se num novo separador do navegador.
- Inicie sessão na sua conta ChatLab ou crie uma se ainda não a tiver.
- Escolha um chatbot existente ou crie um novo para esta loja.
Está concluído. O ChatLab liga a loja ao chatbot escolhido, ativa as ações de pesquisa de produtos e estado da encomenda, inicia a indexação do seu catálogo e adiciona o widget de chat à sua montra. Pode abrir o ChatLab novamente em qualquer altura a partir do menu Apps do seu painel de controlo.
Desinstalar a aplicação no BigCommerce desativa a integração no ChatLab e remove o widget de chat da sua montra. O seu chatbot e as respetivas conversas permanecem na sua conta ChatLab.
Opção B: Ligar com uma conta de API ao nível da loja
Utilize esta opção se preferir criar o acesso manualmente ou se quiser ligar um chatbot sem instalar a aplicação.
Passo 1: Criar a conta de API no BigCommerce
- No painel de controlo do BigCommerce, aceda a Settings (Definições) e depois a Store-level API accounts (Contas de API ao nível da loja).
- Clique em Create API account (Criar conta de API) e atribua-lhe um nome, por exemplo, ChatLab.
- Defina as permissões:
- Products - só de leitura (read-only)
- Orders - só de leitura (read-only)
- Customers - só de leitura (read-only)
- Information & settings - só de leitura (read-only)
- Content - modificar (modify)
- Clique em Save (Guardar). O BigCommerce apresenta as credenciais uma única vez e transfere-as num ficheiro de texto.
- Copie o API path (Caminho da API) e o Access token (Token de acesso).
O caminho da API tem um formato semelhante a api.bigcommerce.com/stores/abc123/v3/. A parte entre stores/ e /v3/ é o hash da sua loja.
Mantenha o token de acesso em privado. Pode revogá-lo em qualquer altura eliminando a conta de API no BigCommerce.
Passo 2: Ligar a loja no ChatLab
- Abra o seu chatbot no ChatLab e aceda a Shop.
- Clique no mosaico BigCommerce.
- Cole o caminho da API (ou apenas o hash da loja) em Store hash or API path (Hash da loja ou caminho da API) e o token em Access token.
- Clique em Check connection (Verificar ligação). O ChatLab lê o perfil da loja e apresenta o nome da loja, o endereço da montra e a moeda.
- Clique em Connect (Ligar).
O ChatLab testa a ligação e ativa as ações de pesquisa de produtos e de estado da encomenda. Quando a capacidade de AI Search estiver atribuída ao chatbot, a indexação do catálogo começa de imediato e a janela de confirmação apresenta essa indicação. A mesma janela informa se o widget de chat foi adicionado à sua montra. O token de acesso é guardado de forma encriptada e nunca mais é apresentado; deixe o campo do token vazio se pretender apenas atualizar a ligação.
Configurar as ações
Aceda a Settings > AI Actions (Ações de IA). Estão disponíveis três ações para o BigCommerce:
- BigCommerce - AI product search - pesquisa semântica em todo o catálogo indexado. Nas suas definições pode incluir o cartão de produto completo na resposta, limitar os resultados a produtos em stock e ativar o botão Add to cart.
- BigCommerce - product search - pesquisa por palavras-chave no catálogo BigCommerce, utilizada quando o AI Search não está disponível para o chatbot. Também pode ser limitada a produtos em stock e apresentar o botão Add to cart.
- BigCommerce - order details - consulta do estado da encomenda. O limite de pedidos (rate limiting) e a ocultação de dados pessoais estão disponíveis nas definições da ação.
Cada ação tem um prompt editável e uma etiqueta de ação apresentada no chat enquanto o chatbot está a processar.
Verificar o catálogo
Abra Training (Treino) > E-commerce catalog (Catálogo de e-commerce) para acompanhar o progresso da indexação, explorar os produtos indexados e voltar a treinar o catálogo após alterações maiores na loja. Os produtos que não estão visíveis na sua loja não são indexados.
Os produtos sem descrição são indexados apenas por nome, marca, categorias e atributos. Se os seus produtos não têm descrições no BigCommerce, adicionar mesmo que seja uma descrição curta melhora significativamente os resultados de pesquisa.
Quando também treina o chatbot nas páginas do seu website, o ChatLab reconhece uma loja BigCommerce e ignora as páginas de produtos, categorias e marcas. Os dados dos produtos são obtidos do catálogo, pelo que não precisam de ser lidos das páginas uma segunda vez.
O widget de chat na sua montra
Quando a loja está ligada através da aplicação, ou através de uma conta de API com acesso de modificação a Content, o ChatLab adiciona o widget por si. Pode encontrá-lo em Storefront (Montra) > Script Manager como ChatLab chatbot. É colocado no rodapé de todas as páginas da montra, na categoria de consentimento Functional (Funcional), e é removido quando desliga a loja.
Se a conta de API foi criada sem acesso a Content, crie uma nova conta de API com esse acesso e volte a ligar, ou adicione o widget manualmente:
- No ChatLab, abra o seu chatbot, aceda a Test & Deploy (Testar e publicar), escolha BigCommerce e copie o código.
- No painel de controlo do BigCommerce, aceda a Storefront > Script Manager.
- Clique em Create a Script (Criar um script) e atribua-lhe um nome, por exemplo, ChatLab.
- Defina Placement (Posicionamento) para Footer (Rodapé), Location (Localização) para Storefront pages (Páginas da montra) e Script category (Categoria do script) para Functional.
- Escolha Script type (Tipo de script) Script e cole o código em Script contents (Conteúdo do script).
- Clique em Save e atualize a sua montra. O chatbot aparece no canto inferior de todas as páginas.
Resolução de problemas
- "Failed to connect to the BigCommerce store. Check the store hash and the access token." - O token foi copiado de forma incompleta, a conta de API foi eliminada ou o hash da loja pertence a uma loja diferente. Copie ambos os valores novamente a partir do ficheiro que o BigCommerce transferiu quando a conta de API foi criada.
- O widget de chat não foi adicionado automaticamente - A conta de API não tem acesso de modificação a Content. Crie uma nova conta de API com esse acesso e volte a ligar, ou adicione o widget no Script Manager conforme descrito acima.
- O chatbot não aparece na montra - Verifique se o script está listado em Storefront > Script Manager. Se a sua loja utilizar um aviso de consentimento de cookies, o widget carrega depois de o visitante aceitar a categoria Functional.
- O chatbot não encontra produtos - Verifique o estado da indexação em Training > E-commerce catalog e certifique-se de que os produtos estão visíveis na sua loja.
- A encomenda não é encontrada - O chatbot necessita do endereço de e-mail utilizado no checkout juntamente com o número da encomenda indicado no e-mail de confirmação.
- Adicionar ao carrinho abre a página do produto - O produto tem uma opção obrigatória que não pode ser escolhida no chat, como um campo de texto, ou o chatbot está a ser executado fora da sua montra BigCommerce.