> ## 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.

# Hotmart

> Conecte a Hotmart ao Metrito por webhook para receber as vendas e disparar a compra aprovada nos pixels.

## Como funciona

A Hotmart envia cada venda para o Metrito por **webhook**. O Metrito gera uma URL exclusiva para a sua conexão, você cadastra essa URL na Hotmart e, a partir daí, cada compra aparece em [Vendas](/analise/vendas) e pode disparar o evento `Purchase` nos seus pixels.

São três partes:

1. Criar a conexão no Metrito e copiar a URL do webhook.
2. Cadastrar a URL na Hotmart.
3. Ligar a conexão ao container em **Rastreamento → Checkouts**.

<Card title="Prefere vídeo?" icon="youtube" href="https://youtu.be/-6fdDpDQkUU">
  Assista ao tutorial em vídeo de como conectar a Hotmart.
</Card>

## 1. Crie a conexão no Metrito

<Steps>
  <Step title="Abra Adicionar Integração">
    No menu lateral, abra **Integrações** e clique em **Adicionar Integração**.
  </Step>

  <Step title="Escolha Hotmart">
    No modal **Integrações disponíveis**, use o filtro **Pagamentos** (ou busque por "Hotmart") e selecione **Hotmart**.
  </Step>

  <Step title="Dê um nome à conexão">
    Em **Nome da conexão**, use um nome que identifique a conta (ex.: "Hotmart Principal") e clique em **Próximo**.
  </Step>

  <Step title="Escolha o modo de valor">
    Em **Modo de valor**, escolha **Valor líquido** (o que você recebe de fato, já sem taxas e comissões) ou **Valor total da venda** (o valor cheio pago pelo cliente). Veja [Checkouts e comissões](/integracoes/checkouts-e-comissoes) para decidir.
  </Step>

  <Step title="Confira o fuso horário">
    Em **Fuso horário**, mantenha o padrão (horário de São Paulo) ou escolha o fuso da sua operação.
  </Step>

  <Step title="Copie a URL do webhook">
    No passo **Cadastrar webhook**, o Metrito cria a conexão e mostra a URL dela, no formato:

    ```
    https://webhook.metrito.com/v1/ingress?k=...
    ```

    Clique em **Copiar URL do webhook**. Depois clique em **Próximo** e, na tela **Conexão criada**, em **Concluir**.
  </Step>
</Steps>

<Warning>
  Trate essa URL como uma senha: quem tiver o endereço consegue enviar vendas para a sua conexão. Cadastre só na Hotmart e não publique.
</Warning>

## 2. Cadastre a URL na Hotmart

<Steps>
  <Step title="Abra a tela de webhooks">
    Na Hotmart, abra o menu **Ferramentas** e entre em **Webhook (API e Notificações)**. Se não aparecer de cara, clique em **Ver todas** e procure por "Webhook".
  </Step>

  <Step title="Crie uma nova configuração">
    Clique no botão de cadastrar um novo webhook e dê um nome à configuração (ex.: "Metrito").
  </Step>

  <Step title="Cole a URL do Metrito">
    No campo da URL de envio de dados, cole a URL que você copiou no Metrito.
  </Step>

  <Step title="Escolha a versão 2.0.0">
    Selecione a versão **2.0.0**. É o formato que o Metrito lê.
  </Step>

  <Step title="Escolha produtos e eventos">
    Aplique a configuração a todos os produtos ou só aos que você quer rastrear. Em eventos, marque os de compra (aprovada, completa, cancelada, reembolsada, chargeback, aguardando pagamento e as demais), ou simplesmente **Todos**: eventos que não são de compra, como abandono de carrinho, são ignorados pelo Metrito.
  </Step>

  <Step title="Salve">
    Clique em **Salvar**. As próximas vendas já chegam ao Metrito.
  </Step>
</Steps>

<Note>
  Os nomes dos botões variam um pouco entre versões da tela da Hotmart. O que importa é o caminho **Ferramentas → Webhook (API e Notificações)**, a URL do Metrito e a versão **2.0.0**.
</Note>

## 3. Ligue a Hotmart ao rastreamento

Com a conexão criada, as vendas já aparecem em [Vendas](/analise/vendas). Para cada compra aprovada também disparar o `Purchase` nos pixels:

<Steps>
  <Step title="Abra os checkouts do container">
    No menu lateral, abra **Rastreamento** e vá à seção **Checkouts**.
  </Step>

  <Step title="Ative a conexão">
    No card **Conectar Checkouts**, encontre a conexão da Hotmart (use a busca **Buscar por 'nome' ou 'gateway'**) e **ligue o interruptor** dela.
  </Step>
</Steps>

Ao ligar o primeiro checkout, o Metrito cria sozinho o evento **Compra aprovada**, que envia `Purchase` para os pixels a cada venda aprovada. Veja [Checkouts](/tracking/checkouts).

## Atribuição das vendas da Hotmart

Nas páginas com o script do Metrito, os links diretos de checkout da Hotmart (`pay.hotmart.com/...`) saem com o parâmetro `xcod` preenchido automaticamente com o **Lead ID** do visitante e os **UTMs**. A Hotmart devolve esse `xcod` no webhook da venda, e é por ele que o Metrito liga a compra à sessão e à campanha de origem.

<Tip>
  Se a página também tem um player como VTurb ou Panda, ou se o rastreamento parece "sumir" no caminho até o checkout, confira o **Parâmetro de Identificação de Visitante** em [Avançado](/tracking/avancado).
</Tip>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Checkouts e comissões" icon="credit-card" href="/integracoes/checkouts-e-comissoes">
    Entenda o modo de valor e como o Metrito calcula o valor líquido.
  </Card>

  <Card title="Vendas" icon="dollar-sign" href="/analise/vendas">
    Acompanhe as compras e a receita atribuída.
  </Card>
</CardGroup>