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

# O que são integrações

> Integrações são as fontes de entrada de dados do Metrito. Entenda o conceito, os status e a coluna tracking.

## O conceito de integração

A **integração** (ou **conexão**) é a peça que conecta uma fonte externa ao Metrito. Pense nela como o **plug**: é por onde os dados **entram** e onde ficam **guardados**.

Cada integração é uma **fonte de entrada** independente. A partir dela, os dados se propagam para o resto da plataforma:

```mermaid theme={null}
flowchart LR
    subgraph fontes [Integrações - fontes de entrada]
        ads["Contas de anúncio<br/>(Meta Ads)"]
        checkout["Checkouts / Gateways<br/>(webhooks)"]
        wpp["WhatsApp"]
        custom["Integração personalizada"]
    end
    fontes --> metrito[(Metrito)]
    metrito --> dash["Dashboard"]
    metrito --> camp["Campanhas"]
    metrito --> vendas["Vendas"]
    metrito --> leads["Leads"]
```

Conectou uma vez, os dados passam a alimentar o **dashboard**, a tela de **campanhas**, a tela de **vendas** e a de **leads**.

## Tipos de integração

| Categoria         | Exemplos                                                             | O que traz                                         |
| ----------------- | -------------------------------------------------------------------- | -------------------------------------------------- |
| **Tráfego**       | Meta Ads (Google Ads e TikTok Ads em breve)                          | Gasto, impressões, campanhas, conjuntos e anúncios |
| **Pagamentos**    | Hotmart, Shopify, Stripe, Kiwify, Eduzz, e outros checkouts/gateways | Pedidos, produtos, status de pagamento, receita    |
| **Mensagens**     | WhatsApp                                                             | Conversas e eventos para atribuição                |
| **Personalizada** | Qualquer sistema próprio                                             | Pedidos via payload no formato do Metrito          |

## A tabela de integrações

Na tela de **Integrações**, cada conexão aparece em uma linha com informações importantes:

| Coluna       | O que significa                                                                                                           |
| ------------ | ------------------------------------------------------------------------------------------------------------------------- |
| **Status**   | A situação atual da conexão (ver abaixo).                                                                                 |
| **Tracking** | Um toggle. Quando **ativado**, aquele checkout/gateway dispara eventos de rastreamento dentro do Metrito.                 |
| **Timezone** | O fuso horário da conexão dentro do Metrito.                                                                              |
| **Moeda**    | A moeda de origem dos valores daquela conexão.                                                                            |
| **Comissão** | O tipo de comissão usado para calcular o valor líquido (ver [Checkouts e comissões](/integracoes/checkouts-e-comissoes)). |

### A coluna *tracking*

A coluna **tracking** é o que liga uma conexão de checkout ao rastreamento. Com o toggle **ativado**, cada compra aprovada naquela conexão dispara um evento de rastreamento (e pode ser enviada ao Meta). Com ele desativado, os pedidos ainda aparecem em [Vendas](/analise/vendas), mas **não** geram evento de rastreamento.

## Status das conexões

O status indica a saúde da conexão. Os principais:

| Status                            | Significado                                                       | O que fazer                                               |
| --------------------------------- | ----------------------------------------------------------------- | --------------------------------------------------------- |
| **Ativo / Conectado**             | Tudo certo, dados fluindo.                                        | Nada.                                                     |
| **Sincronizando**                 | Buscando os dados (primeira sincronização ou ciclo em andamento). | Aguardar.                                                 |
| **Token expirado**                | A autorização com a plataforma expirou.                           | **Remover a conta e adicioná-la novamente** (ver abaixo). |
| **Débito pendente**               | Há um débito não liquidado na conta de anúncio.                   | Regularizar na plataforma de origem.                      |
| **Bloqueado**                     | A conta foi desabilitada na origem.                               | Verificar a conta na plataforma de origem.                |
| **Aguardando leitura de QR Code** | Conexão de WhatsApp aguardando pareamento.                        | Ler o QR Code (ver [WhatsApp](/integracoes/whatsapp)).    |

<Tip>
  **Token expirado?** A solução é simples: **remova a conexão e adicione-a novamente**. Isso refaz a autorização e restabelece o fluxo de dados.
</Tip>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Adicionar uma integração" icon="circle-plus" href="/integracoes/adicionar-integracao">
    Passo a passo para conectar uma nova fonte.
  </Card>

  <Card title="Compartilhar integrações" icon="share-nodes" href="/integracoes/compartilhar-integracoes">
    Use a mesma conexão em vários projetos.
  </Card>

  <Card title="Contas de anúncio" icon="rectangle-ad" href="/integracoes/contas-de-anuncio">
    Conecte Meta Ads e gerencie status.
  </Card>

  <Card title="Checkouts e comissões" icon="credit-card" href="/integracoes/checkouts-e-comissoes">
    Configure moeda, fuso e tipo de comissão.
  </Card>
</CardGroup>