# Instagram Shop (Meta) — guia do vendedor

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/integracao/instagram-shop-meta-guia-do-vendedor

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

1. No menu lateral, abra **Integrações das Lojas**.
2. Role até **Instagram Shop**.
3. Se ainda não estiver conectado, escolha a **Loja para o catálogo Instagram** na lista.
4. Clique em **Conectar com Meta** e conclua o login na Meta (mesma conta do Gerenciador de Negócios).
5. 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.

6. 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:

1. Conecte o Instagram Shop (passos acima).
2. Abra **Guia e diagnóstico** → seção **Importar do catálogo Meta**.
3. Escolha o catálogo fonte, marque os itens e clique em **Importar selecionados**.
4. A Unefesta cria **produtos/serviços** (variants) — revise nome, preço e imagens em **Produtos**.
5. 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

1. Leia a mensagem — em geral indica campo faltando (título, descrição, preço, imagem, disponibilidade).
2. 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
3. Clique em **Sincronizar agora**.
4. Se persistir, abra o [Commerce Manager](https://business.facebook.com/commerce) 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](https://developers.facebook.com/docs/marketing-api/catalog/reference/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](https://developers.facebook.com/docs/marketing-api/catalog/reference/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

1. **Integrações das Lojas** → **Instagram Shop**
2. **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** |