Passar para o conteúdo principal

Como exportar feeds de produtos de várias plataformas de e-commerce para o Assistente de compras Mira AI?

Veja como exportar feeds de produtos das principais plataformas de e-commerce e conectar ao Assistente de compras Mira AI para ativar recomendações inteligentes de produtos.

Escrito por Michal Jindra

O Assistente de compras Mira AI usa seu feed de produtos para recomendar produtos, responder perguntas sobre preços e consultar disponibilidade. Aqui você vai entender quais formatos de feed a Mira AI aceita, as tags que ela lê e onde acessar instruções oficiais de exportação para as plataformas de e-commerce mais conhecidas.

Dividimos o guia nestas partes:

O feed ou web scraping não está funcionando? Veja como solucionar problemas das fontes de conhecimento da Mira AI


Antes de começar

A Mira AI trabalha com feeds de produtos padrão em XML — o mesmo modelo que a maioria das plataformas de e-commerce gera para Heuréka, Google Shopping, Zboží.cz e outros marketplaces. Quanto mais completo seu feed (preço, disponibilidade, descrição, link, categoria), melhores as recomendações que a Mira faz.


​
​

Veja como adicionar o feed no Smartsupp:

  1. No construtor do assistente, vá em Base de conhecimento → Produtos e clique em Adicionar.

  2. Escolha um nome para a fonte.

  3. Cole o URL completo do seu feed de produtos.

  4. Na etapa Atualizar, defina com que frequência o feed será atualizado.


​

Dica: Confira a Introdução ao Mira AI para entender toda a configuração.


​

A Mira AI busca as atualizações do seu feed de produtos de tempos em tempos — qualquer ajuste de preço, disponibilidade ou produto novo aparece automaticamente no chat, sem você precisar enviar o arquivo de novo.

Importante: A Mira AI pega as imagens dos cartões dos produtos diretamente do seu feed XML. Se algum produto não tiver imagem no feed, a Mira busca a imagem Open Graph ou a imagem destacada da página do produto — então vale a pena deixar essas imagens certinhas também.

Observação: Se o seu servidor bloqueia conexões de fora (firewall, lista de IPs permitidos), libere o acesso para esses IPs do buscador de feeds do Smartsupp: 94.130.187.58 e 188.245.65.74. Caso contrário, a Mira AI não consegue baixar seu feed de produtos.

Esses IPs podem mudar de vez em quando. Se o feed parar de atualizar do nada, confira este artigo para ver a lista nova ou fale com o nosso suporte.


Formatos de feed suportados

A Mira AI trabalha com dois formatos principais de feed de produtos: Heuréka e Google Merchant. Ambos usam padrões comuns de XML:

  • O arquivo tem extensão .xml ou .rss.

  • A primeira linha precisa ser <?xml ...?> ou <rss ...>.

  • Todos os produtos são agrupados por uma tag principal — que pode ter qualquer nome (como <SHOP>). O importante é existir uma tag mãe.

  • Cada produto fica dentro da sua própria tag (veja cada formato nos tópicos abaixo).

Um exemplo mínimo e válido de esqueleto:

<?xml version="1.0" encoding="UTF-8"?>
<SHOP>
<SHOPITEM> ... </SHOPITEM>
<SHOPITEM> ... </SHOPITEM>
</SHOP>

Importante: Se faltar alguma tag obrigatória em um produto, esse item fica de fora do índice da Mira — os visitantes não vão ver esse produto nas recomendações. Por isso, preencha todas as tags obrigatórias em todos os produtos.


Estrutura do feed Heuréka

No formato Heuréka, a Mira AI lê estas tags. Veja a documentação oficial do feed XML da Heuréka para detalhes.

Categoria

Tags

Observações

Item wrapper (obrigatório)

SHOPITEM, PRODUCT, PRODUKT

Uma dessas tags deve envolver cada produto.

Descrição (obrigatório)

PRODUCTNAME (ou PRODUCT), DESCRIPTION, URL, PRICE_VAT, CATEGORYTEXT

Cada uma precisa estar preenchida — tag vazia conta como ausência.

Opcional

DELIVERY_DATE, PARAM

DELIVERY_DATE: 0 = em estoque, 1–7 = até uma semana, qualquer outro valor/ausente = sem estoque. PARAM pode aparecer quantas vezes precisar para cada produto.

Imagem

IMGURL

Imagem do produto no cartão. Se não tiver, a Mira pega imagem Open Graph ou destacada da página do produto.

Ignorados

DELIVERY, EAN, ITEM_ID, VAT, ITEMGROUP_ID, ACCESSORY, MANUFACTURER

A Mira AI ignora essas tags — pode deixar no feed para outras ferramentas.

A tag PARAM permite indicar um atributo do produto no esquema nome–valor, tipo:

<PARAM>
<PARAM_NAME>Largura</PARAM_NAME>
<VAL>100–109 cm</VAL>
</PARAM>


Estrutura do feed Google Merchant

No padrão Google Merchant, a Mira AI lê estas tags. Veja a especificação oficial do feed do Google Merchant para detalhes completos.

Categoria

Tags

Observações

Item wrapper (obrigatório)

item, entry, product

Uma dessas tags envolve cada produto.

Descrição (obrigatório)

title, description, product_type (ou google_product_category), link, price

Para categoria, use product_type ou google_product_category com o nome por extenso — não é suportado ID numérico de categoria ainda.

Formato de preço

price

Formatos aceitos: 236 CZK ou CZK 236. A moeda é um código de 3 letras (CZK, EUR, GBP...)

Preço promocional (opcional)

sale_price, sale_price_effective_date

Se sale_price existir, na mesma moeda e menor que o price, a Mira mostra o valor promocional nas respostas e buscas. Com sale_price_effective_date, o preço promocional aparece só durante o período definido; fora disso, ou se não der pra ler, a Mira usa o preço normal. Feeds conectados pegam preços promocionais na próxima atualização.

Opcional

availability

Em estoque: in_stock, in stock. Fora de estoque: out_of_stock, out of stock, preorder, backorder, qualquer outro valor ou ausência.

Imagem

image_link

Imagem do produto para o cartão. Se faltar, a Mira usa imagem Open Graph ou destacada da página.

Ignorados

id, gtin, checkout_link_template, item_group_id

A Mira AI ignora essas tags — pode manter no feed para outras ferramentas.

A Mira também lê tamanhos do produto do feed (pela tag size) e pode citar isso nas recomendações. Os tamanhos aparecem assim que você atualizar o feed.

Observação: IDs numéricos em google_product_category ainda não são suportados. Sempre use texto para a categoria — por exemplo, "Apparel & Accessories > Clothing > Shirts & Tops" — ou use product_type.


Exportar feed por plataforma

Encontre sua plataforma de e-commerce na tabela abaixo e siga o passo a passo oficial para exportar.

Plataforma

O que ela gera

Guia oficial

Shoptet

Heuréka & Google Shopping XML pelo painel

Shopsys

Feeds via plataforma com guia para desenvolvedores

Eshop-rychle

Feeds para comparadores de preços

Upgates

Exporta dados XML com estrutura completa do produto

Shoper

Feed do Google na própria plataforma

Shopware

Google Shopping – exportação direta ou via complementos

Shoprenter

Feeds para Google Shopping & Heuréka

PrestaShop

Google Shopping via complementos

Magento

Google Shopping via extensões

WooCommerce

Feed Google via complementos


E agora?

💡 Precisa de ajuda? Converse com nossa equipe de suporte — a gente te ajuda rapidinho!

Respondeu à sua pergunta?