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

# Conectar WhatsApp

> Telas de conexão do WhatsApp abertas por link direto: escolha entre WhatsApp Web e API Oficial, login na Meta, QR Code, código e extensão.

O jeito normal de conectar o WhatsApp da loja é pela janela de conexão, que abre em **Atendimento › Configurações** ou em **Atendimento › Conexões**. Esta página explica as outras telas de conexão, que abrem por link direto, e para onde cada link leva conforme o fluxo de conexão da sua loja. Sem um WhatsApp conectado, o atendente da Brendi não envia nem recebe mensagens.

Todos os papéis da loja (Dono, Gerente, Gestor de Tráfego e Operador) abrem estas telas.

## Onde encontrar

Estas telas não ficam no menu, e os botões de conectar do painel não levam a elas. O botão **Conectar WhatsApp** de **Atendimento › Configurações**, o botão **Reconectar-se** do aviso **Whatsapp desconectado**, a tarefa de conectar o WhatsApp do checklist de primeiros passos e os outros atalhos de conectar do painel levam para a janela de conexão:

* **Loja sem o item Conexões no menu Atendimento** (fluxo por QR code): a janela abre em **Atendimento › Configurações**. Veja [Conectar via API Web do WhatsApp](/funcionalidades/atendimento/configuracoes#conectar-via-api-web-do-whatsapp).
* **Loja com o item Conexões** (fluxo novo): os botões levam para **Atendimento › Conexões**, onde o card **WhatsApp Web** abre a mesma janela e o card da API Oficial abre a conexão com a Meta. Veja [Conexões](/funcionalidades/atendimento/conexoes).

As telas desta página abrem por link direto. Antes de mostrar a tela, o painel confere o fluxo da loja:

| Link direto                                    | Loja no fluxo novo                                      | Loja no fluxo por QR code                                   |
| ---------------------------------------------- | ------------------------------------------------------- | ----------------------------------------------------------- |
| Tela de escolha **Conectar WhatsApp**          | Abre a tela                                             | Abre a janela de conexão em **Atendimento › Configurações** |
| Conexão pelo WhatsApp Web, em passo a passo    | Abre a tela                                             | Abre a janela de conexão em **Atendimento › Configurações** |
| Tela **API Oficial (Meta)**                    | Abre a tela                                             | Abre a janela de conexão em **Atendimento › Configurações** |
| Link de conexão da API Oficial                 | Abre a tela **API Oficial (Meta)** na etapa **Conexão** | Vai para o **Gestor de pedidos**                            |
| Tela **Conectar seu WhatsApp**                 | Vai para **Atendimento › Conexões**                     | Abre a tela                                                 |
| Atalho de conexão usado pelos botões do painel | Vai para **Atendimento › Conexões**                     | Abre a janela de conexão em **Atendimento › Configurações** |

Se o painel não conseguir conferir o fluxo da loja, os botões de conectar e os links de WhatsApp Web abrem a tela [Conectar seu WhatsApp](#tela-aberta-por-link-direto) no lugar da janela de conexão.

## Configurações

São três telas: a escolha entre WhatsApp Web e API Oficial, a conexão pela API Oficial e a tela de conexão por QR Code.

## Escolher como conectar

<Badge>Em liberação</Badge>

<Note>
  A tela de escolha e a tela da API Oficial são do fluxo novo de conexão, que está em liberação. Elas valem para as lojas incluídas na liberação e para as que já têm a API Oficial conectada. Nessas lojas, o menu **Atendimento** mostra o item **Conexões**.
</Note>

A tela **Conectar WhatsApp** pede: **Escolha como deseja conectar o WhatsApp da sua loja.** São dois cartões.

### Conectar via Web

Fica no cartão **WhatsApp Web (Zapi)**: você conecta lendo o QR code com o celular da loja. Abre a [tela de conexão por QR Code](#tela-aberta-por-link-direto), em passo a passo.

### Conectar via API Oficial

Fica no cartão **API Oficial (Meta)**: a conexão é pela API Oficial do WhatsApp, com login na sua conta Meta. Abre o [passo a passo da API Oficial](#passo-a-passo-da-api-oficial).

## Passo a passo da API Oficial

<Badge>Em liberação</Badge>

Tela **API Oficial (Meta)**, aberta pelo cartão de mesmo nome. **Voltar** leva de volta para a escolha. São duas etapas:

1. **Introdução:** explica que você vai fazer login na sua conta Meta (Facebook) e escolher o número do WhatsApp Business que quer conectar à loja. Clique em **Continuar**.
2. **Conexão:** o botão que faz a conexão.

O link de conexão da API Oficial abre esta tela direto na etapa **Conexão**.

### Iniciar integração com Meta

Abre a janela de login da Meta. Entre na conta Meta (Facebook) da loja e escolha o número do WhatsApp Business. Quando a Meta termina, a Brendi cria a conexão sozinha, e a tela mostra **Conectando, aguarde...** enquanto isso. Para conferir o resultado, veja o status da API Oficial em [Conexões](/funcionalidades/atendimento/conexoes).

Se a loja já tem uma conexão pela API Oficial, antes abre a janela **Conexão existente**, avisando que a conexão atual será removida para seguir com a nova. **OK** remove a conexão atual e segue (a tela avisa **Conexão anterior removida**); **Cancelar** mantém tudo como está.

<Warning>
  Numa loja já conectada pela API Oficial, clicar em **Iniciar integração com Meta** e confirmar com **OK** desfaz a conexão atual.
</Warning>

### Finalizar conexão

Aparece no lugar de **Iniciar integração com Meta** quando a integração com a Meta já foi criada, mas a conexão do número não terminou. Clique para concluir, sem fazer login na Meta de novo.

Se algo falhar, a tela mostra o motivo:

* **Não foi possível concluir a integração com a Meta.** ou **Não foi possível criar a sessão do WhatsApp agora.**: clique em **Tentar novamente**.
* **O servidor está temporariamente indisponível.**: tente de novo em alguns minutos.
* **Não foi possível conectar. Verifique sua internet e tente novamente.**
* **Algo deu errado.**: aparece, por exemplo, quando o login na Meta não vai até o fim. A tela oferece **Falar com suporte**, que abre o contato do suporte da Brendi. Você também pode falar com o time pelo menu **Suporte** do painel: veja [Falar com o suporte](/comecar/suporte).

## Tela aberta por link direto

Tela de conexão pelo WhatsApp Web, com QR Code, código de conexão e extensão do navegador. Ela aparece em três casos:

1. **Link direto da tela Conectar seu WhatsApp**, no fluxo por QR code. Nenhum botão do painel leva até ela.
2. **Falha na conferência do fluxo da loja:** os botões de conectar do painel abrem esta tela no lugar da janela de conexão.
3. **Botão Conectar via Web**, da tela de escolha, no fluxo novo.

Nos dois primeiros casos, a tela se chama **Conectar seu WhatsApp** e ocupa a página inteira, sem o menu do painel. Ao entrar, a janela **Importação de contatos** abre por cima. Depois, a tela mostra os cartões **QR Code** (marcado como **Recomendado**, com as instruções ao lado do QR Code), **Código de conexão** (marcado como **Alternativa**) e **Ficou parado nesta tela?**, além do botão **Fazer mais tarde**. No computador, o logo da Brendi aparece no topo; no celular, o logo some e os cartões ficam um embaixo do outro, com o QR Code acima das instruções.

No terceiro caso, a tela vem em duas etapas, **Importação de contatos** e **Conectar com QR Code**, com **Voltar** para a escolha. Embaixo do QR Code ficam **Conectar por código**, **Fazer mais tarde** e o cartão da extensão.

Ao entrar, a tela confere a loja. Loja desativada: avisa **Não é possível conectar o Whatsapp de uma loja desativada.** e leva para **Financeiro › Mensalidade** (quem não é Dono cai no **Gestor de pedidos**). WhatsApp já conectado: avisa **Whatsapp já conectado à plataforma.** e leva para o **Gestor de pedidos**. Possível bloqueio nas últimas 12 horas: abre o aviso [Atenção: Risco de banimento](#aten%C3%A7%C3%A3o-risco-de-banimento). Quando a conexão completa, a tela avisa **Whatsapp conectado com sucesso!** e leva para o **Gestor de pedidos**.

### Importação de contatos

Janela, ou primeira etapa no passo a passo, que começa com dois avisos. **Antes de conectar seu WhatsApp:** pede que o número esteja aquecido para evitar bloqueios, começando com mensagens manuais e interações reais. **Dica:** recomenda usar o WhatsApp de forma orgânica no início, com mensagens manuais, para criar confiança e evitar que o número seja sinalizado.

* **Importar contatos de conversas:** importa os contatos das conversas do WhatsApp. Fica travada e vem ligada.
* **Importar nomes salvos na agenda:** ligada, os contatos importados entram com o nome; desligada, entram só com o número. Vem desligada.

**Confirmar** grava a escolha e segue para o QR Code. Na tela **Conectar seu WhatsApp**, fechar a janela pelo X não grava a escolha. Todo dia, de madrugada, a Brendi importa para a base de clientes da loja os contatos das conversas com mensagem nos últimos 90 dias.

### Gerar novo QR Code

O QR Code embaça 1 minuto depois de gerado: clique em **Gerar novo QR Code**, sobre ele, para ver outro. Se o QR Code não puder ser gerado, a tela mostra **Falha ao gerar QR Code** e sugere conectar por código. Com o QR Code 30 segundos na tela sem conectar, o cartão da extensão ganha a faixa **Ainda não conectou? O caminho é por aqui**.

### Conectar por código

Para quem não consegue escanear o QR Code. O botão abre **Informe o número para conectar**: preencha **Número de telefone** com DDD, como no exemplo da tela (11999999999), e clique em **Confirmar**. Com o campo vazio, a tela pede um número de telefone válido.

A janela **Código de conexão WhatsApp** mostra o código e como digitá-lo no celular: no WhatsApp, abra **Menu** ou **Configurações**, entre em **Dispositivos Conectados**, toque em **Conectar um Aparelho** e, quando pedir o QR code, escolha **Conectar com número de telefone**. Quando a contagem **Expira em** zera, a tela gera outro código sozinha. Se o código não puder ser gerado, a tela avisa **Erro ao gerar código de conexão.**

### Conectar pela extensão

Para quando, ao ler o QR Code, o celular mostra **Continuar no WhatsApp Web** e a conexão não completa. É a nova verificação de segurança do WhatsApp, que exige finalizar a conexão pela extensão **Z-API Conector**, no navegador.

<Warning>
  Essa conexão precisa de um computador: a extensão é de navegador (Chrome, Edge, Brave ou Opera; não funciona no Safari nem no Firefox) e não se instala no celular. O cartão **Ficou parado nesta tela?** aparece também no celular, mas por lá não dá para concluir.
</Warning>

O botão **Conectar pela extensão** abre a janela de mesmo nome, com três passos:

1. **Instale a extensão:** **Baixar extensão** abre a extensão na Chrome Web Store, numa nova aba.
2. **Conecte o WhatsApp Web:** **Abrir WhatsApp Web** abre o WhatsApp Web numa nova aba. Conecte nele o WhatsApp da loja, no mesmo navegador; se já estiver conectado, pule este passo. **Estou com dificuldade pra conectar o WhatsApp Web** traz dicas: com celular Android, use o Google Chrome no computador, logado na mesma conta Google do celular; ignore a opção **Chave de segurança**, que é para chaves físicas USB; e atualize o WhatsApp do celular.
3. **Gere o código de conexão:** marque **Instalei a extensão e conectei o WhatsApp Web** para liberar **Gerar código**. A janela mostra o código e a contagem **Expira em**; use **Copiar código** (a tela confirma com **Código copiado!**) e cole o código na extensão. Se ele expirar, clique em **Gerar novo código**.

Ao conectar pela extensão, a sessão do WhatsApp Web nesse navegador é encerrada. Depois, é só conectar o WhatsApp Web de novo para continuar usando.

### Fazer mais tarde

Sai sem conectar e leva para o **Gestor de pedidos**. Enquanto o WhatsApp estiver desconectado, o painel mostra o aviso **Whatsapp desconectado**, com o botão **Reconectar-se**.

### Atenção: Risco de banimento

Aviso que abre antes do QR Code quando o WhatsApp da loja teve um possível bloqueio nas últimas 12 horas. Sem bloqueio recente, você pode ignorá-lo. Ele explica que, depois de uma suspensão, o WhatsApp observa o aparelho, a rede e os outros números do mesmo aparelho, e recomenda: pelos próximos 2 dias, não conectar o WhatsApp ao sistema; pelos próximos 5 dias, desligar disparos automáticos e programados e o atendimento automático, e revisar a base de contatos atrás de muitos DDDs diferentes.

Se a loja tem anúncios ativos, o bloco **Atenção! Você tem anúncios ativos** lembra que, com um número novo, os anúncios podem ser rejeitados pela Meta e o número precisa ser atualizado nos anúncios. O link **Suporte** desse bloco abre a janela **Suporte Brendi**, com o contato do suporte da Brendi. Você também pode falar com o time pelo menu **Suporte** do painel: veja [Falar com o suporte](/comecar/suporte).

Marque **Entendo os riscos e concordo em seguir as recomendações acima** para liberar **Continuar mesmo assim**, que fecha o aviso e segue para a conexão. **Voltar para o Gestor** fecha o aviso sem conectar e leva para o **Gestor de pedidos**.

## Como fazer

### Conectar o WhatsApp pelo caminho do painel

<Steps>
  <Step title="Veja o fluxo da sua loja">
    Abra o menu **Atendimento** e veja se ele tem o item **Conexões**.
  </Step>

  <Step title="Sem Conexões no menu">
    Em **Atendimento › Configurações**, clique em **Conectar WhatsApp** e siga a janela [Conectar via API Web do WhatsApp](/funcionalidades/atendimento/configuracoes#conectar-via-api-web-do-whatsapp).
  </Step>

  <Step title="Com Conexões no menu">
    Em **Atendimento › Conexões**, escolha o card do jeito de conectar. Veja [Conexões](/funcionalidades/atendimento/conexoes).
  </Step>
</Steps>

### Conectar pela API Oficial por link

<Badge>Em liberação</Badge>

<Steps>
  <Step title="Escolha a API Oficial">
    Na tela **Conectar WhatsApp**, clique em **Conectar via API Oficial** e depois em **Continuar**. Pelo link de conexão da API Oficial, a tela já abre na etapa **Conexão**.
  </Step>

  <Step title="Faça login na Meta">
    Clique em [Iniciar integração com Meta](#iniciar-integra%C3%A7%C3%A3o-com-meta), entre na conta Meta (Facebook) da loja e escolha o número do WhatsApp Business.
  </Step>

  <Step title="Confira">
    Espere a mensagem **Conectando, aguarde...** sumir e confira o status em [Conexões](/funcionalidades/atendimento/conexoes).
  </Step>
</Steps>

### Conectar na tela Conectar seu WhatsApp

<Steps>
  <Step title="Passe pela importação de contatos">
    Escolha as opções de [Importação de contatos](#importa%C3%A7%C3%A3o-de-contatos) e clique em **Confirmar**.
  </Step>

  <Step title="Abra os aparelhos conectados no celular">
    No WhatsApp do celular da loja, toque em **Mais opções** (Android) ou em **Configurações** (iPhone), depois em **Dispositivos conectados** e em **Conectar dispositivo**.
  </Step>

  <Step title="Leia o QR Code">
    Aponte o celular para o QR Code da tela. Se ele estiver embaçado, clique em [Gerar novo QR Code](#gerar-novo-qr-code). Sem conseguir escanear, use [Conectar por código](#conectar-por-c%C3%B3digo).
  </Step>

  <Step title="Confira">
    Ao conectar, a tela avisa **Whatsapp conectado com sucesso!** e leva para o **Gestor de pedidos**.
  </Step>
</Steps>

## Dúvidas frequentes

<AccordionGroup>
  <Accordion title="Como sei qual fluxo de conexão a minha loja usa?">
    Se o menu **Atendimento** mostra o item **Conexões**, a loja está no fluxo novo: conecte por lá. Sem **Conexões**, a loja está no fluxo por QR code: conecte pelo botão **Conectar WhatsApp** em **Atendimento › Configurações**.
  </Accordion>

  <Accordion title="Abri um link de conexão e fui parar em outra tela. Por quê?">
    O painel leva para o caminho do fluxo da sua loja (veja [Onde encontrar](#onde-encontrar)). A tela de conexão por QR Code também sai sozinha quando o WhatsApp já está conectado (vai para o **Gestor de pedidos**) ou quando a loja está desativada (vai para **Financeiro › Mensalidade**).
  </Accordion>

  <Accordion title="Li o QR Code, mas o celular mostra Continuar no WhatsApp Web e não conecta.">
    É a verificação de segurança do WhatsApp. Finalize a conexão pela extensão do navegador, num computador: veja [Conectar pela extensão](#conectar-pela-extens%C3%A3o).
  </Accordion>

  <Accordion title="Apareceu o aviso de risco de banimento, mas não tive bloqueio. Posso seguir?">
    Pode. O próprio aviso diz que, sem bloqueio recente, você pode ignorá-lo: marque a caixa de concordância e clique em **Continuar mesmo assim**.
  </Accordion>

  <Accordion title="Quais contatos a Brendi importa do meu WhatsApp?">
    Os contatos das conversas com mensagem nos últimos 90 dias, uma vez por dia, de madrugada. O nome só vem junto com **Importar nomes salvos na agenda** ligada. Veja [Importação de contatos](#importa%C3%A7%C3%A3o-de-contatos).
  </Accordion>

  <Accordion title="Já uso a API Oficial e quero trocar o número. Como faço?">
    Na tela **API Oficial (Meta)**, clique em **Iniciar integração com Meta**. Na janela **Conexão existente**, clique em **OK**: a conexão atual é removida e você conecta o número novo pelo login da Meta.
  </Accordion>
</AccordionGroup>

## Relacionados

<CardGroup cols={2}>
  <Card title="Configurações" href="/funcionalidades/atendimento/configuracoes">
    Onde abre a janela de conexão das lojas do fluxo por QR code.
  </Card>

  <Card title="Conexões" href="/funcionalidades/atendimento/conexoes">
    Onde as lojas do fluxo novo conectam e acompanham o WhatsApp.
  </Card>

  <Card title="Atendimento" href="/funcionalidades/atendimento">
    Todas as telas desta área do painel.
  </Card>

  <Card title="Falar com o suporte" href="/comecar/suporte">
    Como falar com o time da Brendi pelo painel.
  </Card>
</CardGroup>
