---
title: "Erro \"For API Version 21 and above\" ao conectar número"
description: "Tutorial para corrigir o erro “For API Version 21 and above, please first call settings endpoint” ao cadastrar número no WhatsApp Cloud API."
url: https://help.datacrazy.io/pt-br/articles/10670779-erro-for-api-version-21-and-above-ao-conectar-numero
collection: "Erros - Cloud API e Cloud API Coexistência"
updated: 2026-11-18
language: pt-br
alternates: [en, es]
---

# Erro "For API Version 21 and above" ao conectar número

Tutorial para corrigir o erro “For API Version 21 and above, please first call settings endpoint” ao cadastrar número no WhatsApp Cloud API.

## Erro ao cadastrar número

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

**Imagem #1** – Exemplo do erro

![](https://staticfiles.gleap.io/gattachments/Aglk6kzxZCL2RU1ZndULFyzSYHF1QshDHEqVeCPsx7ZmXwDwnuox3Zaz5tBR07BcJZQzpd0dPfv.png)

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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)

(Usar o valor da coluna **Code**)

**Imagem #2** – Print da lista ISO

![](https://staticfiles.gleap.io/gattachments/HxVwRQ88VxHKopacpOQz8Wb47meipzTOq0aXViwVH2caTPcUj55e5zmKACJEccSlqsEjZY3RYpJ.png)

* * *

## Como corrigir usando ReqBin

Acesse: [https://reqbin.com](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)

![](https://staticfiles.gleap.io/gattachments/olFd31nRhzgnpCALPqHo14qkLCISRRBxJJYWw6TVP9GiuZK3DFsC0UBfg6rHjlVHwAPS1O4T6yA.png)

* * *

## 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.
