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

# Operar a loja com uma IA

> O que um agente consegue fazer sozinho pela API, e onde ainda precisa de uma pessoa

A API pública cobre a operação da loja de ponta a ponta. Com um token criado pelo dono, um agente de IA consegue configurar e tocar a loja sem ninguém abrir o painel.

## O que dá para fazer

| Área | O que o agente faz | Onde |
| - | - | - |
| Loja | Ler e alterar nome, descrição, termos, CNPJ, logo, subdomínio, redes sociais e as regras de endereço e telefone do checkout | [Loja](https://docs.selltrust.com.br/api-reference/store/get.md) |
| Catálogo | Criar e editar categorias, produtos, variações, estoque, preços e imagens | [Produtos](https://docs.selltrust.com.br/api-reference/products/overview.md), [Categorias](https://docs.selltrust.com.br/api-reference/categories/overview.md) |
| Cupons | Criar, editar e desativar cupons | [Cupons](https://docs.selltrust.com.br/api-reference/coupons/list.md) |
| Pedidos | Listar, consultar, criar, aprovar manualmente e anotar pedidos | [Pedidos](https://docs.selltrust.com.br/api-reference/orders/list.md) |
| Pagamentos | Conectar provedores, apontar PIX e cartão para eles, definir taxas e roteamento por valor | [Pagamentos](https://docs.selltrust.com.br/api-reference/gateways/overview.md) |
| Domínio próprio | Adicionar o domínio, obter os registros DNS a criar, verificar e definir como principal | [Domínios](https://docs.selltrust.com.br/api-reference/domains/overview.md) |
| Plugins | Configurar Pixel, Google Analytics, Tag Manager, Google Ads, UTMify, chat e Merchant Center | [Plugins](https://docs.selltrust.com.br/api-reference/plugins/list.md) |
| Tema | Listar os temas e gerar o acesso do editor local para editar os arquivos do tema | [Temas](https://docs.selltrust.com.br/api-reference/templates/list.md) |
| Checkout abandonado | Ligar, definir as etapas, escrever os emails e acompanhar a recuperação | [Checkout abandonado](https://docs.selltrust.com.br/api-reference/abandoned-checkout/get.md) |
| Campanhas | Montar o público, escrever o email, testar, enviar ou agendar e medir o resultado | [Campanhas](https://docs.selltrust.com.br/api-reference/campaigns/overview.md) |
| Email de entrega | Personalizar o email que entrega o produto quando o pedido é aprovado | [Email de entrega](https://docs.selltrust.com.br/api-reference/order-email/overview.md) |

## Um roteiro para montar a loja do zero

**1. Conheça a loja**

`GET /api/v1/store` mostra os dados atuais, a URL pública e os provedores de pagamento já conectados.

**2. Monte o catálogo**

Crie as categorias e depois os produtos. Imagens aceitam URL `http(s)`.

**3. Ative o pagamento**

Conecte um provedor com `PUT /api/v1/gateway/{provedor}` e aponte o PIX para ele com `PUT /api/v1/gateway/PIX`.

**4. Conecte o domínio**

`POST /api/v1/domain`, crie os registros de `dns_records` no provedor do domínio, depois `verify` e `primary`.

**5. Ligue o marketing**

Ligue o checkout abandonado, ajuste os emails e crie a primeira campanha.

## Onde ainda precisa de uma pessoa

* **Criar o token.** É feito no painel, pelo dono ou por um membro autorizado. Veja [Permissões do token](https://docs.selltrust.com.br/api-reference/permissions.md).
* **Mercado Pago.** A conexão é por OAuth: a API devolve a URL de autorização e alguém logado na conta Mercado Pago precisa abri-la.
* **DNS do domínio.** A API informa exatamente quais registros criar; criá-los depende de acesso ao provedor do domínio.
* **Credenciais dos provedores.** As chaves de cada gateway vêm do painel do próprio provedor.

## Regras que valem para o agente

* **Permissões**: o token age em nome de quem o criou e só alcança o que essa pessoa pode fazer no painel.
* **Segredos nunca voltam**: credenciais de gateway e chaves de plugin aparecem só como "preenchido ou não". Para mudar uma configuração sem tocar no segredo, basta não reenviá-lo.
* **Tudo fica registrado**: cada alteração feita pela API entra no changelog da loja, ligada ao token.
* **Limite de requisições**: 120 por minuto por token. Ao receber `429`, espere alguns segundos e tente de novo.
* **Emails com cuidado**: campanhas saem pela mesma fila e cota do painel e respeitam o descadastro. Use a [prévia de público](https://docs.selltrust.com.br/api-reference/campaigns/audience-preview.md) e o [email de teste](https://docs.selltrust.com.br/api-reference/email-templates/test.md) antes de enviar; envio iniciado pode ser interrompido, mas o que já saiu não volta.
* **Erros dizem o que corrigir**: validações retornam `400` com `message`. Templates de email retornam também a linha e a coluna do erro.


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