Centro de Ajuda
Integrações do chatbot

Integração com o Ecwid by Lightspeed

Última atualização:

Ligue a sua loja Ecwid by Lightspeed ao seu chatbot ChatLab. Uma vez ligado, o chatbot pesquisa os seus produtos, indexa todo o catálogo para AI Search e verifica o estado das encomendas dos clientes diretamente na loja Ecwid.

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 com IA - Os clientes descrevem o que procuram com as 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 habitual e o desconto
  • Imagem do produto
  • Ligação direta para a página do produto na sua loja
  • Disponibilidade, SKU, categorias e opções de produto (tamanhos, cores) quando o produto as tiver

Pesquisa de produtos por termo - Uma pesquisa simples por palavras-chave através do motor de busca do Ecwid. A pesquisa de produtos com IA substitui-a automaticamente assim que o catálogo for indexado.

Estado da encomenda - O cliente indica o número da encomenda e o endereço de e-mail utilizado na finalização da compra, e o chatbot responde com o estado do pagamento, o estado do processamento, o método de envio, o número de rastreio e os artigos encomendados. 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.

Categorias - O chatbot pode filtrar a pesquisa por categoria, utilizando a estrutura de categorias da sua loja.

Adicionar ao carrinho - Os cartões de produto no chat podem apresentar um botão Add to cart (Adicionar ao carrinho). Quando o chatbot está a funcionar no seu Instant Site, ou num site onde a sua loja Ecwid esteja incorporada, o botão coloca o produto diretamente no carrinho do Ecwid do cliente. Para produtos com opções como tamanho ou cor, o cliente escolhe primeiro a variante no chat. Em qualquer outro local, e para produtos com opções que o chat não consegue preencher (por exemplo, um campo de texto para gravação), o botão abre a página do produto.

Veja a experiência do carrinho

Para consultar um exemplo do carrinho e instruções de teste na montra da loja, consulte Adicionar produtos ao carrinho. A sequência abaixo é meramente ilustrativa; não executa uma operação real no carrinho do Ecwid.

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

  • Finalização de compra no chat. O cliente conclui a compra na sua loja Ecwid.
  • Alertas de stock em tempo real. Os preços e a disponibilidade são consultados no Ecwid quando o chatbot responde, mas o chatbot não notifica os clientes sobre alterações posteriores.

Requisitos

  • Uma loja Ecwid no plano Venture, Business ou Unlimited. O Ecwid disponibiliza o acesso à API a partir do plano Venture; o plano Starter não pode ser ligado.
  • A integração Ecwid incluída no seu plano ChatLab.
  • Para a pesquisa de produtos com IA: capacidade de AI Search atribuída ao chatbot suficiente para os seus produtos ativos. Verifique a capacidade disponível em Shop > Products (Loja > Produtos).
  • Nenhuma outra integração de loja ligada ao mesmo chatbot.

Passo 1: Obter o Store ID e o token secreto no Ecwid

  1. Inicie sessão no painel de administração do Ecwid.
  2. No menu à esquerda, clique em Apps (Aplicações), depois em My Apps (As minhas aplicações) e abra Develop apps (Desenvolver aplicações) (ou aceda diretamente a https://my.ecwid.com/#develop-apps com a sessão iniciada).
  3. Se ainda não tiver nenhuma aplicação personalizada listada, clique em Create app (Criar aplicação). O Ecwid cria a aplicação com as permissões de que o chatbot necessita: ler o perfil da loja, ler o catálogo e ler as encomendas. Se o ecrã mostrar uma lista de permissões, certifique-se de que estas três estão selecionadas.
  4. Abra a página Details (Detalhes) da aplicação e clique em Show secret token (Mostrar token secreto). Copie o token. Começa com secret_. Não utilize o token público, que começa com public_.
  5. Anote o seu Store ID (ID da loja). É o número apresentado no rodapé de todas as páginas da administração do Ecwid e na barra de endereço do painel.

Mantenha o token secreto privado. Ele concede acesso de leitura ao seu catálogo e às suas encomendas. Pode revogá-lo a qualquer momento desinstalando a aplicação em Apps > My Apps; ao instalá-la novamente, é gerado um novo token.

Passo 2: Ligar a loja no ChatLab

  1. Abra o seu chatbot no ChatLab e aceda a Shop (Loja).
  2. Clique no mosaico Ecwid.
  3. Cole o Store ID e o Secret token (Token secreto).
  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. Se a sua loja tiver mais do que um idioma, selecione o Shop Language (Idioma da loja) que o chatbot deve utilizar para os nomes e descrições dos produtos.
  6. Clique em Connect (Ligar).

O ChatLab testa a ligação e ativa as ações de pesquisa de produtos e estado da encomenda. Quando existe capacidade de AI Search atribuída ao chatbot, a indexação do catálogo começa de imediato e a janela de confirmação apresenta essa informação. O token secreto é guardado de forma encriptada e nunca mais é exibido; deixe o campo do token em branco caso pretenda apenas alterar o idioma.

Passo 3: Configurar as ações

Aceda a Settings > AI Actions (Definições > Ações de IA). Estão disponíveis três ações para o Ecwid:

  • Ecwid - 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.
  • Ecwid - product search - pesquisa por palavras-chave através do motor de busca do Ecwid, 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.
  • Ecwid - order details - consulta do estado da encomenda. A limitação de pedidos e a ocultação de dados pessoais estão disponíveis nas definições da ação.

Todas as ações têm um prompt editável e uma etiqueta de ação apresentada no chat enquanto o chatbot está a processar.

Passo 4: Verificar o catálogo

Abra Training > E-commerce catalog (Treino > 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. Apenas os produtos alterados desde a última execução são reindexados. Os produtos desativados são removidos do índice automaticamente.

Os produtos sem descrição são indexados apenas pelo nome, categorias e atributos. Se os seus produtos não tiverem descrições no Ecwid, adicionar mesmo uma descrição curta melhora significativamente os resultados da pesquisa.

Passo 5: Adicionar o chatbot à sua montra de loja

A integração com o Ecwid associa o chatbot aos dados da sua loja. Para apresentar o chatbot aos seus clientes, adicione o script do ChatLab ao website onde a loja se encontra:

Instant Site (requer o plano Venture, Business ou Unlimited):

  1. No ChatLab, abra o seu chatbot, aceda a Test & Deploy (Testar e implementar), selecione Ecwid e copie o código.
  2. Na administração do Ecwid, aceda a Website > Overview (Website > Vista geral).
  3. Desloque-se para baixo até Advanced website settings (Definições avançadas do website) e clique em Add Code (Adicionar código) por baixo de Custom JavaScript code (Código JavaScript personalizado).
  4. Cole o código no campo que se abre e clique em Save (Guardar).
  5. Atualize o seu Instant Site - o chatbot surge no canto inferior de cada página.

O Ecwid recomenda a secção body (Custom JavaScript code) para widgets de chat. Não utilize Header meta tags and site verification (Meta tags de cabeçalho e verificação do site) nas definições de SEO - esse campo destina-se a tags de verificação.

Loja incorporada noutro website (WordPress, Wix, Squarespace e outros): adicione o código a esse website, exatamente como descrito em Adicionar o chatbot ao seu website. O chatbot surgirá então em todas as páginas desse website, e não apenas na página da loja.

Resolução de problemas

  • "Ecwid rejected the secret token" - O token foi copiado de forma incompleta, ou a aplicação foi desinstalada ou reinstalada no Ecwid, o que gera um novo token. Abra novamente a página Details da aplicação e cole o token atual.
  • "The Ecwid store plan does not include API access" - A loja está no plano Starter. Atualize para o plano Venture ou superior no Ecwid.
  • 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 ativos no Ecwid. Os produtos desativados nunca são devolvidos.
  • A encomenda não é encontrada - O chatbot necessita do endereço de e-mail utilizado na finalização da compra juntamente com o número da encomenda indicado no e-mail de confirmação, incluindo qualquer prefixo ou sufixo que a sua loja adicione aos números das encomendas.