> ## 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](https://docs.metrito.com/integracoes/checkouts-e-comissoes.md)). |

### 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](https://docs.metrito.com/analise/vendas.md), 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](https://docs.metrito.com/integracoes/whatsapp.md)). |

> [!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.

## Próximos passos

> [card] [Adicionar uma integração](https://docs.metrito.com/integracoes/adicionar-integracao.md)
>
> Passo a passo para conectar uma nova fonte.

> [card] [Compartilhar integrações](https://docs.metrito.com/integracoes/compartilhar-integracoes.md)
>
> Use a mesma conexão em vários projetos.

> [card] [Contas de anúncio](https://docs.metrito.com/integracoes/contas-de-anuncio.md)
>
> Conecte Meta Ads e gerencie status.

> [card] [Checkouts e comissões](https://docs.metrito.com/integracoes/checkouts-e-comissoes.md)
>
> Configure moeda, fuso e tipo de comissão.


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