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 |
Pré-requisitos
- Conta criada no Brainchat
- Número de WhatsApp ativo
- 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)
Nova Instância
Em Instâncias, clique em Nova Instância, dê um nome (ex: “Atendimento Comercial”) e mantenha API Business selecionado.
Escaneie o QR Code
No celular: WhatsApp → ⋮ Menu → Dispositivos conectados → Conectar dispositivo e escaneie o QR exibido.
O QR Code expira a cada 60 segundos. Se expirar, clique em “Atualizar QR Code”.
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.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).
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.
Escolha conta + número
Na janela da Meta, selecione:
- A conta WhatsApp Business (WABA) que vai operar.
- O número que será usado.
- Confirme as permissões.
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 |
| 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 para receber eventos
- Cadastrar templates (essencial para Meta Oficial fora da janela 24h)
- Enviar primeira mensagem via API