Integração com um feed de produtos (XML, Google Merchant)

Ligue qualquer loja online ao seu chatbot do ChatLab através de um feed de produtos. Se a sua plataforma não tiver uma integração nativa com o ChatLab, o feed é a forma de fornecer o seu catálogo ao chatbot: lê os produtos a partir do feed, indexa-os com o AI Search e responde com cartões de produtos que direcionam para a sua loja.

Exemplo de conversa

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 de e-commerce

Depois de concluir a integração abaixo, leia o guia completo 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 disponibiliza

Pesquisa de produtos com IA - Os clientes descrevem o que precisam pelas suas próprias palavras e o chatbot encontra produtos correspondentes no seu catálogo. A resposta contém:

• Nome e descrição do produto
• Preço (e preço promocional quando o feed o incluir)
• Imagem do produto
• Ligação direta para a página do produto na sua loja
• Marca, disponibilidade, GTIN / SKU e outros atributos do feed

Categorias - Quando o feed inclui o tipo de produto (por exemplo, "Casa > Cozinha > Chaleiras"), o chatbot pode restringir a pesquisa a uma categoria.

Atualização agendada - O catálogo é atualizado de acordo com o calendário definido, para que novos produtos, preços e disponibilidades cheguem ao chatbot sem a sua intervenção.

O que a integração não disponibiliza

O feed é um ficheiro e não uma ligação em direto à sua loja, pelo que o chatbot não consegue:

• verificar o estado de uma encomenda
• adicionar produtos ao carrinho ou efetuar uma encomenda
• ler os níveis de stock em tempo real entre atualizações

Os cartões de produtos com um URL de produto válido encaminham para a sua loja, onde o cliente conclui a compra. Para o acompanhamento de encomendas, escolha uma integração nativa que suporte essa funcionalidade. O suporte para adicionar ao carrinho também depende da plataforma e da configuração da loja; não se encontra disponível em todas as integrações nativas.

Requisitos

• A integração Feed XML incluída no seu plano
• Acesso ao AI Search e capacidade de catálogo atribuída ao chatbot: consulte Shop > Products (Loja > Produtos) para verificar a capacidade disponível
• Nenhuma outra integração de loja associada ao mesmo bot. Reveja as consequências antes de desligar uma loja existente.
• Um feed de produtos no formato XML do Google Merchant (Google Shopping), disponível num endereço https público. São suportados feeds comprimidos (.gz) e feeds protegidos por nome de utilizador e palavra-passe.

Passo 1: Obter o feed de produtos da sua loja

Peça ao administrador da sua loja um feed de produtos em XML com os campos do Google Merchant. A geração do feed e eventuais custos de extensões dependem da sua plataforma:

• Magento / Adobe Commerce - uma extensão de feed do Google Shopping (por exemplo, do Magento Marketplace) gera o XML num endereço como https://yourstore.com/feeds/google.xml
• IdoSell - abra MARKETING > Produkty i reklamy w Google > Feed produktowy dla Google Shopping do samodzielnego zarządzania reklamami e obtenha o URL do feed. Confirme que o ChatLab consegue descarregá-lo, uma vez que alguns feeds restringem o acesso apenas ao serviço designado. Consulte o guia do Google Shopping da IdoSell e as restrições de acesso ao feed.
• OpenCart - se a sua versão incluir a extensão de feed Google Base, ative-a nas extensões de feeds e copie o respetivo URL de feed de dados; caso contrário, utilize uma extensão de exportação XML compatível
• BigCommerce - obtenha um URL de XML descarregável a partir da sua aplicação de exportação de feed. Uma simples ligação ao canal da Google não é o Feed URL de que o ChatLab necessita
• Shopware 6 - adicione um canal de vendas Product comparison (Comparação de produtos), escolha Google Shopping (XML) como modelo, configure a exportação e copie o respetivo URL. Consulte o guia de exportação da Shopware.
• osCommerce e lojas personalizadas - qualquer módulo que gere um feed RSS 2.0 ou Atom com os atributos de produto g:

Todos os produtos indexados necessitam de um identificador exclusivo (g:id por predefinição). Um nome e uma ligação para o produto são vivamente recomendados: na falta de um nome, é utilizado o identificador como alternativa e, na falta de uma ligação, não é possível criar uma ligação funcional para a loja. O preço, a imagem, a descrição, a disponibilidade e o tipo de produto melhoram significativamente a qualidade das respostas.

Passo 2: ligar o feed no ChatLab

1. Inicie sessão no ChatLab e selecione o seu bot
2. Aceda ao separador Connect (Ligar)
3. Clique em Connect (Ligar) no mosaico Feed XML
4. Cole o Feed URL (URL do feed)
5. Se o feed exigir autenticação, ative a opção The feed requires a username and password (O feed requer um nome de utilizador e palavra-passe) e insira as credenciais
6. Opcionalmente, defina o Product language (Idioma dos produtos - código de duas letras do idioma utilizado no feed)
7. Clique em Test feed (Testar feed) - o ChatLab descarrega o início do feed e apresenta o formato, uma contagem prévia (até 2 000 itens, não necessariamente o total do feed), até cinco produtos de exemplo e eventuais avisos (falta de preços, ligações, imagens ou categorias)
8. Clique em Connect (Ligar)

Se a autoindexação do catálogo estiver ativa e o bot tiver o acesso e a capacidade necessários no AI Search, a configuração da ligação inicia a indexação em segundo plano. Caso contrário, treine o catálogo manualmente. Acompanhe o progresso e eventuais erros em Shop > Products (Loja > Produtos) ou Training > E-commerce catalog (Treino > Catálogo de e-commerce); o sucesso da ligação por si só não significa que os produtos já possam ser pesquisados.

Passo 3: feeds não normalizados (mapeamento de campos)

Se o seu feed não estiver no formato do Google Merchant, o ChatLab continuará a conseguir lê-lo:

1. Execute primeiro o Test feed (Testar feed) - os nomes dos elementos detetados no ficheiro surgirão nos menus de seleção do mapeamento
2. Abra a secção Field mapping for non-standard feeds (Mapeamento de campos para feeds não standard)
3. Se um produto não corresponder a um elemento item ou entry, insira o nome em Product element (Elemento do produto)
4. Escolha o elemento para cada campo: Product identifier (Identificador do produto - obrigatório), Product name (Nome do produto), Description (Descrição), Product page URL (URL da página do produto), Image URL (URL da imagem), Price (Preço), Category path (Caminho da categoria) e os restantes
5. Clique novamente em Test feed (Testar feed) e verifique os produtos de amostra
6. Clique em Connect (Ligar)

Os campos mantidos em "Default (Google Merchant)" preservam os nomes standard, pelo que um feed que siga a norma não necessita de qualquer mapeamento.

Passo 4: calendário de atualização

1. Aceda a Training > E-commerce catalog (Treino > Catálogo de e-commerce)
2. No cartão Feed XML, clique em Retrain (Treinar novamente)
3. A opção Retrain now! (Treinar novamente agora!) atualiza o catálogo de imediato
4. Para atualizar de forma automática, selecione a frequência (todos os dias, uma vez por semana ou uma vez por mês), o dia e a hora, e clique em Schedule retrain (Agendar novo treino)

Apenas os produtos alterados desde a última atualização são reindexados, e os produtos removidos do feed são eliminados do catálogo do chatbot. A atualização agendada depende do seu plano: os agendamentos semanais e mensais requerem a funcionalidade de novo treino agendado; os agendamentos diários requerem a funcionalidade de novo treino diário.

Passo 5: configurar a ação de IA

Com a autoindexação do catálogo ativa e o acesso necessário, a configuração da ligação ativa automaticamente a ação Feed XML - AI product search (Feed XML - Pesquisa de produtos com IA). Caso contrário, ative-a manualmente e treine o catálogo. Para ajustar as suas configurações, aceda a Settings > Actions (Definições > Ações) e filtre pela plataforma Feed XML. Pode alterar o nome da ação, as instruções fornecidas à IA e ativar a opção Include product card (Incluir cartão do produto) para facultar ao chatbot o cartão de produto completo em vez da descrição abreviada.

Testar a sua integração

Abra o widget do seu chatbot e teste:

• "Mostre-me chaleiras abaixo de 50 dólares" (testa a pesquisa com filtro de preço)
• "Tem t-shirts azuis de algodão?" (testa a correspondência de atributos)

As respostas devem apresentar produtos do seu feed com ligações para a sua loja.

Dicas

• Indique o tipo de produto no feed (g:product_type) através do caminho completo, por exemplo "Vestuário > Homem > T-Shirts" - este passará a ser a categoria pela qual o chatbot pode filtrar
• Mantenha as descrições no feed completas; o chatbot utiliza-as para encontrar respostas para as perguntas dos clientes
• As variantes do mesmo produto devem partilhar um item_group_id - o ChatLab agrega os atributos de cor, tamanho, material e padrão num único produto indexado. O primeiro item determina o preço e o link do grupo, pelo que deve verificar os detalhes específicos das variantes na sua loja
• Se o seu feed for extenso, um feed comprimido (.gz) é descarregado muito mais rapidamente

Instalar o chatbot na sua loja

Para adicionar o widget de chat à sua loja:

1. No ChatLab, aceda ao separador Deploy (Publicar) do seu bot
2. Selecione Widget e copie o fragmento de código
3. Cole-o no modelo da sua loja, antes da etiqueta de fecho </body>, ou utilize a secção de "HTML personalizado" ou "scripts" da sua plataforma

Artigos relacionados

• Guia de configuração para e-commerce
• Adicionar o chatbot ao seu website