O Assistente de compras Mira AI utiliza o seu feed de produtos para recomendar produtos, responder a perguntas sobre preços e verificar a disponibilidade. Este guia explica os formatos de feed aceites pelo Mira AI, as etiquetas que lê e onde encontrar as instruções oficiais de exportação para as plataformas de comércio eletrónico mais populares.

Dividimos o guia nas seguintes secções:

Feed ou extração de dados da web não está a funcionar? Resolução de problemas nas 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 comércio eletrónico gera para Heuréka, Google Shopping, Zboží.cz e outros marketplaces semelhantes. Quanto mais completo for o seu feed (preço, disponibilidade, descrição, link, categoria), mais inteligentes serão as recomendações do Mira.

Para adicionar o feed no Smartsupp:

No construtor do assistente, aceda a Base de conhecimento → Produtos e clique em Adicionar.
Insira um nome para a fonte.
Cole o URL completo do seu feed de produtos.
No passo Atualizar, selecione a frequência de atualização do feed.

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

A Mira AI atualiza automaticamente o seu feed de produtos em intervalos regulares — alterações de preço, atualizações de disponibilidade e novos produtos aparecem no chat sem que seja necessário reenviar o ficheiro.

Nota: A Mira AI carrega imagens dos cartões de produtos diretamente do seu feed XML. Se um produto não tiver imagem no feed, a Mira utiliza a imagem Open Graph ou uma imagem destacada da página do produto — por isso, é recomendável configurar esses elementos também.

Nota: Se o seu servidor restringir conexões de entrada (firewall, lista de permissões de IPs), garanta o acesso a partir dos endereços IP do coletor de feeds da Smartsupp: 94.130.187.58 e 188.245.65.74. Caso contrário, o Mira AI não conseguirá descarregar o seu feed de produtos.

Estes endereços IP podem ocasionalmente ser alterados. Se o seu feed deixar de ser atualizado de repente, consulte este artigo para a lista atual ou contacte o nosso suporte.

Formatos de feed suportados

O Mira AI suporta dois formatos standard de feed de produtos — Heuréka e Google Merchant. Ambos seguem convenções XML comuns:

A extensão do ficheiro é .xml ou .rss.
A primeira linha tem de começar com <?xml ...?> ou <rss ...>.
Uma etiqueta principal envolve todos os itens de produto. O nome desta etiqueta principal pode ser qualquer um (por exemplo, <SHOP>) — o importante é que exista.
Cada produto está envolvido pela sua própria etiqueta de item (consulte as secções específicas de formato abaixo).

Uma estrutura mínima válida é a seguinte:

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

Importante: Se faltar uma etiqueta obrigatória num produto, esse produto será ignorado no índice do Mira — os visitantes não o verão nas recomendações. Certifique-se de que todos os produtos têm todas as etiquetas obrigatórias preenchidas.

Estrutura do feed Heuréka

Para o formato Heuréka, o Mira AI lê as seguintes etiquetas. Consulte a documentação oficial do feed XML Heuréka para a especificação completa.

Categoria	Etiquetas	Notas
Envoltório do item (obrigatório)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Cada produto é envolvido por uma destas etiquetas.
Descrição (obrigatório)	`PRODUCTNAME` (ou `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Todas as etiquetas têm de conter conteúdo. Etiquetas vazias são consideradas como ausentes.
Voluntário	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = em stock, 1–7 = disponível em até uma semana, qualquer outro valor / ausente = indisponível. `PARAM` pode repetir-se várias vezes por produto.
Imagem	`IMGURL`	Imagem do produto apresentada no cartão. Se estiver ausente, o Mira utiliza a imagem Open Graph ou uma imagem destacada da página do produto.
Ignorado	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	O Mira AI ignora estas etiquetas — pode mantê-las no feed para outras ferramentas.

Uma etiqueta PARAM transporta 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

Para o formato Google Merchant, o Mira AI lê as seguintes etiquetas. Consulte a especificação oficial do feed Google Merchant para a referência completa.

Categoria	Etiquetas	Notas
Envoltório do item (obrigatório)	`item`, `entry`, `product`	Uma destas etiquetas envolve cada produto.
Descrição (obrigatório)	`title`, `description`, `product_type` (ou `google_product_category`), `link`, `price`	Para a categoria, utilize `product_type` ou `google_product_category` com o nome em texto — os IDs numéricos de categorias ainda não são suportados.
Formato do preço	`price`	Formato permitido: `236 CZK` ou `CZK 236`. A moeda deve ser um código de 3 letras (CZK, EUR, GBP…).
Preço em promoção (opcional)	`sale_price`, `sale_price_effective_date`	Se `sale_price` estiver presente, na mesma moeda e inferior a `price`, o Mira apresenta o preço promocional em respostas, pesquisas de produtos e nos cartões do produto. Com `sale_price_effective_date` o preço promocional é utilizado apenas nesse intervalo de datas (verificado no momento da questão); fora desse intervalo, ou se não for possível ler o intervalo, o Mira usará o preço normal. Feeds existentes captam preços promocionais na próxima atualização.
Voluntário	`availability`	Em stock: `in_stock`, `in stock`. Indisponível: `out_of_stock`, `out of stock`, `preorder`, `backorder`, qualquer outro valor / ausente.
Imagem	`image_link`	Imagem do produto apresentada no cartão. Se estiver ausente, o Mira utiliza a imagem Open Graph ou uma imagem destacada da página do produto.
Ignorado	`id`, `gtin`, `checkout_link_template`, `item_group_id`	O Mira AI ignora estas etiquetas — pode mantê-las no feed para outras ferramentas.

O Mira também lê os tamanhos dos produtos no seu feed (etiqueta size) e pode mencioná-los ao recomendar produtos. Os tamanhos aparecem assim que o feed é atualizado.

Nota: IDs numéricos em google_product_category ainda não são suportados. Utilize sempre a versão em texto da categoria — por exemplo "Apparel & Accessories > Clothing > Shirts & Tops" — ou utilize product_type.

Exportar feed por plataforma

Encontre a sua plataforma de comércio eletrónico na tabela abaixo e siga o guia oficial de exportação.

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

E agora?

Introdução ao Assistente de compras Mira AI — configurar o Mira AI e adicionar o seu feed de produtos como uma fonte.
Como iniciar o treino do Mira AI — ajustar as respostas da IA com pares personalizados de perguntas e respostas.
Mira AI - disponibilidade de stock — permitir que os visitantes verifiquem se um produto está em stock.
Assistente de compras Mira AI - FAQ — perguntas frequentes sobre o Mira AI.

💡 Precisa de mais ajuda? Contacte a nossa equipa de suporte — teremos todo o gosto em ajudar!

Como exportar feeds de produtos de várias plataformas de comércio eletrónico para o Assistente de compras Mira AI?