Opção «Ligar a sua app WhatsApp Business existente» não aparece

Quem controla se a opção aparece?

A plataforma que abre a janela. A documentação da Meta indica aos parceiros que acrescentem a propriedade featureType com o valor whatsapp_business_app_onboarding ao iniciar o Embedded Signup. A Meta dá também a forma de verificar: se o ecrã de seleção de conta tiver sido substituído por outro que propõe ligar uma conta WhatsApp Business existente, a funcionalidade está ativada.

Assim, quando a empresa vê os ecrãs habituais, em que se escolhe ou cria uma conta WhatsApp Business e se introduz um número para registar, a janela foi aberta sem essa definição. Nada nas definições da Meta da própria empresa altera isso. A empresa só pode mudar para uma ligação de registo de uma plataforma que a tenha ativada.

Porque é que uma plataforma pode não a oferecer?

A Meta enumera requisitos do lado da plataforma antes de a opção poder ser ativada. A plataforma já tem de ser Solution Partner ou Tech Provider, tem de saber usar a Cloud API, tem de ter um callback de webhook capaz de receber e processar webhooks, e tem de executar o Embedded Signup com registo de sessões.

Uma ferramenta alojada pelo próprio cliente, ou uma integração criada numa app de programador que não é Tech Provider, não cumpre o primeiro destes requisitos, e nesse caso a opção não é algo que uma alteração de configuração do lado da empresa consiga recuperar. A solução é uma plataforma que tenha feito este trabalho.

A outra lacuna são as versões. As versões v2 e v3 do Embedded Signup ficam obsoletas a 15 de outubro de 2026, e a Meta pede aos parceiros que passem para a v4 antes dessa data.

E se a opção aparece mas não é possível escolher a conta?

Trata-se de uma recusa diferente, e vem da conta, não da plataforma.

A referência de erros da Meta inclui o 3441047: a funcionalidade não está disponível para contas que usam mensagens de marketing, e a empresa tem de selecionar outra conta WhatsApp Business. O código 3441042 significa que a funcionalidade não está disponível para números dessa região. E uma app anterior à versão 2.24.17 é recusada, com um pedido para atualizar para a versão mais recente.

Cada um destes casos traz a sua própria mensagem na janela. Uma opção em falta, sem qualquer mensagem, remete para a forma como o fluxo foi iniciado.

Erros comuns

• Procurar nas definições da Meta da empresa um interruptor da Coexistence. A opção é definida por quem inicia a janela.
• Concluir na mesma o fluxo normal. Sem a opção, a Meta trata o número como um novo registo, o que não é Coexistence.
• Presumir que uma integração mais antiga do Embedded Signup continua a cumprir os requisitos. A Meta torna a v2 e a v3 obsoletas a 15 de outubro de 2026.

Perguntas frequentes

Continue a ler