O Assistente de Compras Mira AI utiliza o feed de produtos para sugerir produtos, responder a dúvidas sobre preços e informar sobre disponibilidade. Este guia apresenta os formatos de feed aceites pelo Mira AI, as etiquetas lidas e onde consultar as instruções oficiais de exportação das plataformas de e-commerce mais usadas.
Dividimos o guia nas seguintes secções:
O feed ou a extração de dados da web não funciona? Como resolver problemas com fontes de conhecimento do Mira AI
Antes de começar
O Mira AI aceita feeds de produtos em XML padrão — o mesmo modelo gerado pelas principais plataformas de e-commerce para Heuréka, Google Shopping, Zboží.cz e marketplaces semelhantes. Quanto mais detalhado estiver o seu feed (informando preço, disponibilidade, descrição, link, categoria), mais úteis serão as recomendações do Mira.
Para adicionar o feed no Smartsupp:
No construtor do assistente, aceder a Base de conhecimento → Produtos e clicar em Adicionar.
Digite um nome para a fonte.
Cole o URL completo do feed de produtos.
Na etapa Atualizar, escolha a frequência desejada para atualização do feed.
O Mira AI atualiza automaticamente o feed de produtos em intervalos definidos — alterações de preço, de disponibilidade e novos produtos aparecem no chat sem que precise reenviar ficheiros.
Nota: O Mira AI carrega as imagens dos produtos diretamente do seu feed XML. Se algum produto não tiver imagem no feed, o Mira recupera a imagem Open Graph ou a imagem em destaque da página do produto — por isso, mantenha estas opções preenchidas.
Nota: Se o seu servidor bloquear ligações recebidas (firewall, lista de IPs permitidos), certifique-se de autorizar o acesso dos endereços IP do feed-fetcher do Smartsupp: 94.130.187.58 e 188.245.65.74. Caso contrário, o Mira AI não conseguirá importar o feed de produtos.
Estes endereços IP podem ocasionalmente ser alterados. Se o feed deixar de atualizar de repente, consulte este artigo para a lista mais recente ou fale com o suporte.
Formatos de feed suportados
O Mira AI aceita dois formatos padrão de feed de produtos — Heuréka e Google Merchant. Ambos seguem normas comuns de XML:
A extensão do ficheiro é .xml ou .rss.
A primeira linha deve começar por <?xml ...?> ou <rss ...>.
Uma tag principal envolve todos os itens de produto. O nome da tag pode ser qualquer um (por exemplo: <SHOP>) — apenas a sua presença importa.
Cada produto deve estar dentro da sua própria tag de item (ver secções abaixo).
O formato mínimo válido é assim:
<?xml version="1.0" encoding="UTF-8"?>
<SHOP>
<SHOPITEM> ... </SHOPITEM>
<SHOPITEM> ... </SHOPITEM>
</SHOP>
Importante: Se faltar uma tag obrigatória de um produto, esse produto será ignorado pelo Mira — ele não aparecerá nas recomendações. Certifique-se de preencher todas as etiquetas obrigatórias de todos os produtos.
Estrutura do feed Heuréka
No formato Heuréka, o Mira AI lê as seguintes etiquetas. Consulte a documentação oficial do feed Heuréka XML para todos os detalhes.
Categoria | Etiquetas | Notas |
Item wrapper (obrigatório) |
| Uma destas etiquetas deve envolver cada produto. |
Descrição (obrigatória) |
| Todas as etiquetas devem ter conteúdo. Etiquetas vazias contam como ausentes. |
Opcional |
|
|
Imagem |
| Imagem do produto exibida no cartão. Em falta, o Mira utiliza a imagem Open Graph ou a que estiver em destaque na página do produto. |
Ignorado |
| O Mira AI ignora estas etiquetas — pode mantê-las para usar noutras ferramentas. |
A etiqueta PARAM carrega um atributo adicional do produto em formato 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. Conferir a especificação oficial do feed Google Merchant para referência completa.
Categoria | Etiquetas | Notas |
Item wrapper (obrigatório) |
| Uma destas etiquetas envolve cada produto. |
Descrição (obrigatória) |
| Para categoria, use |
Formato de preço |
| Formato aceito: |
Preço promocional (opcional) |
| Se |
Opcional |
| Em stock: |
Imagem |
| Imagem exibida no cartão do produto. Se estiver ausente, o Mira utiliza a imagem Open Graph ou a imagem em destaque da página de produto. |
Ignorado |
| O Mira AI ignora estas etiquetas — pode deixá-las no feed para outros fins. |
O Mira também lê os tamanhos informados no feed (etiqueta size) e pode incluí-los nas recomendações. Os tamanhos aparecem após a atualização do feed.
Nota: IDs numéricos de 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 como alternativa.
Exportar feed por plataforma
Localize a sua plataforma de e-commerce na tabela abaixo e siga o guia oficial correspondente para exportar seu feed.
Plataforma | O que exporta | Guia oficial |
Shoptet | XML para Heuréka & Google Shopping a partir do painel de administração | |
Shopsys | Feeds de produtos via plataforma, com documentação para programadores | |
Eshop-rychle | Feeds para comparadores de preços | |
Upgates | Exportação de dados em XML com estrutura completa | |
Shoper | Feed de produtos Google disponível diretamente na plataforma | |
Shopware | Google Shopping — exportação direta ou via plugins | |
Shoprenter | Feeds para Google Shopping e Heuréka | |
PrestaShop | Google Shopping via módulos | |
Magento | Google Shopping via extensões | |
WooCommerce | Feed de produtos do Google através de plugins |
Próximos passos
Introdução ao Assistente de Compras Mira AI — configurar o Mira AI e adicionar o seu feed de produtos como fonte.
Como iniciar o treino do Mira AI — aprimorar as respostas da IA com pares personalizados de perguntas e respostas.
Mira AI - disponibilidade em stock — permitir que visitantes consultem se há stock de um produto.
Assistente de Compras Mira AI FAQ — dúvidas frequentes sobre o Mira AI.