> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ararahq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Catálogo Meta

> Configure o Brain para enviar o card de um produto do seu catálogo Meta (foto, preço e botão) na conversa.

Ao final deste guia, o Brain envia, pela Action `META_CATALOG_SEND`, o card de um produto do seu **catálogo Meta** (WhatsApp Commerce) na conversa: foto, título, preço e botão de compra, no formato nativo do WhatsApp.

<Warning>
  A Action não sincroniza Shopify, WooCommerce nem arquivo JSON. Ela só referencia produtos que já estão no catálogo da Meta, pelo SKU (`retailer_id`).
</Warning>

## Antes de começar

* [Brain](/brain) configurado, com plano que inclui Brain e número dedicado.
* Catálogo criado no Commerce Manager da Meta e conectado à sua conta WhatsApp Business.
* Produtos com `retailer_id` (SKU) preenchido.
* SKUs presentes na [base de conhecimento do Brain](/brain#knowledge-base). O Brain só envia um produto se souber o SKU exato.

## Quando o Brain usa

Quando o cliente pergunta sobre um produto específico e o SKU aparece no conhecimento do Brain.

Parâmetros que o Brain preenche:

| Parâmetro | Obrigatório | Descrição |
| - | - | - |
| `retailer_id` | Sim | SKU do produto no catálogo Meta |
| `to` | Sim | Telefone do cliente em E.164 |
| `body_text` | Não | Texto que acompanha o card. Default: "Aqui esse produto:" |
| `footer_text` | Não | Rodapé do card, até 60 caracteres |

## Passos

<Steps>
  <Step title="Habilite a Action">
    ```bash theme={null}
    curl -X POST https://api.ararahq.com/v1/brain/actions \
      -H "Authorization: Bearer $ARARA_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "actionType": "META_CATALOG_SEND",
        "enabled": true,
        "config": {
          "catalogId": "123456789012345",
          "phoneNumberId": "109876543210987"
        }
      }'
    ```
  </Step>

  <Step title="Confira os ids">
    `catalogId` é o id do catálogo no Commerce Manager. `phoneNumberId` é o id do número WhatsApp Business na Meta.
  </Step>
</Steps>

## Fluxo

```
Cliente:   "Tem a camiseta básica em M?"
  ↓
Brain:     [consulta o conhecimento → encontra o SKU camiseta-basica-m]
  ↓
Brain:     [META_CATALOG_SEND retailer_id=camiseta-basica-m]
  ↓
Cliente recebe o card do produto com foto, preço e botão
```

O card é enviado direto pela Meta; o Brain pode seguir a conversa em paralelo.

## Limitações

* **Estoque e preço vêm da Meta**: o card mostra o que está no catálogo. Mantenha o catálogo atualizado na origem (Commerce Manager ou a integração que alimenta ele).
* **Um produto por envio**: a Action envia um card de produto único, não lista de vários produtos.
* **Checkout**: para cobrar, combine com [AbacatePay](/brain/actions/abacate-pix) ou [Stripe](/brain/actions/stripe).

## Próximos passos

<CardGroup cols={2}>
  <Card title="Stripe" icon="credit-card" href="/brain/actions/stripe">
    Cobrança com cartão depois do card do produto.
  </Card>

  <Card title="Voltar ao Brain" icon="brain" href="/brain">
    Configuração, Actions disponíveis e regras.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.