O assistente de compras Mira AI usa seu feed de produtos para recomendar produtos, responder a perguntas sobre preços e verificar a disponibilidade. Este guia explica os formatos de feed aceitos pela Mira AI, as tags que ela lê e onde encontrar as instruções oficiais de exportação das plataformas de e-commerce mais populares.

Dividimos o guia nas seguintes seções:

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

Antes de começar

A Mira AI aceita feeds de produtos XML padrão — o mesmo formato que a maioria das plataformas de e-commerce gera para Heuréka, Google Shopping, Zboží.cz e marketplaces semelhantes. Quanto mais completo for seu feed (preço, disponibilidade, descrição, link, categoria), mais inteligentes serão as recomendações da Mira.

Para adicionar o feed no Smartsupp:

No construtor do assistente, abra Base de conhecimento → Produtos e clique em Adicionar nova fonte.
Insira um nome para a fonte.
Cole a URL completa do seu feed de produtos.
Na etapa Atualização , escolha a frequência de atualização do feed.

Dica: Veja Introdução à Mira AI para a configuração completa.

A Mira AI atualiza automaticamente seu feed de produtos em intervalos regulares — alterações de preço, atualizações de disponibilidade e novos produtos aparecem no chat sem que você precise enviar o arquivo novamente.

Observação: Durante o período de teste, as atualizações automáticas do feed ficam pausadas. Depois de atualizar seu plano, escolha um intervalo de atualização para o feed para ativá-las.

Observação: A Mira AI carrega as imagens dos cartões de produtos diretamente do seu feed XML. Se um produto não tiver imagem no feed, a Mira usa a imagem Open Graph ou a imagem de destaque da página do produto — por isso, vale a pena mantê-las configuradas também.

Observação: Se seu servidor restringir conexões de entrada (firewall, lista de permissões de IP), permita o acesso dos endereços IP do serviço de busca de feeds do Smartsupp: 94.130.187.58 e 188.245.65.74. Caso contrário, a Mira AI não conseguirá baixar seu feed de produtos.

Esses endereços IP podem mudar ocasionalmente. Se seu feed parar de atualizar de repente, consulte este artigo para ver a lista atual ou entre em contato com nosso suporte.

Formatos de feed compatíveis

A Mira AI é compatível com dois formatos padrão de feed de produtos — Heuréka e Google Merchant. Ambos seguem convenções comuns de XML:

A extensão do arquivo é .xml ou .rss.
A primeira linha deve começar com <?xml ...?> ou <rss ...>.
Uma tag pai envolve todos os itens de produtos. A tag pai pode ter qualquer nome (por exemplo, <SHOP>) — só importa que ela exista.
Cada produto é envolvido por sua própria tag de item (veja as seções específicas de cada formato abaixo).

Uma estrutura mínima válida é assim:

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

Importante: Se uma tag obrigatória estiver ausente em um produto, esse produto inteiro será ignorado no índice da Mira — os visitantes não o verão nas recomendações. Certifique-se de que todos os produtos tenham todas as tags obrigatórias preenchidas.

Estrutura do feed Heuréka

Para o formato Heuréka, a Mira AI lê as tags a seguir. Consulte a Documentação oficial do feed XML Heuréka para ver a especificação completa.

Categoria	Tags	Observações
Tag que envolve o item (obrigatória)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Uma dessas tags envolve cada produto.
Descrição (obrigatória)	`PRODUCTNAME` (ou `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Todas as tags devem conter conteúdo. Tags vazias são consideradas ausentes.
Opcional	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = em estoque, 1–7 = disponível em até uma semana, qualquer outro valor / ausente = indisponível. `PARAM` pode se repetir qualquer número de vezes por produto.
Imagem	`IMGURL`	Imagem do produto exibida no cartão. Se estiver ausente, a Mira usa a imagem Open Graph ou a imagem de destaque da página do produto.
Ignoradas	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	A Mira AI ignora essas tags — você pode deixá-las no feed para outras ferramentas.

Uma PARAM tag contém um atributo extra do produto como um par nome–valor:

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

Estrutura do feed Google Merchant

Para o formato Google Merchant, a Mira AI lê as tags a seguir. Consulte a Especificação oficial do feed Google Merchant para ver a referência completa.

Categoria	Tags	Observações
Tag que envolve o item (obrigatória)	`item`, `entry`, `product`	Uma dessas tags envolve cada produto.
Descrição (obrigatória)	`title`, `description`, `product_type` (ou `google_product_category`), `link`, `price`	Para a categoria, use `product_type` ou `google_product_category` com o nome em texto — IDs numéricos de categoria ainda não são aceitos.
Formato do preço	`price`	Formato permitido: `236 CZK` ou `CZK 236`. A moeda é um código de 3 letras (CZK, EUR, GBP…).
Opcional	`availability`	Em estoque: `in_stock`, `in stock`. Indisponível: `out_of_stock`, `out of stock`, `preorder`, `backorder`, qualquer outro valor / ausente.
Imagem	`image_link`	Imagem do produto exibida no cartão. Se estiver ausente, a Mira usa a imagem Open Graph ou a imagem de destaque da página do produto.
Ignoradas	`id`, `gtin`, `checkout_link_template`, `item_group_id`	A Mira AI ignora essas tags — você pode deixá-las no feed para outras ferramentas.

A Mira também lê os tamanhos do seu feed (a tag size ) e pode mencioná-los ao recomendar produtos. Os tamanhos aparecem assim que seu feed é atualizado.

Observação: Os IDs numéricos google_product_category ainda não são aceitos. Sempre use a versão em texto da categoria — por exemplo "Vestuário & acessórios > Roupas > Camisas & blusas" — ou use product_type em vez disso.

Exportar feed por plataforma

Encontre sua plataforma de e-commerce na tabela abaixo e siga o guia oficial de exportação.

Plataforma	O que ela gera	Guia oficial
Shoptet	XML Heuréka & Google Shopping pelo painel administrativo	Feeds XML • XML Heuréka
Shopsys	Feeds de produtos pela plataforma com documentação para desenvolvedores	Feeds de produtos
Eshop-rychle	Feeds para comparadores de preços	Exportação de produtos
Upgates	Exportação de dados XML com a estrutura completa dos produtos	Exportação de dados • Documentação XML
Shoper	Feed de produtos do Google diretamente da plataforma	Feed do Google
Shopware	Google Shopping — exportação direta ou por complementos	Exportação direta • Complementos
Shoprenter	Feeds Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping por complementos	Complementos
Magento	Google Shopping por extensões	Extensões
WooCommerce	Feed de produtos do Google por complementos	Complementos • Recomendado

Quais são os próximos passos?

Introdução ao assistente de compras Mira AI — configure a Mira AI e adicione seu feed de produtos como fonte.
Como começar a treinar a Mira AI — ajuste as respostas da IA com pares personalizados de perguntas&respostas.
Mira AI - disponibilidade em estoque — permita que os visitantes verifiquem se um produto está em estoque.
FAQ do assistente de compras Mira AI — perguntas frequentes sobre a Mira AI.

💡 Precisa de mais ajuda? Entre em contato com nossa Equipe de suporte — teremos prazer em ajudar!

Como exportar feeds de produtos de várias plataformas de e-commerce para o assistente de compras MiraAI?