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 do ChatLab, o feed é a forma de disponibilizar o catálogo ao chatbot: lê os produtos a partir do feed, indexa-os com o AI Search e responde com cartões de produto com ligação para a sua loja.

Importante: Melhores Práticas de E-commerce

Após 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 procuram por palavras próprias e o chatbot encontra os produtos correspondentes no catálogo. A resposta contém:

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

Categorias - Se o feed contiver 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, garantindo que novos produtos, preços e disponibilidade cheguem ao chatbot sem intervenção manual.

O Que a Integração Não Oferece

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

• verificar o estado de uma encomenda
• adicionar produtos ao carrinho ou concluir uma encomenda
• consultar o nível de stock em tempo real entre atualizações

Os cartões de produto incluem sempre ligações para a sua loja, onde o cliente finaliza a compra. Se precisar de acompanhamento de encomendas ou de adição ao carrinho, utilize uma integração nativa.

Requisitos

• A integração Feed XML incluída no seu plano
• O AI Search product pack (pacote de produtos AI Search) atribuído ao chatbot: define quantos produtos podem ser indexados
• Um feed de produtos no formato XML do Google Merchant (Google Shopping), acessível através de um endereço https público. São suportados feeds comprimidos (.gz) e feeds protegidos por utilizador e palavra-passe.

Passo 1: Obter o Feed de Produtos da Sua Loja

A maioria das plataformas exporta um feed do Google Merchant de forma nativa ou através de uma extensão gratuita:

• Magento / Adobe Commerce - uma extensão de feed do Google Shopping (por exemplo, a partir do Magento Marketplace) gera o XML num endereço como https://yourstore.com/feeds/google.xml
• IdoSell - Marketing e integrações, Comparadores de preços e marketplaces, Google Merchant: ative o feed e copie o respetivo endereço
• OpenCart - Extensões, Feeds, Google Base: ative-o e copie o URL do feed de dados
• BigCommerce - Channel Manager, Google Shopping ou uma aplicação de feed a partir do BigCommerce App Marketplace
• Shopware - Marketing, Comparações de produtos, Google Shopping: crie a exportação e copie o respetivo URL
• osCommerce e lojas personalizadas - qualquer módulo que crie um feed RSS 2.0 ou Atom com os atributos de produto g:

O feed deve conter, no mínimo, o identificador do produto (g:id), o nome e a ligação. Preço, imagem, descrição, disponibilidade e tipo de produto melhoram substancialmente 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 introduza 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, o número de produtos encontrados, os primeiros produtos tal como serão indexados e eventuais avisos (preços, ligações, imagens ou categorias em falta)
8. Clique em Connect (Ligar)

Após uma ligação bem-sucedida, o ChatLab inicia a indexação do catálogo em segundo plano. Consoante o tamanho do feed, este processo demora entre um minuto e algumas dezenas de minutos. Pode acompanhar o progresso em Training > E-commerce catalog (Treino > Catálogo de e-commerce).

Passo 3: Feeds Não Standard (Mapeamento de Campos)

Se o seu feed não estiver no formato do Google Merchant, o ChatLab consegue processá-lo na mesma:

1. Execute primeiro o Test feed (Testar feed) - os nomes dos elementos encontrados no ficheiro surgirão nos seletores de mapeamento
2. Abra a secção Field mapping for non-standard feeds (Mapeamento de campos para feeds não standard)
3. Se cada produto não corresponder a um elemento item ou entry, introduza o nome do Product element (Elemento do produto)
4. Selecione 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 restantes campos
5. Execute novamente o Test feed (Testar feed) e verifique os produtos de exemplo
6. Clique em Connect (Ligar)

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

Passo 4: Agendamento de Atualizações

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 automaticamente, selecione a frequência (diária, semanal ou mensal), 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. O agendamento da atualização depende do seu plano: os agendamentos semanais e mensais requerem a funcionalidade de novo treino agendado, e os diários requerem a funcionalidade de novo treino diário.

Passo 5: Configurar a Ação de IA

Após a ligação, a ação Feed XML - AI product search é ativada automaticamente para chatbots com o produto AI Search. Para ajustá-la, aceda a Settings > Actions (Definições > Ações) e filtre pela plataforma Feed XML. Pode alterar a etiqueta da ação, as instruções fornecidas à IA e ativar a opção Include product card (Incluir cartão de produto) para disponibilizar ao chatbot o cartão de produto completo em vez da descrição curta.

Testar a Sua Integração

Abra o widget do seu chatbot e experimente:

• "Mostra-me chaleiras por menos de 50 euros" (testa a pesquisa com filtro de preço)
• "Têm t-shirts azuis de algodão?" (testa a correspondência por atributos)

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

Dicas

• Indique o tipo de produto no feed (g:product_type) como um caminho completo, por exemplo "Vestuário > Homem > T-Shirts" - este valor passa a ser a categoria pela qual o chatbot pode filtrar
• Mantenha as descrições completas no feed; o chatbot recorre a elas para fazer a correspondência com as perguntas dos clientes
• As variantes de um mesmo produto devem partilhar o mesmo item_group_id - o ChatLab apresenta-as como um único produto com todas as cores e tamanhos
• Se o feed for extenso, um feed comprimido (.gz) é transferido mais rapidamente

Instalar o Chatbot na Sua Loja

Para adicionar o widget de chat à sua loja:

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