O Assistente de Compras Mira AI usa seu feed de produtos para sugerir produtos, responder dúvidas de preços e checar disponibilidade. Aqui você descobre os formatos de feed aceitos pela Mira AI, as tags lidas e onde encontrar guias oficiais de exportação para as plataformas de e-commerce mais conhecidas.
Separamos o guia nos seguintes tópicos:
O feed ou web scraping não está funcionando? Veja como resolver problemas das fontes de conhecimento da Mira AI
Antes de começar
A Mira AI aceita feeds de produtos padrão em XML — o mesmo formato que a maioria das plataformas de e-commerce gera para Heuréka, Google Shopping, Zboží.cz e outros marketplaces. Quanto mais completo for seu feed (preço, disponibilidade, descrição, link, categoria), melhores serão as recomendações da Mira.
Para adicionar o feed no Smartsupp:
No construtor do assistente, entre em Base de conhecimento → Produtos e clique em Adicionar.
Dê um nome para a fonte.
Cole a URL completa do seu feed de produtos.
Na etapa Atualizar, escolha com que frequência você quer que o feed seja atualizado.
A Mira AI atualiza seu feed de produtos automaticamente em intervalos definidos — mudanças de preços, disponibilidade e novos produtos aparecem no chat sem você precisar reenviar o arquivo.
Observação: A Mira AI busca as imagens dos produtos direto do seu feed XML. Caso algum produto não tenha imagem lá, a Mira pega a imagem do Open Graph ou a imagem destaque da página do produto — por isso, vale cuidar desses detalhes também.
Observação: Se seu servidor bloqueia conexões externas (por firewall, whitelist de IP), não esqueça de liberar acesso para os IPs do coletor de feeds do Smartsupp: 94.130.187.58 e 188.245.65.74. Senão, o Assistente de Compras Mira AI não vai conseguir baixar seu feed de produtos.
Esses IPs podem mudar de tempos em tempos. Se o feed parar de atualizar do nada, veja este artigo para conferir a lista atual ou fale com nosso suporte.
Formatos de feed compatíveis
A Mira AI aceita dois formatos de feed de produtos padrão — Heuréka e Google Merchant. Os dois seguem regras bem conhecidas de XML:
O arquivo pode terminar em .xml ou .rss.
A primeira linha deve ser <?xml ...?> ou <rss ...>.
Todos os produtos ficam dentro de uma tag principal. O nome dessa tag pode ser qualquer um (por exemplo, <SHOP>) — o importante é que exista.
Cada produto vai em sua própria tag individual (veja exemplos abaixo).
Um exemplo mínimo que funciona:
<?xml version="1.0" encoding="UTF-8"?>
<SHOP>
<SHOPITEM> ... </SHOPITEM>
<SHOPITEM> ... </SHOPITEM>
</SHOP>
Importante: Se faltar uma tag obrigatória em algum produto, esse produto todo será ignorado pelo Assistente de Compras Mira AI — não aparece para os visitantes. Sempre preencha todas as tags obrigatórias para cada item.
Estrutura do feed Heuréka
No formato Heuréka, o Assistente de Compras Mira AI lê as tags abaixo. Confira a documentação oficial do feed XML Heuréka para ver todos os detalhes.
Categoria | Tags | Observações |
Envoltório do item (obrigatório) |
| Uma dessas tags envolve cada produto. |
Descrição (obrigatório) |
| Todas as tags precisam ter conteúdo. Se a tag estiver vazia, conta como se não existisse. |
Opcional |
|
|
Imagem |
| Imagem do produto mostrada no cartão. Se não tiver, a Mira usa a imagem do Open Graph ou a destaque da página do produto. |
Ignorado |
| O Assistente de Compras Mira AI ignora essas tags — pode deixar no feed se você quiser usar em outras ferramentas. |
A tag PARAM traz um atributo extra do produto como nome e valor:
<PARAM>
<PARAM_NAME>Largura</PARAM_NAME>
<VAL>100–109 cm</VAL>
</PARAM>
Estrutura do feed Google Merchant
No formato Google Merchant, o Assistente de Compras Mira AI lê estas tags. Veja a especificação oficial do feed Google Merchant para conferir todas as regras.
Categoria | Tags | Observações |
Envoltório do item (obrigatório) |
| Cada produto fica dentro de uma dessas tags. |
Descrição (obrigatório) |
| Para categoria, use |
Formato de preço |
| Pode ser |
Preço promocional (opcional) |
| Se |
Opcional |
| Disponível: |
Imagem |
| Imagem do produto exibida no card. Se não tiver, a Mira pega do Open Graph ou da imagem destaque da página do produto. |
Ignorado |
| O Assistente de Compras Mira AI ignora essas tags — pode manter no feed para outros usos. |
O Assistente de Compras Mira AI também lê tamanhos do seu feed (tag size) e pode mostrar ao recomendar produtos. Os tamanhos aparecem assim que o feed for atualizado.
Observação: IDs numéricos em google_product_category ainda não são aceitos. Use sempre o nome escrito da categoria — tipo "Roupas & acessórios > roupas > camisas e blusas" — ou opte por product_type.
Exportar feed por plataforma
Procure sua plataforma de e-commerce na tabela abaixo e siga o passo a passo oficial de exportação.
Plataforma | O que gera | Guia oficial |
Shoptet | Heuréka & Google Shopping XML pelo painel | |
Shopsys | Feeds de produtos direto pela plataforma, documentação para devs | |
Eshop-rychle | Feeds para comparadores de preço | |
Upgates | Exportação XML com estrutura completa dos produtos | |
Shoper | Feed Google direto na plataforma | |
Shopware | Google Shopping — exportação direta ou via plugins | |
Shoprenter | Feeds do Google Shopping & Heuréka | |
PrestaShop | Google Shopping via módulos | |
Magento | Google Shopping via extensões | |
WooCommerce | Feed Google por plugins |
O que fazer depois?
Introdução ao Assistente de Compras Mira AI — configure o Assistente de Compras Mira AI e adicione seu feed de produtos como fonte.
Como treinar a Mira AI — melhore as respostas da IA criando perguntas e respostas personalizadas.
Mira AI - disponibilidade de estoque — permita aos visitantes conferirem se um produto está disponível.
FAQ do Assistente de Compras Mira AI — dúvidas comuns sobre o Assistente de Compras Mira AI.