Erro exibido ao conectar número "Para a versão de API 21 e superiores, por favor primeiro chame o endpoint de configurações"

Error al registrar número

Mensaje mostrado: "For API Version 21 and above, please first call settings endpoint"

Imagen #1 – Ejemplo del error

Este error ocurre en las versiones más nuevas de la API de WhatsApp Cloud (v21+), cuando el endpoint de configuraciones obligatorias aún no fue llamado para el número antes del registro (/register).

Qué necesitamos obtener antes

Vas a necesitar 3 informaciones:

• PhoneNumberID

• Token de la conexión

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

Cómo obtener el PhoneNumberID y el Token

Pueden ser capturados por el navegador:

1. Abre el panel donde está ocurriendo el problema de conexión

2. Presiona F12

3. Ve a la pestaña Network

4. Repite la acción de Gestionar conexión

5. Ubica la solicitud

6. Dentro de ella vas a encontrar:

   • PhoneNumberID

   • Access Token

En Mac:

• Botón derecho → Inspeccionar

Código del país

El código tiene que estar en el estándar: ISO 3166-1 alpha-2

Ejemplo:

• Brasil = BR

Para otros países, consulta la lista: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

(Usa el valor de la columna Code)

Imagen #2 – Captura de la lista ISO

Cómo corregir usando ReqBin

Entra en: https://reqbin.com

Usa el método POST con la URL:

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

Sustituye:

• _phoneNumberID_ → por el phoneNumberID de tu conexión, sacado del F12

• _token_ → por el token sacado del F12 (o creando app, mira nuestro tutorial de tracking que enseña eso)

JSON para enviar

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

Imagen #3 – Insertar PhoneNumberID, Token y código del país (ej: BR)

Resultado esperado

Después de hacer clic en SEND en ReqBin:

Si aparece en verde: 200 (OK)

Esto significa que:

• La configuración se aplicó correctamente

• El número ya puede conectarse de nuevo

Ahora solo tienes que repetir el proceso de conexión en el CRM.

Si da error

Si devuelve otro error:

• Verifica si el PhoneNumberID es correcto

• Confirma si el Token es correcto

• Revisa el código del país en el formato ISO

Si es necesario:

• Busca el error que se devolvió

• O envía el contexto completo de lo que estás intentando hacer + el error que te dio al chatGPT. Es importante decir qué quieres hacer, enviar cómo lo hiciste y el error que salió.
  También tenemos la comunidad para ayudar y puedes abrir, en últimos casos, un ticket en soporte si es necesario también.