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

# Conexões

> Conecte números por Waha, Evolution API, Quepasa ou a API oficial da Meta.

Toda mensagem sai por uma **conexão** (o número do WhatsApp). Cada conexão pertence a uma organização e pode ser usada por várias campanhas.

## Provedores

| Provedor | Como conecta | Observações |
| - | - | - |
| **Waha** | QR Code ou API key | Padrão; suporta mídia e webhook |
| **Evolution API** | QR Code ou token | Boa para alto volume |
| **Quepasa** | Código de pareamento ou QR Code | Inclui pareamento por código |
| **API oficial da Meta** | Embedded Signup ou token | Sem risco de banimento; exige templates |

## Conectando um número

<Steps>
  <Step title="Vá em Conexões">
    No menu **WhatsApp › Conexões**, clique em **Nova Sessão**.
  </Step>

  <Step title="Escolha o provedor">
    Selecione Waha, Evolution, Quepasa ou API oficial e informe as credenciais, quando houver.
  </Step>

  <Step title="Leia o QR Code ou use o código de pareamento">
    No celular, abra WhatsApp › **Aparelhos conectados** › **Conectar aparelho**. No Quepasa, há também a opção de gerar um código de pareamento.
  </Step>

  <Step title="Confirme a conexão">
    O status muda para **Conectado** e o número aparece no cartão.
  </Step>
</Steps>

## Status possíveis

| Status | Significado |
| - | - |
| `WORKING` | Conectado e pronto para enviar |
| `SCAN_QR_CODE` | Aguardando leitura do QR Code |
| `STOPPED` | Parado; confira o botão **Reiniciar** |
| `FAILED` | Erro de conexão |

## Proteções contra queda

A plataforma tem duas proteções automáticas, ajustáveis por conexão em **Ferramentas › Saúde do chip**:

* **Carência:** chip recém-conectado fica 48h (padrão) sem disparar, validar ou puxar conversa — só recebe e responde. Reduz muito o risco de bloqueio logo após conectar.
* **Bloqueio do WhatsApp:** quando a Meta aplica *reachout timelock* (erro 463), a conexão fica parada automaticamente até o fim do bloqueio, com alerta na tela.

<Info>
  Se um chip cair e voltar sem nunca ter enviado nada, pode ser só uma sincronização de status perdida: use **Reiniciar** para o número ser identificado de novo.
</Info>

## A lista não muda de lugar

A ordem das conexões é fixa pela data de criação. Assim, atualizar a tela não embaralha os cartões enquanto você mexe em um deles.