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

# Conexão de WhatsApp

> Conecte um número de WhatsApp ao Metrito via QR Code para gerar eventos de rastreamento.

## O que é a conexão de WhatsApp?

A conexão de **WhatsApp** liga um número ao Metrito para que as conversas gerem **eventos de rastreamento** — peça importante para atribuir leads e conversas às campanhas que os originaram.

Hoje a conexão é feita pela **API não oficial**: você lê um **QR Code** e pareia o seu aparelho, igual ao WhatsApp Web.

<Note>
  **Não há risco de "cair o chip".** O Metrito apenas **escuta** os eventos que acontecem no WhatsApp para gerar o rastreamento — ele não dispara mensagens em massa nem realiza ações que coloquem o número em risco.
</Note>

## Como conectar

<Steps>
  <Step title="Adicione a integração de WhatsApp">
    Em **Adicionar integração**, escolha a categoria **Mensagens** e selecione **WhatsApp**.
  </Step>

  <Step title="Leia o QR Code">
    No celular, abra **WhatsApp → Aparelhos conectados → Conectar um aparelho** e aponte para o QR Code exibido na tela. Enquanto não for lido, o status fica em **Aguardando leitura de QR Code**.
  </Step>

  <Step title="Conexão concluída">
    Após o pareamento, o status muda para **Conectado** e o Metrito passa a escutar os eventos do número.
  </Step>
</Steps>

## Status da conexão

| Status                            | Significado                                                 |
| --------------------------------- | ----------------------------------------------------------- |
| **Aguardando leitura de QR Code** | A conexão foi criada e espera o pareamento.                 |
| **Conectado**                     | O aparelho está pareado e os eventos estão sendo escutados. |
| **Desconectado**                  | O pareamento caiu. Reconecte lendo o QR Code novamente.     |

## Atribuição entre canais

Conectar o número é só uma parte. Para que uma conversa de WhatsApp se conecte à jornada do cliente na web (e o anúncio receba o crédito pela venda), há um mecanismo próprio de atribuição entre canais.

<Card title="Rastreamento via WhatsApp" icon="comment-dots" href="/tracking/whatsapp">
  Entenda como conversas do WhatsApp se conectam às sessões web via `wa_session` para atribuição completa.
</Card>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Tela de Leads" icon="user-group" href="/analise/leads">
    Veja os contatos identificados, inclusive pelo WhatsApp.
  </Card>

  <Card title="Adicionar uma integração" icon="circle-plus" href="/integracoes/adicionar-integracao">
    Conecte outras fontes de dados ao projeto.
  </Card>
</CardGroup>