O Assistente de compras Mira AI utiliza o feed de produtos para sugerir itens, responder a perguntas sobre preços e consultar disponibilidade em tempo real. Neste guia, são explicados os formatos de feed compatíveis com o Mira AI, as etiquetas que são lidas e onde encontrar as instruções oficiais de exportação das plataformas de comércio eletrónico mais conhecidas.

O guia está organizado nas seguintes secções:

O feed ou a extração de dados da web não funciona? Resolução de problemas de fontes de conhecimento Mira AI

Antes de começar

O Mira AI aceita feeds de produtos XML padrão — o mesmo tipo de ficheiro que a maioria das plataformas de comércio eletrónico gera para Heuréka, Google Shopping, Zboží.cz e outros marketplaces. Quanto mais completo for o feed (preço, disponibilidade, descrição, link, categoria), mais inteligentes serão as recomendações do Mira AI.

Para adicionar o feed no Smartsupp:

No construtor do assistente, abra Base de conhecimento → Produtos e clique em Adicionar.
Defina um nome para a fonte.
Cole o URL completo do feed de produtos.
Na etapa Atualizar, escolha com que frequência o feed será atualizado.

Dica: Veja o artigo Introdução ao Mira AI para ver todo o processo de configuração.

O Mira AI faz a atualização automática do feed de produtos em intervalos regulares — alterações de preço, disponibilidade e novos produtos aparecem no chat sem ser necessário carregar novamente o ficheiro.

Nota: O Mira AI carrega as imagens dos cartões de produto diretamente do feed XML. Se um produto não tiver imagem no feed, o Mira recorre à imagem Open Graph ou à imagem destacada na página do produto — mantenha estas imagens configuradas.

Nota: Se o servidor restringir ligações externas (por firewall ou lista de permissões de IP), garanta a autorização dos endereços IP da Smartsupp: 94.130.187.58 e 188.245.65.74. Caso contrário, o Mira AI não conseguirá descarregar o feed de produtos.

Os endereços IP podem mudar ocasionalmente. Se o feed deixar de atualizar de repente, consulte este artigo para a lista atualizada ou entre em contacto com o suporte.

Formatos de feed aceites

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

A extensão do ficheiro é .xml ou .rss.
A primeira linha começa com <?xml ...?> ou <rss ...>.
Uma etiqueta principal envolve todos os produtos. O nome da etiqueta pode variar (ex.: <SHOP>) — apenas a existência é importante.
Cada produto deve estar na sua própria etiqueta de item (veja abaixo nas secções de cada formato).

Exemplo de estrutura mínima válida:

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

Importante: Se faltar uma etiqueta obrigatória num produto, ele será excluído do índice do Mira AI — os visitantes não o verão nas recomendações. Certifique-se de que todos os produtos incluem todas as etiquetas obrigatórias.

Estrutura do feed Heuréka

No formato Heuréka, o Mira AI lê as seguintes etiquetas. Veja a documentação oficial do feed XML da Heuréka para todos os detalhes.

Categoria	Etiquetas	Notas
Envolvimento do item (obrigatório)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Uma destas etiquetas envolve cada produto.
Descrição (obrigatório)	`PRODUCTNAME` (ou `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Todas as etiquetas devem conter valor — etiquetas vazias são consideradas ausentes.
Opcional	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = em stock, 1–7 = disponível em até uma semana, outros valores/ausente = indisponível. `PARAM` pode repetir-se várias vezes por produto.
Imagem	`IMGURL`	Imagem do produto exibida no cartão. Se ausente, o Mira recorre à imagem Open Graph ou à 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.

A etiqueta PARAM transporta um atributo de produto adicional 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, o Mira AI lê as seguintes etiquetas. Veja a especificação oficial do feed Google Merchant para referência completa.

Categoria	Etiquetas	Notas
Envolvimento 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 categoria, utilize `product_type` ou `google_product_category` em texto — IDs numéricos de categoria ainda não são suportados.
Formato do preço	`price`	Exemplo de formato: `236 CZK` ou `CZK 236`. São aceites diversos separadores decimais ou de milhares: `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` ou `1 049,00 CHF`. Moeda: código de 3 letras (CZK, EUR, GBP…).
Preço promocional (opcional)	`sale_price`, `sale_price_effective_date`	Se existir `sale_price`, na mesma moeda e inferior ao `price`, o Mira cita o preço promocional nas respostas, buscas e cartões de produto. Com `sale_price_effective_date`, o preço promocional apenas é exibido no período indicado (validado aquando da consulta); fora desse período, ou se não for lido corretamente, o Mira utiliza o preço normal. Feeds existentes mostram preços promocionais após a próxima atualização.
Opcional	`availability`	Em stock: `in_stock`, `in stock`. Indisponível: `out_of_stock`, `out of stock`, `preorder`, `backorder`, outros ou ausente.
Imagem	`image_link`	Imagem do produto exibida no cartão. Se não houver, o Mira utiliza imagem Open Graph ou imagem destacada da página do produto.
Ignorado	`id`, `gtin`, `checkout_link_template`, `item_group_id`	O Mira AI ignora estas etiquetas — pode deixá-las para outras ferramentas.

O Mira AI também lê os tamanhos dos produtos no feed (a etiqueta size) e pode referir esse detalhe em recomendações. Os tamanhos aparecem após a próxima atualização do feed.

Nota: IDs numéricos para google_product_category ainda não são suportados. Use sempre a versão em texto da categoria — por exemplo "Vestuário & acessórios > Roupa > Camisas & tops" — ou então 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 e Google Shopping XML a partir do painel administrativo	Feeds XML • Heuréka XML
Shopsys	Feeds de produtos via a própria plataforma com documentação técnica	Feeds de produtos
Eshop-rychle	Feeds para motores de comparação de preços	Exportação de produtos
Upgates	Exportação de dados XML com toda a estrutura de produtos	Exportação de dados • Documentação XML
Shoper	Feed de produtos Google gerado diretamente na plataforma	Feed Google
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	Google Product Feed via plugins	Plugins • Recomendado

Próximos passos

Introdução ao Assistente de compras Mira AI — configurar o Mira AI e adicionar o feed de produtos como fonte.
Como começar o treino do Mira AI — aperfeiçoar as respostas com pares personalizados de perguntas e respostas.
Mira AI - disponibilidade de stock — permitir que os visitantes verifiquem se um produto está disponível.
FAQ do Assistente de compras Mira AI — perguntas comuns sobre o Mira AI.

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

Como exportar feeds de produtos de diferentes plataformas de comércio eletrónico para o assistente de compras Mira AI?