# WhatsApp Oficial OAuth (login)

#### O que é o Modo de Coexistência?

Ao utilizar este método, você conecta o seu número à API Oficial da Meta sem precisar desconectá-lo do seu aparelho celular. O WhatsApp passará a funcionar **simultaneamente** no aplicativo WhatsApp Business do seu smartphone e no painel do Z-PRO. É a união da estabilidade da API Oficial com a praticidade de manter o celular ativo.

{% embed url="<https://youtu.be/v-eVzsAwJXQ>" %}

{% hint style="danger" %}
**NOVA URL OAUTH:** [**https://oauth.techprovider.com.br**](https://oauth.techprovider.com.br)
{% endhint %}

***

### Etapa 0: Ativação do Canal no Painel Super Admin

A liberação do recurso OAuth é feita por empresa (Tenant). Se você é o assinante do ZPRO, siga estes passos. Se você é um cliente ou está usando apenas o acesso demo do sistema, solicite essa liberação ao suporte e pule para a etapa 1.

Faça login no sistema com seu usuário **Super Admin**.

No menu lateral, acesse **Tenants** (Empresas) e clique em **Editar** na empresa desejada.

<figure><img src="/files/dZC7HihcSoBfPYD1wU1s" alt=""><figcaption></figcaption></figure>

Role a página até encontrar a opção **OAuth (Login Incorporado)** e ative a chave.

<figure><img src="/files/IBaDkgokZiwEih9yQgAv" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="danger" %}
**NOVA URL OAUTH:** [**https://oauth.techprovider.com.br**](https://oauth.techprovider.com.br)
{% endhint %}

Volte mais acima, na seção de liberação de canais, certifique-se de que o **WhatsApp**, **Facebook** e **Instagram** estão habilitados para este tenant.

<figure><img src="/files/V6jrqirMSIgJ43sk2mxK" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Metal URL:** <https://oauth.techprovider.com.br>

**Instagram Webhook**&#x20;

• URL: <https://oauth.techprovider.com.br/instagram-webhook&#x20>;

• Segredo: 2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1

**Messenger Webhook**&#x20;

• URL: <https://oauth.techprovider.com.br/messenger-webhook&#x20>;

• Segredo: 2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1
{% endhint %}

Clique em **Salvar**.

### Etapa 1: Criando a Conexão no Painel Admin

Com o recurso liberado, acesse a conta da empresa (Admin normal) para realizar a conexão.

<figure><img src="/files/OiuWDbWzBZibERhtB352" alt=""><figcaption></figcaption></figure>

1. No menu lateral, acesse **Administração > Canais**.
2. Clique no botão **Adicionar Canal**.
3. No campo "Tipo de Canal", selecione a opção **WhatsApp OAuth**.
4. **Selecione o Aplicativo Meta:** Você verá um menu suspenso para escolher o aplicativo.
   * Selecione o aplicativo nativo fornecido pela plataforma (ex: teste login incorporado tech provider zdg ou ZDG App).
   * (Nota: Caso sua empresa seja um Tech Provider aprovado pela Meta, você poderá selecionar seu próprio App configurado previamente).
5. Clique no botão azul **Conectar via WhatsApp OAuth**.

### Etapa 2: Autenticação com a Meta e Leitura do QR Code

Ao clicar em conectar, uma janela pop-up oficial do Facebook/Meta será aberta. **Atenção:** Tenha o seu celular com o WhatsApp Business em mãos.

<figure><img src="/files/0EnUpPPLJDgirl9dZeWv" alt=""><figcaption></figcaption></figure>

1. Na janela da Meta, clique em **Continuar** e faça o login com seu Facebook.
2. Siga as instruções da tela para selecionar ou criar a sua conta do WhatsApp Business e seu Gerenciador de Negócios.
3. **Insira o Número:** Digite o número de telefone exato que está no seu WhatsApp Business.
4. **Aprovação no Celular:**
   * Abra o aplicativo WhatsApp Business no seu celular.
   * Você receberá uma notificação da Meta solicitando a conexão.
   * Aceite a notificação. O aplicativo solicitará que você faça a **leitura de um QR Code** (ou aprove o compartilhamento de conversas) diretamente na tela do computador.
5. Após confirmar no celular, a janela da Meta será finalizada e o canal aparecerá como **Conectado** no ZPRO.

Pronto! Seu número já está operando em Modo de Coexistência. As mensagens chegarão tanto no seu celular quanto na tela de atendimento do Z-PRO. Como esta é uma conexão via API Oficial, você não sofrerá com bloqueios relacionados ao uso de sistemas de terceiros.

### Etapa 4: Configuração de Pagamento na Meta

Embora a conexão já esteja funcionando para receber e responder mensagens dentro da janela de 24 horas, há um passo final recomendado pela Meta.

Ao conectar seu WhatsApp Business, a Meta realizará uma análise final da sua empresa. Após isso, para que você possa enviar **mensagens ativas (templates/campanhas de massa)** fora da janela de 24 horas, é obrigatório cadastrar uma forma de pagamento na Meta.

1. Acesse o seu painel do **Gerenciador de Negócios da Meta**.
   1. <https://business.facebook.com/billing_hub/accounts>
2. Vá nas configurações de conta do WhatsApp Business.
3. Encontre a conta de WhatsApp que foi conectada e adicione um **Cartão de Crédito**.
4. A partir desse momento, sua conta estará 100% apta para receber, responder e iniciar novas conversas (disparos) através do ZPRO.

Para testar, envie uma mensagem de outro número para o seu WhatsApp Business. Você verá a mensagem chegando instantaneamente no seu celular e na aba "Pendentes" na tela de atendimento do seu ZPRO!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.