A opção "Conecte seu app do WhatsApp Business existente" não aparece

Quem controla a exibição da opção?

A plataforma que inicia o pop-up. A documentação da Meta orienta os parceiros a adicionar uma propriedade featureType definida como whatsapp_business_app_onboarding ao iniciar o Embedded Signup. A Meta também fornece este teste: se a tela de seleção de conta foi substituída por uma que oferece conectar uma conta existente do WhatsApp Business, o recurso está habilitado.

Assim, quando a empresa vê as telas comuns, escolhe ou cria uma conta do WhatsApp Business e informa um número para cadastrar, o pop-up foi iniciado sem essa configuração. Nada nas configurações da própria empresa na Meta altera isso. A empresa só pode mudar para um link de cadastro de uma plataforma que tenha habilitado o recurso.

Por que uma plataforma pode não oferecer essa opção?

A Meta lista requisitos do lado da plataforma antes que o recurso possa ser habilitado. A plataforma já deve ser um Solution Partner ou Tech Provider, saber usar a Cloud API, ter um callback de webhook capaz de aceitar e processar webhooks e executar o Embedded Signup com registro de sessão.

Uma ferramenta auto-hospedada ou uma integração criada em um app de desenvolvedor que não seja um Tech Provider não atende ao primeiro requisito. Nesse caso, uma mudança de configuração do lado da empresa não pode recuperar a opção. A solução é usar uma plataforma que tenha realizado esse trabalho.

A outra lacuna são as versões. O Embedded Signup v2 e v3 serão descontinuados em 15 de outubro de 2026, e a Meta orienta os parceiros a migrar para a v4 antes dessa data.

E se a opção aparecer, mas a conta não puder ser escolhida?

Essa é uma recusa diferente, originada na conta, não na plataforma.

A referência de erros da Meta lista 3441047: o recurso não está disponível para contas que usam mensagens de marketing, e a empresa precisa selecionar outra conta do WhatsApp Business. O código 3441042 significa que o recurso não está disponível para números daquela região. Um app abaixo da versão 2.24.17 é recusado com uma solicitação para atualizar para a versão mais recente.

Cada caso apresenta sua própria mensagem no pop-up. Uma opção ausente, sem nenhuma mensagem, aponta novamente para a forma como o fluxo foi iniciado.

Erros comuns

• Procurar uma opção de Coexistência nas configurações da empresa na Meta. A opção é definida por quem inicia o pop-up.
• Concluir o fluxo padrão mesmo assim. Sem a opção, a Meta trata o número como um novo cadastro, o que não é Coexistência.
• Presumir que uma integração antiga do Embedded Signup ainda atende aos requisitos. A Meta descontinua o v2 e o v3 em 15 de outubro de 2026.

Perguntas frequentes

Continue lendo