Centro de Ajuda
Integrações do chatbot

Integração com a BigCommerce

Última atualização:

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

Veja numa 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.

Exemplo do ChatLabConversa ilustrativa

Visitante: Onde está a minha encomenda?

Reproduza o exemplo ou leia-o abaixo. Não são utilizados dados reais de clientes.
1 / 5

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
  1. O cliente pergunta sobre uma encomenda existente.

    Visitante: Onde está a minha encomenda?

  2. 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.

  3. Utilize dados fictícios neste exemplo.

    Visitante: 41982, anna@example.com

  4. A ação consulta a loja associada.

    A verificar a encomenda 41982...

  5. 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.

Veja numa conversa

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.

Exemplo do ChatLabConversa ilustrativa

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.
1 / 4

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
  1. 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.

  2. O cliente escolhe um produto e o tamanho através dos controlos de carrinho suportados.

    Visitante: Vestido traçado verde-esmeralda, tamanho 38.

  3. 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.

  4. 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

  1. No painel de controlo do BigCommerce, aceda a Apps (Aplicações), localize ChatLab e clique em Install (Instalar).
  2. 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.
  3. 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.
  4. Inicie sessão na sua conta ChatLab ou crie uma se ainda não a tiver.
  5. 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

  1. 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).
  2. Clique em Create API account (Criar conta de API) e atribua-lhe um nome, por exemplo, ChatLab.
  3. 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)
  4. Clique em Save (Guardar). O BigCommerce apresenta as credenciais uma única vez e transfere-as num ficheiro de texto.
  5. 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

  1. Abra o seu chatbot no ChatLab e aceda a Shop.
  2. Clique no mosaico BigCommerce.
  3. 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.
  4. 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.
  5. 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:

  1. No ChatLab, abra o seu chatbot, aceda a Test & Deploy (Testar e publicar), escolha BigCommerce e copie o código.
  2. No painel de controlo do BigCommerce, aceda a Storefront > Script Manager.
  3. Clique em Create a Script (Criar um script) e atribua-lhe um nome, por exemplo, ChatLab.
  4. Defina Placement (Posicionamento) para Footer (Rodapé), Location (Localização) para Storefront pages (Páginas da montra) e Script category (Categoria do script) para Functional.
  5. Escolha Script type (Tipo de script) Script e cole o código em Script contents (Conteúdo do script).
  6. 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.