Passo a passo completo para migrar a operação do modelo QR Code para a API Oficial da Meta — com os cuidados de preparação, configuração técnica, faturamento e as regras de comunicação que garantem envios rápidos e risco de banimento praticamente nulo.
Antes de iniciar qualquer configuração, garanta que a operação está preparada para a transição:
Negociações pendentes no modelo antigo (QR Code) devem ser finalizadas antes da migração. A API Oficial não retoma conversas antigas, e o que ficar no limbo não poderá ser continuado pela IA.
Se o número usa o recurso “Seu agente de IA” nativo do WhatsApp Business, desative-o no celular em Ferramentas > Seu agente de IA > Desconectar para evitar conflitos.
O número deve estar no aplicativo WhatsApp Business. O histórico do celular será mantido e coexistirá com a API.
Avise o cliente: o app WhatsApp Business no aparelho físico precisa ser aberto ao menos uma vez a cada 15 dias, ou a Meta paralisa o funcionamento da API.
É necessário login de um administrador do portfólio de negócios no Facebook (preferencialmente a equipe de Marketing).
Atenção: pular qualquer item desta fase pode travar a migração ou deixar negociações inacessíveis. Conclua todos os pré-requisitos antes de avançar.
No painel da Dgenny, localize o canal/número ativo no modelo antigo, clique em “Desconectar instância” e confirme a desativação.
Vá em Configurações > Integrações > API WhatsApp Oficial e clique em Conectar.
Faça login com o Facebook do administrador e selecione o Portfólio de Negócios existente.
Crie ou selecione a Conta do WhatsApp Business específica.
Insira o nome de exibição. Sem “Construção Civil” ou “Indústria”, use “Outros”, “Serviços Profissionais” ou “Compras e Varejo”.
Insira o número do telefone (DDI 55) e valide o código recebido por SMS ou ligação.
A cobrança das mensagens será absorvida pela Dgenny mediante o cadastro do cartão corporativo na conta do cliente. Acesse business.facebook.com > Cobranças e Pagamentos e selecione especificamente Contas do WhatsApp (e não contas de anúncios).
USDDgenny T LTDASelecione “Contas do WhatsApp” na seção de cobranças — cadastrar o cartão em “Contas de anúncios” não vincula o faturamento ao canal correto.
Diferente do QR Code, a API Oficial possui regras rígidas de comunicação que precisam ser explicadas à equipe de compras:
A Dgenny cria modelos de mensagens (Primeiro contato, Fornecedor VIP, Indicação, etc.) que levam de 24 a 48 horas para aprovação da Meta. Devem conter texto fixo mesclado com variáveis (tags).
Se um fornecedor ficar mais de 24h sem responder, a Meta fecha a janela de conversa. Não é possível enviar mensagens livres: o comprador ou a IA precisam enviar um template de reativação (follow-up pré-aprovado) para reabri-la.
Após a aprovação dos templates, a equipe realiza os testes finais e libera a ferramenta para uso — garantindo envios simultâneos rápidos e risco de banimento praticamente nulo.