Solução de problemas da coexistência do WhatsApp

A configuração da coexistência acontece na janela da Meta. A Meta decide se o seu número segue o caminho do app WhatsApp Business depois que você o insere, então você não precisa ativar nada antes no seu espaço de trabalho do Bird. Conecte o número do seu app WhatsApp Business descreve uma configuração concluída com sucesso.

As seções citam as mensagens da Meta e o código depois de #, então procure a que corresponde ao que a Meta mostra para você. Para problemas que também afetam números conectados sem o app, como a verificação de segurança da Meta ou uma conta comercial bloqueada, consulte Solução de problemas de números do WhatsApp.

Para consultar um código que esta página não aborda, veja Erros de conexão e coexistência do WhatsApp.

Se a Meta mostrar "Bird B.V. can't onboard customers right now" ou "Bird B.V. can't onboard customers at the moment", tente novamente mais tarde.

A Meta mostra as opções de mensagem de texto e ligação

Depois que você insere o número, a etapa de telefone da Meta lista as opções de verificação Text message e Phone call. A tela parece a configuração padrão de número, e nenhum QR code aparece ainda.

Essa tela é esperada. A Meta mostra a mesma etapa de telefone antes de mudar para o caminho do app WhatsApp Business.

1. Escolha Enter a new phone number e digite o número que você usa no app WhatsApp Business. Se a Meta listar o seu número como não qualificado para compartilhamento, ignore essa entrada e digite o número.
2. Mantenha a opção de verificação como está e selecione Next.
3. Avance pelo perfil comercial e pelo portfólio empresarial. O QR code aparece depois deles.

Se uma tela posterior pedir que você digite um código de seis dígitos, a Meta iniciou o registro padrão. Feche a janela e siga A Meta pede um código de verificação de seis dígitos.

A Meta informa que o tipo de conta não permite compartilhamento com parceiros

Depois que você insere seu número, a Meta mostra esta mensagem na etapa do telefone (#2655115): "This account type doesn't support partner sharing. Contact support for options."

Se o número usa o aplicativo WhatsApp Business, confira qual opção você escolheu no Bird. Set up a number inicia a configuração padrão de um número. Para continuar usando o aplicativo, escolha Keep using the Business app:

1. Feche a janela da Meta.
2. No Bird, escolha New number e depois Keep using the Business app e comece de novo.

Se o número não usa o aplicativo WhatsApp Business, ou se o erro persistir na opção do aplicativo, entre em contato com o suporte e informe o código da Meta e o Session ID exibido no Bird.

A Meta não consegue carregar as informações de pareamento

A Meta interrompe a conexão do aplicativo WhatsApp Business com o erro #4563004.

Tente novamente.

A Meta informa que faltam permissões de pareamento

A Meta informa que faltam permissões da Graph API para parear dispositivos complementares pela Cloud API (#4563039).

Uma conta de mensagens do tipo WhatsApp Business App que sobrou de uma tentativa anterior pode causar esse erro. O número aparece como Offline nessa conta. O aplicativo da Bird tem as permissões necessárias.

1. No Meta Business Suite, abra a conta de mensagens do tipo WhatsApp Business App que mostra seu número como Offline. Essa conta não tem a aba Two-step verification.
2. Escolha Remove from business portfolio. Se a conta ainda aparecer como desativada, remova-a novamente.
3. Aguarde 5 minutos e conecte o número à Bird novamente.

A Meta informa que o número já está registrado em uma conta do WhatsApp

Assim que você digita o número, a Meta mostra esta mensagem abaixo do campo de telefone (#2494064): "This phone number is already registered to a WhatsApp account. To use this number, disconnect it from the existing account. Then, return to this page and try again. It can take up to 3 minutes for the number to refresh."

Esse erro geralmente significa que o número está registrado no WhatsApp, o app pessoal, e não no app WhatsApp Business. A coexistência conecta contas do app WhatsApp Business, então a Meta recusa um número pessoal do WhatsApp.

1. No seu celular, verifique em qual app o número está registrado.
2. Se for o WhatsApp, transfira a conta para o app WhatsApp Business. O guia do WhatsApp sobre como transferir sua conta do WhatsApp Messenger para o WhatsApp Business explica como fazer backup e levar suas conversas.
3. No Bird, escolha New number e depois Keep using the Business app e comece de novo.

Não exclua a conta para desconectar o número, como a mensagem sugere. A exclusão apaga as conversas da conta, e a coexistência exige que o número continue no WhatsApp Business app.

Se o número já funciona no WhatsApp Business app, a Meta não o está tratando como um número do Business app. O mesmo vale quando a Meta mostra #2388091 ou #2655095, ou quando a etapa do QR code não aparece:

1. Atualize o WhatsApp Business app para a versão mais recente.
2. No app, desative a verificação em duas etapas.
3. No WhatsApp Manager, abra Phone numbers e exclua qualquer entrada do número marcada como pendente ou desconectada. Se o Bird mostrar o número como Failed, desconecte-o também no Bird.
4. Aguarde 5 minutos.
5. No Bird, escolha New number e comece de novo. A caixa de diálogo seleciona Set up a number por padrão, então mude primeiro para Keep using the Business app.

No caminho certo, a Meta mostra Verify your account details e depois um QR code. Se a Meta pedir um código de seis dígitos, siga A Meta pede um código de verificação de seis dígitos.

A Meta pede um código de verificação de seis dígitos

Depois que você seleciona Next na etapa do telefone, uma tela seguinte pede que você digite um código de seis dígitos que a Meta enviou por mensagem de texto ou ligação. Nenhum QR code aparece.

As opções Text message e Phone call na própria etapa do telefone são esperadas, e você seleciona Next ali. Uma tela seguinte que pede para digitar o código significa que a Meta iniciou o registro padrão do número em vez do caminho do WhatsApp Business app. Deixe o código em branco, feche a janela da Meta e confira estes pontos uma vez:

1. No Bird, escolha Keep using the Business app antes de selecionar Connect WhatsApp.
2. Atualize o app WhatsApp Business para a versão mais recente. A Meta exige a versão 2.24.17 ou posterior.
3. No app, abra Settings > Account > Business Platform. Se houver uma plataforma comercial conectada, desconecte-a e aguarde 15 minutos.
4. No WhatsApp Manager, abra Phone numbers e procure uma entrada do número marcada como desconectada, pendente ou não verificada. Abra a aba Two-step verification dela e selecione Turn off two-step verification, para que o número possa ser registrado novamente sem o PIN. Depois, exclua a entrada.
5. Comece de novo no Bird em um computador com Chrome ou Safari.

A Meta não consegue enviar um código de verificação

A Meta mostra "Request code failed: Our servers are temporarily unavailable..." (#2388091) na etapa de verificação do telefone.

Esse erro vem da etapa de código do registro padrão de números, então o cadastro não está no caminho do app WhatsApp Business. Solicitar outro código não conecta o número com coexistência. Siga as verificações em A Meta pede um código de verificação de seis dígitos e comece de novo.

A Meta pede que você entre em contato com a Bird B.V. depois que você escaneia o QR code

Você escaneia o QR code, e a janela da Meta diz para entrar em contato com o parceiro Bird B.V. para resolver o problema de conexão do número de telefone. O número não aparece no Bird.

Uma entrada do número de uma tentativa anterior ainda está em uma WhatsApp Business Account e bloqueia a conexão do app WhatsApp Business.

1. No app WhatsApp Business, abra Settings > Account > Business Platform. Se houver uma plataforma comercial conectada, desconecte-a e aguarde 15 minutos.
2. No WhatsApp Manager, abra Phone numbers e encontre a entrada do número marcada como desconectada, pendente ou não verificada.
3. Abra a aba Two-step verification da entrada e selecione Turn off two-step verification, para que o número possa ser registrado novamente sem o PIN. Depois, exclua a entrada.
4. No Bird, escolha New number, depois Keep using the Business app, e comece de novo.

O número mostra Failed com Cannot Create Certificate

Depois da configuração da Meta, o número no Bird mostra Failed com "Cannot Create Certificate: This number is registered to an existing WhatsApp account."

A Meta processou a tentativa como registro padrão de número, que não aceita um número ativo no WhatsApp Business app. A tentativa também deixou uma entrada do número no WhatsApp Manager, e essa entrada bloqueia a próxima tentativa.

1. Desconecte o número com falha no Bird.
2. No WhatsApp Manager, abra Phone numbers e encontre a entrada do número marcada como desconectada, pendente ou não verificada.
3. Abra a aba Two-step verification da entrada e selecione Turn off two-step verification, para que o número possa ser registrado novamente sem o PIN. Depois, exclua a entrada.
4. Aguarde alguns minutos e, no Bird, escolha New number, depois Keep using the Business app, e comece de novo.

A Meta informa um erro de elegibilidade

A Meta verifica cada número quando você o insere. Ela não publica uma lista de países compatíveis, e o Bird não consegue verificar com antecedência se um número é elegível. A referência de erros de integração do Business app da Meta lista a maioria destas mensagens:

A Meta diz que o número não está qualificado para registro ou migração

A Meta mostra "This phone number is not eligible to register or migrate." (#3441034). A janela da Meta também pode listar sua conta do app WhatsApp Business com o rótulo Ineligible.

A entrada Ineligible é esperada, e você não precisa excluir o app WhatsApp Business.

1. Não selecione a entrada Ineligible. Em vez disso, digite o número de telefone.
2. No app WhatsApp Business, abra as configurações do Facebook e do Instagram e desvincule os dois. Dependendo da versão do app, elas ficam em Settings ou Business tools.
3. Na sua Página do Facebook, abra Settings > Linked accounts e confirme que WhatsApp mostra Not connected.
4. Entre na Meta com uma conta do Facebook que tenha controle total do portfólio empresarial dono do número.
5. No Meta Business Suite, abra Settings > Accounts > Messaging accounts. Se houver uma conta do WhatsApp para o número na lista, confirme que nada mais a usa e selecione ⋯ > Remove from business portfolio. Se a conta ainda aparecer como desativada, remova-a novamente. A remoção não afeta o número no app WhatsApp Business.
6. No Bird, escolha New number, depois Keep using the Business app, digite o número e leia o QR code.

A Meta informa que o número já está em uso por outra conta

Você quer manter o número no app WhatsApp Business, mas a Meta informa que ele já está em uso por outra conta.

O número ainda está vinculado ao Facebook ou ao Instagram. Desvincule-o no app WhatsApp Business, nas configurações do Facebook e do Instagram, e na sua Página do Facebook, em Settings > Linked accounts, para que WhatsApp mostre Not connected. Depois, comece de novo no Bird com Keep using the Business app.

A Meta informa que o cancelamento do registro está em andamento

A Meta recusa o número com #3441055. O número ainda está sendo removido da conexão anterior, e a Meta volta a aceitá-lo quando esse processo terminar. Aguarde e comece de novo no Bird.

A Meta informa um agente de IA do Business ou eventos automatizados

A Meta recusa o número com #3441060 ou #3441061. O número ainda está vinculado a um agente de IA do Business ou a eventos automatizados no app WhatsApp Business.

1. No app, desvincule o Business AI agent.
2. Desative as listas automáticas citadas na mensagem da Meta em Business tools > Lists.
3. No Bird, escolha New number, depois Keep using the Business app, e comece de novo.

A Meta informa que a avaliação de gate do CoEx está ausente

A Meta interrompe a configuração com uma mensagem informando que a avaliação de gate do CoEx está ausente. Essa é a verificação de segurança da Meta na sua conta do Facebook, e ela ainda não foi concluída. Conclua a solicitação descrita em A Meta pede que você confirme sua identidade e comece de novo com o portfólio empresarial que é dono do número.

A Meta informa que você não tem permissão para ver este ativo

A Meta mostra "You don't have the necessary permissions to view this asset. Contact the asset owner to get permission or complete this action with the owner's account." (#3441038), geralmente logo depois que você insere o número.

A conta do Facebook com que você entrou não consegue abrir o portfólio empresarial que a Meta vincula ao número.

1. Entre na Meta com uma conta do Facebook que tenha controle total do portfólio empresarial ao qual pertence sua conta do app WhatsApp Business.
2. No app WhatsApp Business, abra as configurações do Facebook e do Instagram. Dependendo da versão do app, elas ficam em Settings ou Business tools. Se nenhuma Página do Facebook estiver vinculada, vincule a Página da sua empresa e comece de novo.
3. Se o número pertencer a um portfólio que ninguém da sua equipe consegue acessar, recupere o acesso pela Meta. O Bird não consegue ver nem liberar esse portfólio.

O número foi conectado no app WhatsApp Business, mas não aparece no Bird

A última tela da Meta informa que sua conta está conectada à Bird B.V., e o app lista Bird B.V. em Business Platform, mas a página Numbers no Bird não mostra o número. O Bird também pode mostrar "Meta did not complete the app connection. Start the flow again."

O Bird adiciona o número quando a janela da Meta devolve o resultado à página do Bird que a abriu. Um navegador de celular ou de dentro de um app, um pop-up bloqueado, uma página do Bird atualizada ou uma janela fechada antes do último botão da Meta podem impedir que esse resultado chegue ao Bird.

1. Use um computador com Chrome ou Safari e permita pop-ups para o bird.com.
2. No Bird, escolha New number, depois Keep using the Business app, e selecione Connect WhatsApp.
3. Mantenha a página do Bird aberta e não a atualize enquanto a janela da Meta estiver aberta.
4. Na última tela da Meta, selecione Continue to feature setup. Se você fechar a janela em vez disso, o Bird pode ficar sem o resultado.

Cada tentativa desconecta os dispositivos vinculados ao app, então reconecte-os quando o número mostrar Connected.

O número falha por incompatibilidade de moeda

O número exibe Failed com credit_currency_mismatch e uma mensagem como "This WhatsApp Business Account already bills in BRL, and the credit line we attach bills in USD, EUR, or GBP."

O Bird paga à Meta pelas mensagens enviadas pelo Bird com uma linha de crédito em USD, EUR ou na moeda de faturamento da sua organização, GBP neste exemplo. A Meta permite uma moeda por WhatsApp Business Account. A coexistência conecta a conta que seu aplicativo WhatsApp Business já usa, portanto escolher uma nova conta durante a configuração não evita a incompatibilidade.

Primeiro, tente alterar a moeda da conta existente:

1. Desconecte o número com falha no Bird e desconecte a Bird B.V. no WhatsApp Business app, em Settings > Account > Business Platform.
2. No Meta Business Suite, abra as configurações da empresa para a WhatsApp Business Account e remova a forma de pagamento dela.
3. Defina a moeda da conta como uma das moedas indicadas na mensagem do Bird.
4. No Bird, escolha New number, depois Keep using the Business app, e comece de novo.

Se a Meta não permitir que você altere a moeda, o número não poderá se conectar ao Bird por coexistência enquanto a conta for faturada em uma moeda que não esteja indicada na mensagem do Bird. Entre em contato com o suporte para discutir suas opções.

Alterações no perfil comercial retornam E15088

Ao atualizar o perfil comercial de um número com coexistência pelas ferramentas CLI ou MCP, o retorno é 412 com E15088: "This number's business profile is managed in the WhatsApp Business app and cannot be updated through the API." No painel, o Business profile do número mostra os dados com a edição desativada e a observação "Manage this profile in the WhatsApp Business app". A leitura do perfil funciona.

A Meta não permite alterar o perfil comercial pela API em números do WhatsApp Business app, então tentar novamente retorna o mesmo erro. Edite o nome, a descrição, o endereço, o site ou a foto no WhatsApp Business app, em Business tools > Business profile.

O histórico de conversas importado não aparece na lista de mensagens

Você compartilhou seu histórico de conversas durante a configuração, e Conversations mostra as conversas antigas. Listar mensagens do WhatsApp retorna mensagens a partir do dia em que o número foi conectado, e filtrar por datas anteriores não retorna nada.

A lista de mensagens do WhatsApp começa quando o número é conectado, por isso não inclui o histórico importado. Em vez disso, leia o histórico importado a partir de uma conversa:

• No painel, selecione a contagem de mensagens importadas no cartão Coexistence do número para abrir as conversas em Conversations.
• Pela CLI ou por um agente de IA, liste as mensagens de uma conversa com bird whatsapp conversations list-messages. O servidor Bird MCP oferece a mesma ferramenta.

As mensagens do WhatsApp ficam guardadas por 30 dias. Por isso, a importação traz as mensagens compartilhadas dos últimos 30 dias, e as mensagens mais antigas permanecem no app WhatsApp Business. Selecione a contagem de contatos no cartão Coexistence para abrir o público que contém os contatos importados.

Depois da conexão, algumas primeiras mensagens de clientes podem chegar como indisponíveis, com o erro 131060. A Meta prevê esse comportamento para números do app WhatsApp Business. Consulte mensagens não suportadas.

O número aparece como Disconnected

Um número em coexistência que estava Connected agora aparece como Disconnected.

A Meta avisa a Bird quando alguém desconecta a Bird do número, por exemplo ao selecionar Disconnect Account em Settings > Account > Business Platform no app WhatsApp Business.

1. Selecione Reconnect no número na Bird.
2. Conclua as etapas da Meta com o app WhatsApp Business aberto no seu celular.
3. Envie uma mensagem para o número e confira se ela chega à Bird.

Para desconectar você mesmo um número em coexistência da Bird, selecione Disconnect Account no app WhatsApp Business, em Settings > Account > Business Platform. O número continua funcionando no app. Na Bird, ele aparece como Disconnected e deixa de enviar e receber mensagens. Selecionar apenas Disconnect number na Bird mantém a Bird B.V. conectada no app. Para usar o número com outro provedor depois, siga Moving a number to another provider.

Grupos não estão disponíveis pela Bird

Com um número em coexistência, você não consegue criar grupos do WhatsApp nem enviar mensagens a eles pela Bird, e os grupos que você tem no app WhatsApp Business não aparecem na Bird.

Os chats em grupo permanecem no app, conforme descrito nos limites da coexistência, e a Meta não oferece grupos pela API para números do app WhatsApp Business. Os grupos pela Bird exigem um número conectado pela configuração padrão e com status de Official Business Account.

O número já está conectado sem coexistência

Você conectou o número com Set up a number e agora quer que sua equipe responda pelo app WhatsApp Business.

Um número conectado com a configuração padrão não pode mudar para coexistência diretamente. Conecte-o novamente:

1. Desconecte o número no Bird. Ele não consegue enviar mensagens pelo Bird até que a nova conexão seja concluída.
2. Registre o número no app WhatsApp Business no seu celular. Para um telefone fixo, escolha a verificação por ligação.
3. No Bird, escolha New number, depois Keep using the Business app, e siga a configuração da coexistência.

O número recebe um novo ID no Bird. Se a Meta conectá-lo a outra WhatsApp Business Account, envie seus modelos novamente nessa conta.

Próximos passos

• Coexistência do WhatsApp: limites, mudanças no app e custos.
• Conecte seu número do app WhatsApp Business: cada tela da configuração.
• Solução de problemas de números do WhatsApp: contas bloqueadas, verificações de segurança e outros problemas que afetam qualquer número.