# Códigos de error: Canales: alta de WhatsApp, páginas e Instagram

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

**Cómo se detecta (toda la familia):** Respuesta del alta (`code`). Cada intento queda en `authz_decisions` (principal `channel_onboarding`). Render: `[channels.onboarding.boost] …`.

**Qué hacer (toda la familia):** 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.

Lo que un código no dice lo hereda de la familia.

## `CHANNEL_ONBOARDING_ACCOUNT_NOT_FOUND`

- **Tipo:** HTTP · **HTTP:** 404 · **Estado:** vigente
- **Qué significa:** La cuenta de canal no existe en la entidad o no nació en Boost.

## `CHANNEL_ONBOARDING_AUDIT_UNAVAILABLE`

- **Tipo:** HTTP · **HTTP:** 503 · **Estado:** vigente
- **Qué significa:** No se pudo registrar la autorización del alta; no se hizo nada. Intentá de nuevo.

## `CHANNEL_ONBOARDING_CODE_REJECTED`

- **Tipo:** HTTP · **HTTP:** 422 · **Estado:** vigente
- **Qué significa:** 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`

- **Tipo:** HTTP · **HTTP:** 409 · **Estado:** vigente
- **Qué significa:** 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`

- **Tipo:** HTTP · **HTTP:** 409 · **Estado:** vigente
- **Qué significa:** 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`

- **Tipo:** HTTP · **HTTP:** 502 · **Estado:** vigente
- **Qué significa:** Meta no respondió como se esperaba. Intentá de nuevo en unos minutos.

## `CHANNEL_ONBOARDING_NOT_AVAILABLE`

- **Tipo:** HTTP · **HTTP:** 403 · **Estado:** vigente
- **Qué significa:** 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`

- **Tipo:** HTTP · **HTTP:** 503 · **Estado:** vigente
- **Qué significa:** 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`

- **Tipo:** HTTP · **HTTP:** 409 · **Estado:** vigente
- **Qué significa:** Ese número se acaba de conectar en otra alta. Revisá la lista de canales.

## `CHANNEL_ONBOARDING_NUMBER_UNRESOLVED`

- **Tipo:** HTTP · **HTTP:** 422 · **Estado:** vigente
- **Qué significa:** La WABA no tiene el número elegido, o tiene varios y no se sabe cuál.

## `CHANNEL_ONBOARDING_PAGE_TAKEN`

- **Tipo:** HTTP · **HTTP:** 409 · **Estado:** vigente
- **Qué significa:** Esa página o su Instagram se acaban de conectar en otra alta. Revisá la lista de canales.

## `CHANNEL_ONBOARDING_PAGE_UNRESOLVED`

- **Tipo:** HTTP · **HTTP:** 422 · **Estado:** vigente
- **Qué significa:** Esa página no está entre las que diste acceso a Boost al iniciar sesión con Facebook.

## `CHANNEL_ONBOARDING_PRINCIPAL_DENIED`

- **Tipo:** HTTP · **HTTP:** 403 · **Estado:** vigente
- **Qué significa:** El servicio de alta de canales no tiene permitida esta acción.

## `CHANNEL_ONBOARDING_REGISTRATION_THROTTLED`

- **Tipo:** HTTP · **HTTP:** 429 · **Estado:** vigente
- **Qué significa:** 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`

- **Tipo:** HTTP · **HTTP:** 500 · **Estado:** vigente
- **Qué significa:** La transacción del alta se revirtió: nada quedó escrito en Boost. Se puede repetir.

## `CHANNEL_ONBOARDING_SESSION_EXPIRED`

- **Tipo:** HTTP · **HTTP:** 410 · **Estado:** vigente
- **Qué significa:** 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`

- **Tipo:** HTTP · **HTTP:** 409 · **Estado:** vigente
- **Qué significa:** Un número coexistence ya está registrado por la app de WhatsApp Business; no se registra otra vez.

## `CHANNEL_ONBOARDING_TOKEN_NOT_VERIFIED`

- **Tipo:** HTTP · **HTTP:** 422 · **Estado:** vigente
- **Qué significa:** 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`

- **Tipo:** HTTP · **HTTP:** 422 · **Estado:** vigente
- **Qué significa:** 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`

- **Tipo:** HTTP · **HTTP:** 422 · **Estado:** vigente
- **Qué significa:** El token no da acceso a ninguna WABA, o a varias y no se sabe cuál.

## `CHANNEL_ONBOARDING_WRONG_PIN`

- **Tipo:** HTTP · **HTTP:** 400 · **Estado:** vigente
- **Qué significa:** 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`).
