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

Dividimos o guia nos seguintes tópicos:

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

Antes de começar

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

Para adicionar o feed no Smartsupp:

No construtor da assistente, abra Base de Conhecimento → Produtos e clique em Adicionar.
Digite um nome para a fonte.
Cole a URL completa do seu feed de produtos.
Na etapa Atualizar, escolha com que frequência o feed deve ser atualizado.

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

A Assistente de Compras 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 você precisar reenviar o arquivo.

Observação: A Assistente de Compras Mira AI carrega imagens dos cards dos produtos diretamente do seu feed XML. Se um produto não tiver imagem no feed, a Assistente de Compras Mira AI buscará a imagem Open Graph ou a imagem destaque da página do produto — então vale a pena garantir que elas estejam configuradas também.

Observação: Se o seu servidor restringir conexões recebidas (firewall, lista de permissões de IP), permita o acesso pelos IPs do feed-fetcher do Smartsupp: 94.130.187.58 e 188.245.65.74. Caso contrário, a Assistente de Compras 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, confira este artigo para ver a lista atual ou entre em contato com nosso suporte.

Formatos de feed suportados

A Assistente de Compras Mira AI suporta dois formatos padrão de feeds 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 precisa começar com <?xml ...?> ou <rss ...>.
Uma tag pai envolve todos os itens de produtos. O nome da tag pai pode ser qualquer um (ex.: <SHOP>) — importante é sua presença.
Cada produto é envolvido por sua própria tag de item (veja as seções específicas de formato abaixo).

Um esqueleto mínimo válido fica assim:

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

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

Estrutura do feed Heuréka

No formato Heuréka, a Assistente de Compras Mira AI lê as tags abaixo. Consulte a documentação oficial do feed XML do Heuréka para a especificação completa.

Categoria	Tags	Notas
Envoltório do item (obrigatório)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Uma dessas tags envolve cada produto.
Descrição (obrigatório)	`PRODUCTNAME` (ou `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Cada tag precisa conter um valor. Tags vazias contam como faltantes.
Voluntário	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = em estoque, 1–7 = disponível em até uma semana, qualquer outro valor / ausente = indisponível. `PARAM` pode ser repetido quantas vezes quiser por produto.
Imagem	`IMGURL`	Imagem do produto exibida no card. Se estiver faltando, a Assistente de Compras Mira AI busca a imagem Open Graph ou a imagem destaque da página do produto.
Ignorado	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	A Assistente de Compras Mira AI ignora essas tags — você pode deixá-las no feed para outras ferramentas.

A tag PARAM traz um atributo extra do produto como um par nome–valor:

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

Estrutura do feed Google Merchant

No formato Google Merchant, a Assistente de Compras Mira AI lê as tags abaixo. Consulte a especificação oficial do feed do Google Merchant para referência completa.

Categoria	Tags	Notas
Envoltório do item (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 em texto — IDs numéricos de categoria ainda não são suportados.
Formato de preço	`price`	Formato permitido: `236 CZK` ou `CZK 236`. Separadores decimal e de milhar também são aceitos, por exemplo `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` ou `1 049,00 CHF`. A moeda é um código de 3 letras (CZK, EUR, GBP…).
Preço promocional (opcional)	`sale_price`, `sale_price_effective_date`	Se `sale_price` estiver presente, na mesma moeda e menor que `price`, a Assistente de Compras Mira AI informa o preço promocional em respostas, buscas e cards do produto. Com `sale_price_effective_date`, o preço promocional é usado apenas na faixa de datas indicada (verificada no momento da pergunta); fora do período, ou se não for possível ler o intervalo, a Assistente de Compras Mira AI usa o preço normal. Feeds existentes assumem preços promocionais na próxima atualização.
Voluntário	`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 card. Se estiver faltando, a Assistente de Compras Mira AI busca a imagem Open Graph ou a imagem destaque da página do produto.
Ignorado	`id`, `gtin`, `checkout_link_template`, `item_group_id`	A Assistente de Compras Mira AI ignora essas tags — você pode deixá-las no feed para outras ferramentas.

A Assistente de Compras Mira AI também lê tamanhos dos produtos do seu feed (a tag size) e pode mencioná-los ao recomendar produtos. Os tamanhos aparecem após a atualização do seu feed.

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

Exportar feed por plataforma

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

Plataforma	O que gera	Guia oficial
Shoptet	Heuréka & Google Shopping XML pelo painel de administração	XML Feeds • Heuréka XML
Shopsys	Feeds de produtos pela plataforma com docs para desenvolvedores	Product Feeds
Eshop-rychle	Feeds para comparadores de preços	Exportação de produtos
Upgates	Exportação de dados em XML com toda a estrutura de produto	Exportação de dados • Documentação XML
Shoper	Feed do Google direto pela plataforma	Google Feed
Shopware	Google Shopping — exportação direta ou via complementos	Exportação Direta • Complementos
Shoprenter	Feeds do Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping por complementos	Complementos
Magento	Google Shopping por extensões	Extensões
WooCommerce	Google Product Feed por complementos	Complementos • Recomendado

E agora?

Introdução à Assistente de Compras Mira AI — configure a Assistente de Compras Mira AI e adicione seu feed de produtos como fonte.
Como começar a treinar a Assistente de Compras Mira AI — ajuste as respostas da IA com pares personalizados de perguntas e respostas.
Assistente de Compras Mira AI - disponibilidade em estoque — permite aos visitantes consultar se um produto está em estoque.
FAQ da Assistente de Compras Mira AI — perguntas frequentes sobre a Assistente de Compras Mira AI.

💡 Precisa de mais ajuda? Fale com nossa equipe de suporte — vamos ajudar você com prazer!

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