> For the complete documentation index, see [llms.txt](https://delivery.ajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://delivery.ajuda.cc/geral/deliverybot/como-conectar-o-deliverybot-no-whatsapp.md).

# Como conectar o DeliveryBot no Whatsapp

Saiba como conectar o DeliveryBot ao seu WhatsApp — pelo QR Code ou pelo número de telefone — para enviar notificações e ativar o assistente.

Existem **duas formas** de conectar o DeliveryBot ao seu WhatsApp. Escolha a que for mais prática para você:

| Método                  | Como funciona                                                                      | Ideal para                                                    |
| ----------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| **Ler QR Code**         | Você escaneia um código na tela com a câmera do WhatsApp.                          | Quem está **no computador** e tem o celular em mãos.          |
| **Conectar com número** | Você informa o número e recebe um código de 8 caracteres para digitar no WhatsApp. | Quem está **no celular**, sem uma segunda tela para escanear. |

{% hint style="info" %}
Os dois métodos conectam o mesmo WhatsApp e têm o mesmo resultado. Se um não funcionar, tente o outro.
{% endhint %}

## Antes de começar

{% hint style="warning" %}
**Aqueça seu número antes de conectar.** Use o WhatsApp normalmente por alguns dias — enviando mensagens manuais e tendo conversas reais — antes de ativar o DeliveryBot. Isso cria confiança e evita que o WhatsApp sinalize ou bloqueie o número.
{% endhint %}

Tenha em mãos:

* O **celular** com o WhatsApp que será conectado à loja.
* O número no formato correto, com **DDD** (ex.: `11 96123-4567`).

## Passo a passo

{% stepper %}
{% step %}

#### Acesse o DeliveryBot

No menu lateral do painel, clique em **DeliveryBot**.
{% endstep %}

{% step %}

#### Configure o WhatsApp

Na seção **Canais**, localize o card do **WhatsApp** e clique em **Configurar**.
{% endstep %}

{% step %}

#### Escolha como quer conectar

A tela **Conecte seu WhatsApp** será exibida com as duas opções. Clique na que preferir:

* **Ler QR Code** — ideal no computador
* **Conectar com número** — ideal no celular

<figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-265cba506c6844568721ebf76624da767286e4c8%2Fdeliverybot-whatsapp-escolha-metodo.png?alt=media" alt="Tela de escolha entre conectar por QR Code ou por número de telefone"><figcaption><p>Escolha como quer parear o aparelho</p></figcaption></figure>
{% endstep %}

{% step %}

#### Conclua a conexão

Siga as instruções do método escolhido — veja os detalhes de cada um logo abaixo.
{% endstep %}

{% step %}

#### Pronto!

Após a confirmação, o status mudará para **Conectado** com o número do WhatsApp exibido. O DeliveryBot está pronto para uso.

<figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-72f9c58372c7d5cdc6b475b825cb6c62219bf820%2Fdeliverybot-whatsapp-conectado.png?alt=media" alt=""><figcaption><p>WhatsApp conectado com sucesso</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Opção 1: Ler QR Code

Recomendado quando você está **no computador** e tem o celular por perto.

Ao escolher essa opção, um QR Code aparece na tela junto com os 4 passos a seguir no celular:

<figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-fe5dfbc2a18262aeee4f738243b72a9fffe3441d%2Fdeliverybot-whatsapp-qrcode-passos.png?alt=media" alt="QR Code exibido no painel com os quatro passos para escanear pelo celular"><figcaption><p>QR Code e os passos para escanear pelo WhatsApp</p></figcaption></figure>

No seu celular:

1. **Abra o WhatsApp**.
2. Toque no **menu** (⋮ no Android, ou **Configurações** no iPhone).
3. Toque em **Aparelhos conectados** → **Conectar um aparelho**.
4. **Aponte a câmera** para o QR Code na tela do painel.

{% hint style="info" %}
O QR Code **expira depois de alguns instantes**. Se ele sumir ou parar de funcionar, feche e abra a tela de configuração novamente para gerar um novo.
{% endhint %}

## Opção 2: Conectar com número

Recomendado quando você está **no celular** e não tem uma segunda tela para escanear o código.

<figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-b5279e281d9e4967a84fac8391af7548d54393bd%2Fdeliverybot-whatsapp-conectar-numero.png?alt=media" alt="Modal para informar o número do WhatsApp e enviar o código de pareamento"><figcaption><p>Informe o número que será conectado</p></figcaption></figure>

1. Informe o **Número do WhatsApp** que será conectado, com DDD. O código do país (**+55**) já vem preenchido.
2. Clique em **Enviar código**.
3. Um **código de 8 caracteres** será exibido na tela do painel.

<figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-8de14dbfcb9559dad11296945a467cc539a0df2f%2Fdeliverybot-whatsapp-codigo-8-digitos.png?alt=media" alt="Tela do painel exibindo o código de 8 caracteres para digitar no WhatsApp"><figcaption><p>Código exibido no painel — o seu será diferente deste</p></figcaption></figure>

4. No celular, abra o **WhatsApp** → **Aparelhos conectados** → **Conectar um aparelho** → **Conectar com número de telefone**.
5. **Digite o código** no aplicativo.

{% hint style="warning" %}
Informe o número **exatamente como ele está cadastrado no WhatsApp**, com o DDD correto. O código é gerado para aquele número específico — se ele estiver errado, o pareamento não será aceito pelo aplicativo.
{% endhint %}

{% hint style="info" %}
O código **expira em cerca de 2 minutos**. Tenha o celular em mãos antes de clicar em **Enviar código**. Se ele expirar, volte à tela de configuração e gere um novo.
{% endhint %}

{% hint style="warning" %}
O WhatsApp precisa estar conectado para que as Notificações de Pedidos e o Assistente de Atendimento funcionem.
{% endhint %}

{% hint style="info" %}
Para desconectar o WhatsApp, acesse a configuração do canal e clique em **Desconectar**.
{% endhint %}

## Erro: "Não é possível conectar novos dispositivos no momento"

Se ao escanear o QR Code o WhatsApp exibir a mensagem **"Não é possível conectar novos dispositivos no momento"**, fique tranquilo: esse aviso é do **próprio WhatsApp**, não do DeliveryBot. É uma proteção do WhatsApp que bloqueia o pareamento quando algo na conexão do **seu celular** parece suspeito — na maioria dos casos, um app de VPN ou o Relay Privado do iCloud (no iPhone), que fazem a internet do celular sair por um caminho que o WhatsApp não confia.

Siga os passos abaixo, na ordem, testando o QR Code novamente após cada um. Os passos 1 a 3 resolvem a maioria dos casos:

1. **Desative a VPN** — se você usa algum app de VPN no celular, desative-o e tente escanear de novo.
2. **iPhone: desative o Relay Privado do iCloud** — vá em **Ajustes → \[seu nome] → iCloud → Relay Privado**, desative e tente escanear de novo.
3. **Alterne a conexão** — se estava no Wi-Fi, tente com os dados móveis (4G/5G); se estava nos dados móveis, tente no Wi-Fi.
4. **Tente o outro método de conexão** — se estava usando o QR Code, tente **Conectar com número** (ou o contrário). Às vezes um caminho funciona quando o outro está bloqueado.
5. **Atualize o WhatsApp** — baixe a versão mais recente na App Store ou Play Store.
6. **Verifique o limite de dispositivos** — no WhatsApp, abra **Dispositivos conectados** e veja se já existem 4 dispositivos vinculados (limite do WhatsApp). Se sim, remova um que você não usa.
7. **iPhone, último recurso: redefina os Ajustes de Rede** — vá em **Ajustes → Geral → Transferir ou Redefinir o iPhone → Redefinir → Redefinir Ajustes de Rede**, reconecte ao seu Wi-Fi e tente escanear de novo. Esse passo já resolveu casos em que nada mais funcionou.
8. **Se nada resolver, aguarde algumas horas** — o WhatsApp aplica um bloqueio temporário, principalmente se o número foi desvinculado e vinculado várias vezes em pouco tempo. Depois, gere um QR Code novo e escaneie **uma única vez** (evite clicar em gerar o QR Code repetidamente).

{% hint style="warning" %}
O passo 7 (Redefinir Ajustes de Rede) **apaga as senhas de Wi-Fi salvas** no iPhone. Tenha a senha da sua rede em mãos antes de fazer isso.
{% endhint %}

## Próximos passos

Após conectar o WhatsApp, configure os módulos do DeliveryBot:

{% content-ref url="/pages/sej0NX0zDHzGJBPEP2me" %}
[Notificação de pedidos](/geral/deliverybot/notificacao-de-pedidos.md)
{% endcontent-ref %}

{% content-ref url="/pages/WdNOWfHCc9I0DqXlmmwm" %}
[Assistente de atendimento](/geral/deliverybot/assistente-de-atendimento.md)
{% endcontent-ref %}