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

# Criar Instância

> Como criar uma instância no Brainchat conectada via QR Code (API Business) ou pela API Oficial da Meta.

# Criar Instância

Uma **instância** representa um número de WhatsApp conectado à plataforma. Você escolhe entre dois caminhos no momento da criação:

| Provedor             | Conexão               | Para quem                                                                     |
| -------------------- | --------------------- | ----------------------------------------------------------------------------- |
| **API Business**     | QR Code (instantâneo) | Quem quer começar a operar em minutos                                         |
| **API Meta Oficial** | Login Facebook (SDK)  | Quem precisa de envio em massa, templates aprovados e zero risco de banimento |

Os dois caminhos rodam no mesmo painel — Chat, Contatos, Templates e API funcionam igual.

***

## Pré-requisitos

* Conta criada no [Brainchat](https://brainchat.app/auth)
* Número de WhatsApp ativo

Para a **API Meta Oficial**, adicionalmente:

* Acesso a uma conta no Facebook Business Manager
* Número WhatsApp Business já registrado (ou disponível para registrar pelo fluxo da Meta)

***

## Caminho 1 — API Business (QR Code)

<Steps>
  <Step title="Nova Instância">
    Em **Instâncias**, clique em **Nova Instância**, dê um nome (ex: "Atendimento Comercial") e mantenha **API Business** selecionado.
  </Step>

  <Step title="Escaneie o QR Code">
    No celular: **WhatsApp → ⋮ Menu → Dispositivos conectados → Conectar dispositivo** e escaneie o QR exibido.

    <Info>O QR Code expira a cada 60 segundos. Se expirar, clique em "Atualizar QR Code".</Info>
  </Step>

  <Step title="Pronto">
    Em poucos segundos o status muda para **Conectado** e o número está liberado para enviar e receber mensagens.
  </Step>
</Steps>

<Warning>
  O WhatsApp permite apenas uma sessão Web ativa por número. Ao conectar no Brainchat, sessões do WhatsApp Web em navegadores serão desconectadas.
</Warning>

***

## Caminho 2 — API Meta Oficial

A conexão é feita pelo **login oficial do Facebook**, sem você precisar copiar nenhum ID, token ou Phone Number ID.

<Steps>
  <Step title="Nova Instância → Meta Oficial">
    Em **Instâncias**, clique em **Nova Instância**, dê um nome e selecione **API Meta Oficial**. Preencha logo e website (opcionais — usados para personalizar a janela do Facebook).
  </Step>

  <Step title="Conectar com Meta">
    Clique em **Criar e conectar**. A janela oficial do Facebook abre em pop-up. Faça login com a conta que administra seu WhatsApp Business.
  </Step>

  <Step title="Escolha conta + número">
    Na janela da Meta, selecione:

    1. A **conta WhatsApp Business (WABA)** que vai operar.
    2. O **número** que será usado.
    3. Confirme as permissões.
  </Step>

  <Step title="Pronto">
    Ao fechar o pop-up, o canal já está provisionado e a instância marcada como **Conectada**. Não há QR Code, não há token para colar.
  </Step>
</Steps>

<Tip>
  Se sair antes de concluir, a instância fica em **"Falta 1 passo"** na visão geral. Basta clicar novamente em **Conectar com Meta** quando quiser retomar.
</Tip>

### Diferenças práticas

| Tema                     | API Business (QR Code)   | API Meta Oficial                                  |
| ------------------------ | ------------------------ | ------------------------------------------------- |
| Setup                    | QR no celular            | Login Facebook                                    |
| Envio fora da janela 24h | Não recomendado          | Suportado via **templates aprovados**             |
| Risco de banimento       | Existe (uso não-oficial) | Zero (parceria oficial)                           |
| Templates                | Texto livre              | [Templates aprovados pela Meta](/dados/templates) |
| Sessão Web concorrente   | Desconecta WhatsApp Web  | Não interfere                                     |

***

## Limites de instâncias por plano

| Plano         | Instâncias |
| ------------- | ---------- |
| Básico        | 1          |
| Intermediário | 1          |
| Avançado      | 3          |
| Enterprise    | Ilimitado  |

***

## Próximos passos

* [Configurar webhook](/api/webhook) para receber eventos
* [Cadastrar templates](/dados/templates) (essencial para Meta Oficial fora da janela 24h)
* [Enviar primeira mensagem via API](/api/enviar-mensagem)