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 que a Mira AI aceita, 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:
Antes de começar
A Mira AI aceita feeds de produtos XML standard — o mesmo formato que a maioria das plataformas de comércio eletrónico gera para Heuréka, Google Shopping, Zboží.cz e marketplaces semelhantes. Quanto mais rico for o 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 criador do assistente, abrir Base de conhecimento → Feed de produtos XML e clicar em Adicionar nova fonte.
Introduzir um nome para a fonte.
Colar o URL completo do seu feed de produtos.
No passo Atualizar escolher com que frequência o feed deve atualizar.
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 voltar a carregar o ficheiro.
Nota: A Mira AI carrega imagens do cartão de produto diretamente do seu feed XML. Se um produto não tiver imagem no feed, a Mira recorre à Open Graph ou à imagem em destaque na sua página de produto — por isso, também vale a pena manter essas opções configuradas.
Nota: Se o servidor restringir ligações de entrada (firewall, allowlist de endereços IP), certifique-se de permitir o acesso a partir dos endereços IP do feed-fetcher do Smartsupp: 94.130.187.58 e 188.245.65.74. Caso contrário, a Mira AI não conseguirá transferir o feed de produtos.
Formatos de feed suportados
A 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-pai agrupa todos os itens de produto. A etiqueta-pai pode ter qualquer nome (por exemplo, <SHOP>) — apenas a sua existência é importante.
Cada produto é agrupado na sua própria etiqueta de item (ver as secções específicas do formato abaixo).
Um esqueleto mínimo válido tem este aspeto:
<?xml version="1.0" encoding="UTF-8"?>
<SHOP>
<SHOPITEM> ... </SHOPITEM>
<SHOPITEM> ... </SHOPITEM>
</SHOP>
Importante: Se uma etiqueta obrigatória estiver em falta num produto, todo esse produto é ignorado no índice da Mira — os visitantes não o verão nas recomendações. Certifique-se de que cada produto tem todas as etiquetas obrigatórias preenchidas.
Estrutura do feed Heuréka
Para o formato Heuréka, a Mira AI lê as seguintes etiquetas. Ver a documentação oficial do feed XML Heuréka para a especificação completa.
Categoria | Etiquetas | Notas |
Contentor de item (obrigatório) |
| Uma destas etiquetas envolve cada produto. |
Descrição (obrigatório) |
| Cada etiqueta deve conter conteúdo. Etiquetas vazias contam como em falta. |
Opcional |
|
|
Imagem |
| Imagem do produto apresentada no cartão. Se estiver em falta, a Mira recorre à Open Graph ou à imagem em destaque na página do produto. |
Ignorado |
| A Mira AI ignora estas etiquetas — é possível deixá-las no feed para outras ferramentas. |
Uma PARAM etiqueta 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 do Google Merchant
Para o formato Google Merchant, a Mira AI lê as seguintes etiquetas. Consulte a especificação oficial do feed do Google Merchant para a referência completa.
Categoria | Etiquetas | Notas |
Invólucro do item (obrigatório) |
| Uma destas etiquetas envolve cada produto. |
Descrição (obrigatório) |
| Para a categoria, utilizar |
Formato do preço |
| Formato permitido: |
Opcional |
| Em stock: |
Imagem |
| Imagem do produto mostrada no cartão. Se estiver em falta, a Mira recorre à Open Graph ou à imagem em destaque na página do produto. |
Ignorado |
| A Mira AI ignora estas etiquetas — pode deixá-las no feed para outras ferramentas. |
Nota: Numérico google_product_category Os IDs são ainda não suportados. Utilizar sempre a versão em texto da categoria — por exemplo "Apparel & Accessories > Clothing > Shirts & Tops" — ou utilizar product_type em alternativa.
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 | |
Shopsys | Feeds de produtos através da plataforma com Documentação para programadores | |
Eshop-rychle | Feeds para motores de comparação de preços | |
Upgates | Exportação de dados XML com estrutura completa de produtos | |
Shoper | Feed de produtos Google diretamente a partir da plataforma | |
Shopware | Google Shopping — exportação direta ou via complementos | |
Shoprenter | Google Shopping & Heuréka feeds | |
Prestashop | Google Shopping via complementos | |
Magento | Google Shopping via extensões | |
WooCommerce | Feed de produtos Google via complementos |
O que se segue?
Introdução ao Assistente de compras Mira AI — configurar a Mira AI e adicionar o feed de produtos como fonte.
Como começar a treinar a Mira AI — ajustar as respostas da IA com pares de perguntas&respostas personalizados.
Mira AI - disponibilidade de stock — permitir que os visitantes verifiquem se um produto está em stock.
FAQ do Assistente de compras Mira AI — perguntas comuns sobre a Mira AI.