Canales: alta de WhatsApp, páginas e Instagram

Códigos de error · 21 códigos · catálogo del 2026-10-21

Alta de números de WhatsApp (Embedded Signup, PIN, coexistence) y de páginas de Facebook e Instagram desde Boost (src/channels/onboarding/). El mensaje de cada error es para la persona; nunca lleva el token ni el texto de Meta.

Para toda la familia

Lo que un código no dice lo hereda de aquí.

Cómo se detecta: Respuesta del alta (code). Cada intento queda en authz_decisions (principal channel_onboarding). Render: [channels.onboarding.boost] ….
Qué hacer: Casi siempre se repite el alta desde el principio (el code de Meta vence en 30 s y es de un solo uso). Si es de configuración (*_NOT_READY), avisa a plataforma.

21 códigos

Códigos

`CHANNEL_ONBOARDING_ACCOUNT_NOT_FOUND`

HTTPHTTP 404

La cuenta de canal no existe en la entidad o no nació en Boost.

`CHANNEL_ONBOARDING_AUDIT_UNAVAILABLE`

HTTPHTTP 503

No se pudo registrar la autorización del alta; no se hizo nada. Intentá de nuevo.

`CHANNEL_ONBOARDING_CODE_REJECTED`

HTTPHTTP 422

Meta no aceptó el code del inicio de sesión con Facebook.

Causa típica: El code vence en 30 s y es de un solo uso: el alta tardó o se repitió el mismo pedido.
Qué hacer: Repetir el alta desde «Conectar» (un code nuevo).

`CHANNEL_ONBOARDING_DISCARD_CONFIRM_REQUIRED`

HTTPHTTP 409

El número está conectado: darlo de baja corta su envío y recepción en Boost, así que exige confirmación explícita (confirm_connected).

Qué hacer: Confirmar en la pantalla de Canales (escribir los últimos 4 dígitos) solo si el número se reemplaza o deja de usarse.

`CHANNEL_ONBOARDING_DISCARD_NOT_ALLOWED`

HTTPHTTP 409

Solo se da de baja un número nacido en Boost que no esté ya dado de baja, o el número cambió mientras tanto.

`CHANNEL_ONBOARDING_META_UNAVAILABLE`

HTTPHTTP 502

Meta no respondió como se esperaba. Intentá de nuevo en unos minutos.

`CHANNEL_ONBOARDING_NOT_AVAILABLE`

HTTPHTTP 403

Esta persona no puede empezar un alta nueva de canal (número de WhatsApp o página de Facebook/Instagram): hoy solo plataforma (WhatsApp y páginas no tienen interruptor).

`CHANNEL_ONBOARDING_NOT_READY`

HTTPHTTP 503

Falta configuración o un interruptor en el servidor para el alta: no se canjeó el code. Hay que avisar a plataforma.

`CHANNEL_ONBOARDING_NUMBER_TAKEN`

HTTPHTTP 409

Ese número se acaba de conectar en otra alta. Revisá la lista de canales.

`CHANNEL_ONBOARDING_NUMBER_UNRESOLVED`

HTTPHTTP 422

La WABA no tiene el número elegido, o tiene varios y no se sabe cuál.

`CHANNEL_ONBOARDING_PAGE_TAKEN`

HTTPHTTP 409

Esa página o su Instagram se acaban de conectar en otra alta. Revisá la lista de canales.

`CHANNEL_ONBOARDING_PAGE_UNRESOLVED`

HTTPHTTP 422

Esa página no está entre las que diste acceso a Boost al iniciar sesión con Facebook.

`CHANNEL_ONBOARDING_PRINCIPAL_DENIED`

HTTPHTTP 403

El servicio de alta de canales no tiene permitida esta acción.

`CHANNEL_ONBOARDING_REGISTRATION_THROTTLED`

HTTPHTTP 429

Meta bloqueó el registro de este número por demasiados intentos. Hay que esperar a que venza el bloqueo (hasta 72 horas).

`CHANNEL_ONBOARDING_ROLLED_BACK`

HTTPHTTP 500

La transacción del alta se revirtió: nada quedó escrito en Boost. Se puede repetir.

`CHANNEL_ONBOARDING_SESSION_EXPIRED`

HTTPHTTP 410

La elección de página venció (15 minutos) o no es de esta sesión. Iniciá sesión con Facebook otra vez.

`CHANNEL_ONBOARDING_STEP_NOT_APPLICABLE`

HTTPHTTP 409

Un número coexistence ya está registrado por la app de WhatsApp Business; no se registra otra vez.

`CHANNEL_ONBOARDING_TOKEN_NOT_VERIFIED`

HTTPHTTP 422

Meta no confirmó que el acceso sea válido para la app de Boost. Iniciá sesión con Facebook otra vez.

`CHANNEL_ONBOARDING_VERIFY_IN_META`

HTTPHTTP 422

Meta no deja verificar este número con un código por la API (subcódigo 2388091/2388093: el número no se está migrando).

Qué hacer: Repetir "Agregar Línea" en Configuraciones → Canales, elegir el mismo número en el registro de Meta y completar ahí el código que mande Meta; después, Continuar registro → PIN.

`CHANNEL_ONBOARDING_WABA_UNRESOLVED`

HTTPHTTP 422

El token no da acceso a ninguna WABA, o a varias y no se sabe cuál.

`CHANNEL_ONBOARDING_WRONG_PIN`

HTTPHTTP 400

El PIN no es el de la verificación en dos pasos vigente del número (Meta #133005).

Qué hacer: Pedir el PIN correcto a quien administra el número en WhatsApp Manager. Cuidado: muchos intentos bloquean el registro 72 h (CHANNEL_ONBOARDING_REGISTRATION_THROTTLED).

Texto generado desde el catálogo de errores de BoostAPI. Para corregirlo, se cambia allá y se sincroniza: verMantener esta documentación. También enMarkdown.