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

# Automações

> Monte fluxos que entregam produtos automaticamente e reagem a eventos de venda.

A área de **Automação** (`Loja → Automação → Fluxos` e `Execuções`) permite montar fluxos visuais, no estilo drag-and-drop, que decidem o que acontece depois de uma venda — sem precisar escrever código.

## Para que servem

O caso de uso principal é a **entrega automática de produtos digitais**, especialmente em servidores **FiveM** e **RedM**: dar dinheiro, itens, cargos/grupos ou executar comandos customizados no servidor assim que um pedido é confirmado.

## Eventos que disparam uma automação

Você pode escolher uma automação diferente (ou repetir a mesma) para cada um destes estados de um produto/pedido:

<CardGroup cols={2}>
  <Card title="Compra" icon="shopping-cart">
    Disparado quando o pagamento é confirmado.
  </Card>

  <Card title="Removido" icon="trash-2">
    Disparado quando o item/acesso é removido.
  </Card>

  <Card title="Reembolso (Refund)" icon="undo-2">
    Disparado quando o pedido é reembolsado.
  </Card>

  <Card title="Chargeback" icon="alert-triangle">
    Disparado quando ocorre uma contestação de pagamento.
  </Card>

  <Card title="Assinatura renovada" icon="refresh-cw">
    Disparado a cada renovação bem-sucedida de uma assinatura recorrente.
  </Card>
</CardGroup>

## Anatomia de um fluxo

Um fluxo é composto por **nós** conectados entre si:

| Nó             | O que faz                                                                   |
| -------------- | --------------------------------------------------------------------------- |
| `trigger`      | Ponto de entrada — o evento que inicia o fluxo (ex.: `purchase_completed`). |
| `delay`        | Espera um tempo antes de continuar o fluxo.                                 |
| `game_command` | Executa um comando no servidor de jogo (ex.: dar dinheiro, item, grupo).    |
| `webhook`      | Envia uma requisição HTTP para um sistema externo.                          |
| `notification` | Dispara uma notificação (para o cliente e/ou lojista).                      |

Por exemplo, um fluxo simples de "entregar dinheiro no FiveM após a compra" conecta um nó `trigger` (evento de compra confirmada) direto a um nó `game_command` configurado com o comando de dar dinheiro do seu framework.

## Variáveis disponíveis nos comandos

| Variável                                   | Descrição                                                             |
| ------------------------------------------ | --------------------------------------------------------------------- |
| `{{player_id}}`                            | ID do jogador no servidor                                             |
| `{{player_name}}`                          | Nome do jogador                                                       |
| `{{checkout_id}}`                          | ID da compra                                                          |
| `{{product_name}}`                         | Nome do produto                                                       |
| `{{amount}}`                               | Valor da compra                                                       |
| `{{customer_name}}` / `{{customer_email}}` | Dados do cliente                                                      |
| `{{nome_da_variavel}}`                     | Qualquer [variável customizada do produto](/guias-do-painel/produtos) |

## Associando uma automação a um produto

Na tela de edição do produto, escolha o fluxo de automação na aba **Automação** e salve — a partir daí, toda venda desse produto passa a disparar o fluxo escolhido.

## Integração com FiveM/RedM

Para os nós `game_command` funcionarem, o servidor de jogo precisa estar conectado à loja.gg pelo resource oficial. Veja o passo a passo completo em [FiveM e RedM](/api-reference/fivem-redm): gerar o token no painel, instalar o resource `lojagg_script` e mapear os comandos.

## Execuções

Toda execução de automação fica registrada com status (`pending`, `running`, `completed`, `failed`), dados da execução e horários de início/fim — visível em `Loja → Automação → Execuções`, útil para depurar entregas que falharam.