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.

---

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.

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

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.

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.

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:
   • 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

Atenção: Tenha o seu celular com o WhatsApp Business em mãos.

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 3: 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.
   
   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!