Este guia explica como sincronizar produtos da sua loja com o Instagram Shop (catálogo Meta), o que significam os avisos e erros de catálogo na Unefesta e como corrigir problemas comuns.
O checkout continua na Unefesta — o Instagram serve para exibir produtos e enviar o cliente para sua vitrine.
Visão geral
| O que a Unefesta faz | O que fica na Meta |
|---|---|
| Envia produtos elegíveis para o catálogo da loja | Exibe itens na Loja do Instagram |
| Mantém links com rastreamento de origem | Commerce Manager / diagnósticos de catálogo |
| Mostra avisos quando a Meta rejeita ou alerta sobre itens | Analisa título, preço, imagem, disponibilidade etc. |
Cada conexão Meta fica vinculada a uma loja. A Unefesta cria na Meta:
- Unefesta - Loja [número] — catálogo de produtos (venda)
- Unefesta - Loja [número] - Serviços — catálogo de serviços profissionais (quando houver anúncios elegíveis do tipo serviço)
Requisitos mínimos
| Requisito | Detalhe |
|---|---|
| Conta Instagram profissional | Vinculada ao seu negócio |
| Conta Meta Business | Gerenciador de Negócios ativo |
| Pagamento na loja | PagBank ou Mercado Pago conectado na Unefesta |
| Itens elegíveis | Anúncios de venda ou serviço, com imagem e preço, publicados e aprovados |
| Assinatura Unefesta ativa | Acesso ao painel do vendedor |
| Integração liberada | Se a seção Instagram Shop não aparecer, aguarde o rollout |
Como conectar
- No menu lateral, abra Integrações das Lojas.
- Role até Instagram Shop.
- Se ainda não estiver conectado, escolha a Loja para o catálogo Instagram na lista.
- Clique em Conectar com Meta e conclua o login na Meta (mesma conta do Gerenciador de Negócios).
- Ao voltar, deve aparecer Conectado à Meta, com a loja vinculada e a quantidade de Itens elegíveis (produtos + serviços).
Vários catálogos na Meta: se sua conta já tinha mais de um catálogo de produtos (ou de serviços), a Unefesta pede que você escolha qual usar na tela de diagnóstico antes da primeira sincronização.
- No Commerce Manager (site da Meta, com sua conta Business), vincule o catálogo escolhido à conta Instagram profissional da loja e confirme que o checkout aponta para sua vitrine na Unefesta.
Para mais detalhes e status da conexão, use o link Guia e diagnóstico na mesma seção ou o botão Diagnóstico.
Importar produtos do catálogo Meta
Se você já tinha produtos no Commerce Manager ou em outra plataforma conectada à Meta:
- Conecte o Instagram Shop (passos acima).
- Abra Guia e diagnóstico → seção Importar do catálogo Meta.
- Escolha o catálogo fonte, marque os itens e clique em Importar selecionados.
- A Unefesta cria produtos/serviços (variants) — revise nome, preço e imagens em Produtos.
- Crie anúncios a partir desses itens quando quiser; a sincronização Unefesta → Meta mantém os anúncios publicados no catálogo.
Itens que já vieram da Unefesta para o Instagram não podem ser importados de volta (evita duplicidade).
Sincronização do catálogo
| Ação | Onde |
|---|---|
| Sincronizar agora | Integrações das Lojas → Instagram Shop, ou na página Guia e diagnóstico |
| Sincronização automática | Marque ou desmarque a caixa Sincronização automática (envio periódico em segundo plano) |
| Reconfigurar conexão | Botão Reconfigurar conexão (refaz o vínculo OAuth com a Meta) |
Status da sincronização (texto exibido na tela):
| Status | Significado |
|---|---|
| Ocioso | Nenhuma sync em andamento no momento |
| Sincronizando | Envio de produtos e serviços para a Meta em progresso |
| Erro | A última operação falhou ou a Meta reportou problema — veja os avisos abaixo |
Avisos e erros no catálogo
Quando a Meta encontra problemas ao importar ou validar produtos, a Unefesta mostra um painel na integração e pode enviar uma notificação no sino do painel.
Onde ver
- Integrações das Lojas → Instagram Shop (painel colorido abaixo dos botões)
- Guia e diagnóstico (mesmo painel, com mais detalhes da conexão)
- Notificações do vendedor — títulos como Problema no catálogo Instagram ou Problema ao sincronizar catálogo Instagram
Tipos de painel
| Título na tela | Cor | Significado |
|---|---|---|
| Problemas no catálogo Instagram | Vermelho | Pelo menos um erro: produto(s) não entraram ou foram rejeitados pela Meta |
| Avisos no catálogo Instagram | Amarelo | Avisos da Meta — item pode ter sido aceito com ressalvas ou campo incompleto |
A primeira linha do painel resume o principal problema. Abaixo, cada item mostra:
- Erro ou Aviso · origem (Sincronização, Lote de produtos ou Feed Meta)
- Mensagem em português ou inglês (texto vindo da Meta)
- Produto: identificador do anúncio na Unefesta, quando a Meta informar
Se houver data, aparece Último aviso da Meta: com dia e hora.
O que significa cada origem
| Origem na lista | O que aconteceu |
|---|---|
| Sincronização | Erro ao enviar produtos pelo botão Sincronizar agora ou pela sync automática |
| Lote de produtos | A Meta terminou de processar um envio em lote e reportou itens inválidos ou avisos |
| Feed Meta | Problema na importação do feed XML (URL configurada no Commerce Manager ou gerada pela Unefesta) |
O que fazer quando aparecer um aviso
- Leia a mensagem — em geral indica campo faltando (título, descrição, preço, imagem, disponibilidade).
- Abra o anúncio na Unefesta e corrija:
- Tipo venda ou serviço (locação não entra no catálogo Meta)
- Imagem principal
- Preço preenchido
- Anúncio publicado e aprovado na moderação
- PagBank ou Mercado Pago ativo na loja
- Clique em Sincronizar agora.
- Se persistir, abra o Commerce Manager da Meta → diagnósticos do catálogo (detalhes extras que a Meta não repassa linha a linha).
Ocultar avisos
O botão Ocultar avisos remove o painel da tela sem corrigir o catálogo na Meta. Use depois de ler o problema ou quando já tiver corrigido e quiser limpar a interface.
Se o problema continuar na Meta, um novo aviso pode voltar após a próxima sincronização ou importação.
Itens elegíveis
Entram no catálogo Instagram, em regra:
- Anúncios da loja conectada
- Tipo venda (catálogo de produtos) ou serviço (catálogo Professional Services da Meta)
- Com imagem e preço
- Publicados e aprovados
- Loja com recebimento (PagBank ou Mercado Pago) configurado
Locação (rent) não é enviada — a Meta trata catálogos de commerce e Professional Services separadamente; serviços usam campos como name, image_url, url e service_category (categoria/subcategoria do anúncio na Unefesta).
O número Itens elegíveis na tela é a contagem total (produtos + serviços) que a Unefesta enviaria na próxima sync — se for 0, nenhum anúncio atende aos critérios acima.
Feed manual (alternativa)
Se o OAuth ainda não estiver disponível, a Unefesta pode gerar URLs de feed por loja para colar no Commerce Manager da Meta:
| Formato | Conteúdo |
|---|---|
XML (format=xml) |
Produtos de venda (Google Shopping / Instagram Shop) |
CSV (format=csv) |
Mesmos produtos de venda |
CSV serviços (format=service-csv) |
Serviços no formato Professional Services — importe no catálogo vertical services |
Na sync automática via OAuth, produtos e serviços são enviados pela API sem precisar desses feeds.
Erros dessa importação aparecem como Feed Meta no painel de avisos.
Desconectar
- Integrações das Lojas → Instagram Shop
- Desconectar (ou Desconectar na página Guia e diagnóstico)
O catálogo na Meta deixa de ser atualizado pela Unefesta. Itens já publicados no Instagram podem permanecer até você alterar no Commerce Manager.
Problemas comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Itens elegíveis: 0 | Nenhum anúncio de venda/serviço com imagem/preço e pagamento ativo | Revise anúncios e integrações PagBank/Mercado Pago |
| Painel vermelho após sync | Meta rejeitou um ou mais itens | Leia a mensagem, corrija o anúncio, Sincronizar agora |
| Aviso “descrição ausente” / “preço” / “imagem” | Campo exigido pela Meta | Complete o anúncio na Unefesta |
| Status: Erro persistente | Falha de token ou catálogo Meta | Reconfigurar conexão |
| Notificação mas painel oculto | Você clicou em Ocultar avisos | Abra Guia e diagnóstico ou sincronize de novo para ver se ainda há erro |
| Integração não aparece | Rollout ou flag desligada | Aguarde liberação pela Unefesta |
Resumo rápido
| Pergunta | Resposta |
|---|---|
| O checkout é no Instagram? | Não — na vitrine Unefesta |
| A Unefesta cobra por produto no catálogo? | Não — custos Meta são de anúncios/commerce, não da assinatura Unefesta |
| Onde vejo erros? | Painel Problemas/Avisos no catálogo Instagram + Notificações |
| Como corrigir? | Ajuste anúncios elegíveis → Sincronizar agora |
| Como esconder o painel? | Ocultar avisos |