Erro exibido ao conectar numero "For API Version 21 and above, please first call settings endpoint"

Erro ao cadastrar número

Mensagem exibida: "For API Version 21 and above, please first call settings endpoint"

Imagem #1 – Exemplo do erro

Esse erro ocorre nas versões mais novas da API do WhatsApp Cloud (v21+), quando o endpoint de configurações obrigatórias ainda não foi chamado para o número antes do registro (/register).

O que precisamos pegar antes

Você vai precisar de 3 informações:

• PhoneNumberID

• Token da conexão

• Código do país (ISO 3166-1 alpha-2)

Como obter o PhoneNumberID e o Token

Podem ser capturados pelo navegador:

1. Abra o painel onde está ocorrendo o problema de conexão

2. Pressione F12

3. Vá na aba Network

4. Refaça a ação de Gerenciar conexão

5. Localize a requisição

6. Dentro dela você encontrará:

   • PhoneNumberID

   • Access Token

No Mac:

• Botão direito → Inspecionar

Código do país

O código precisa estar no padrão: ISO 3166-1 alpha-2

Exemplo:

• Brasil = BR

Para outros países, consultar a lista: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

(Usar o valor da coluna Code)

Imagem #2 – Print da lista ISO

Como corrigir usando ReqBin

Acesse: https://reqbin.com

Use método POST com a URL:

https://graph.facebook.com/v24.0/_phoneNumberID_/settings?access_token=_token_

Substitua:

• _phoneNumberID_ → pelo phoneNumberID da sua conexão, tirada do F12

• _token_ → pelo token retirado do F12(Ou criando app, veja nosso tutorial de tracking que ensina isso)

JSON para enviar

{ "storage_configuration": { "status": "IN_COUNTRY_STORAGE_ENABLED", "data_localization_region": "CodigoDoPais_Em_ISO_3166_1_alpha_2_code" } }

Imagem #3 – Inserir PhoneNumberID, Token e código do país (ex: BR)

Resultado esperado

Após clicar em SEND no ReqBin:

Se aparecer em verde: 200 (OK)

Isso significa que:

• A configuração foi aplicada corretamente

• O número já pode ser conectado novamente

Agora basta repetir o processo de conexão no CRM.

Se der erro

Caso retorne outro erro:

• Verifique se o PhoneNumberID está correto

• Confirme se o Token está correto

• Revise o código do país no formato ISO

Se necessário:

• Pesquise o erro retornado

• Ou envie o contexto completo do que está tentando fazer + erro que deu pro chatGPT. É importante dizer oque você quer fazer, enviar como fez e o erro que deu.
  Temos a comunidade também pra ajudar e podes abrir em ultimos casos chamado no suporte se for necessário tambem.