WhatsApp Oficial OAuth com Coexistência

Números com alto índice de denúncias (status Red na Meta) podem ser desconectados do aplicativo compartilhado para proteger os demais assinantes.

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 Mediar Conversas. É a união da estabilidade da API Oficial com a praticidade de manter o celular ativo.

Etapa 1: Criando a Conexão no Painel Admin

Com o recurso liberado para a sua empresa (solicite ao suporte caso ainda não esteja disponível), acesse o painel Admin 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: você verá um menu suspenso para escolher o aplicativo. Selecione o aplicativo nativo fornecido pela plataforma (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. 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 Mediar Conversas.

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 Mediar Conversas. 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, na seção de faturamento da conta.
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 Mediar Conversas.

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 painel!

Reputação do número e restrições de uso. Ao conectar através do aplicativo compartilhado da plataforma, seu número passa a integrar o ecossistema comum de assinantes. Para proteger a estabilidade de todos, a qualidade dos canais conectados é monitorada rigorosamente.

• Status Red (Vermelho): números com alto índice de denúncias ou bloqueios (SPAM) na Meta caem para este status.
• Desconexão forçada: se o número permanecer no status Red, ele será desconectado irreversivelmente do aplicativo compartilhado.
• Bloqueio da licença: acumular números no status vermelho bloqueia a licença, impedindo a conexão de qualquer novo número pelo aplicativo compartilhado.

Recomendação para operações de risco: se o seu modelo de negócio gera denúncias frequentes e números no status Red, não utilize o aplicativo compartilhado. A orientação é configurar um App Próprio (Tech Provider) no Facebook Developers. Isso isola a sua reputação, permitindo gerenciar seus números sob a sua própria responsabilidade na Meta.

No modo de coexistência não é possível fazer ligações. Para fazer ligações pela API Oficial é necessário utilizar a Cloud API Nativa.