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

# Conectar o número

> Conecte o WhatsApp ao canal, troque de número, migre para a API Oficial e edite nome e logo do canal.

Os canais da organização ficam em **Workspace → Minha Conta → Configurações da conta**, na lista **Canais desta organização**. Cada linha mostra o tipo, o número conectado e as ações **Editar** e **Conectar** (ou **Gerenciar**, quando já está conectado).

> [!NOTE]
>
> Os canais vêm do plano contratado. Para ter mais um número, ou se a linha diz **Este canal ainda não tem WhatsApp contratado**, clique em **Solicitar ao comercial** e peça o WhatsApp Business ou o WhatsApp Meta API.

![Janela do canal com o aviso Este canal ainda não tem WhatsApp contratado e o botão Solicitar ao comercial](https://mintcdn.com/stegia/DjmJrTgeF61XXIUt/images/organizacao/canal-conectar.png?fit=max\&auto=format\&n=DjmJrTgeF61XXIUt\&q=85\&s=3b63e6e4e3c2e353aca8970e6e0057d9)

Janela de conexão de um canal ainda sem WhatsApp contratado

## WhatsApp Business (QR Code)

**1. Abra a conexão**

Clique em **Conectar** na linha do canal e depois em **Conectar WhatsApp Business**.

**2. Escolha como conectar**

* **QR Code**: clique em **Gerar QR Code**. No celular, abra o WhatsApp → **Aparelhos conectados** → **Conectar um aparelho** e leia o código.
* **Telefone**: informe o número com código do país (ex.: `5511999999999`) e digite no WhatsApp do celular o código que aparece na tela.

**3. Pronto**

A mensagem **Canal conectado!** confirma a conexão. As conversas novas começam a chegar em **Conversas**.

> [!WARNING]
>
> Se aparecer **Limite de tentativas atingido**, espere um pouco e clique de novo. Para evitar bloqueios do WhatsApp, leia [Boas práticas no WhatsApp](https://docs.brainchat.app/organizacao/boas-praticas-whatsapp.md).

## API Oficial (Meta)

**1. Abra a conexão**

Clique em **Conectar** na linha do canal.

**2. Faça o login oficial**

Clique em **Conectar WhatsApp**. Uma janela da Meta abre para você entrar com a conta do Facebook da empresa, escolher (ou criar) a conta do WhatsApp Business e o número. Não é preciso copiar IDs nem ler QR Code.

**3. Pronto**

Ao fechar a janela, o canal aparece como conectado.

Na API Oficial, a primeira mensagem para quem não falou com vocês nas últimas 24 horas precisa ser um [template aprovado pela Meta](https://docs.brainchat.app/atendimento/templates.md).

## Canal desconectado

Quando o número cai, o canal mostra **Canal desconectado — dados preservados** (ou **Canal desconectado da API Meta**). Conversas, contatos e histórico continuam guardados. Clique em **Conectar** e repita a conexão para voltar a receber e enviar.

## Trocar o número

* **WhatsApp Business:** em **Gerenciar**, clique em **Reconectar ou trocar número** e leia o QR Code com o celular do número novo.
* **API Oficial:** em **Gerenciar**, clique em **Desconectar** e conecte de novo, escolhendo o número novo no login da Meta.

> [!WARNING]
>
> Trocar o número desconecta o atual. Webhooks e integrações deixam de receber eventos até o número novo ser conectado.

## Passar para a API Oficial

Para levar um canal WhatsApp Business para a API Oficial da Meta mantendo nome, equipe e configurações, fale com o seu gerente de conta ou com o [suporte](https://docs.brainchat.app/ajuda/suporte.md).

## Nome e logo do canal

Clique em **Editar** na linha do canal para mudar **Nome do canal**, **Site** e **Logo do canal**. Sem preenchimento, vale a identidade da organização.

## Detalhes do número

Na janela de conexão, **Ver detalhes completos deste número** abre a página do canal, com licença, assinatura, conexão e as opções **Alterar Número do Canal** e **Cancelar Assinatura**.

> [!WARNING]
>
> Ao cancelar a assinatura de um canal, a API e os webhooks param, e o histórico de mensagens fica guardado por 30 dias. Para reativar, é preciso uma nova assinatura.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.