> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución de problemas de conexión de WhatsApp

Usa esta página cuando la conexión de un número de WhatsApp a Nexor no termine correctamente. Los síntomas a continuación están agrupados por método de conexión, además de una sección final sobre problemas de pago y facturación que bloquean el envío de plantillas.

La mayoría de los bloqueos los controla Meta, no Nexor. Nexor muestra el error, pero la solución normalmente ocurre en la configuración de tu Meta Business.

<Info>
  A lo largo de esta guía se hace referencia a dos páginas de Meta:

  * [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) — estado del número, capacidad y advertencias.
  * [WhatsApp account settings](https://business.facebook.com/latest/settings/whatsapp_account) — estado de la WABA, verificación de la empresa, facturación e indicaciones de pago.
</Info>

## Antes de volver a intentarlo

Sea cual sea el método que uses, revisa primero lo siguiente:

* Has iniciado sesión en la cuenta de Facebook correcta.
* Tienes acceso de administrador o suficiente acceso al Meta Business Portfolio correcto.
* El Business Portfolio seleccionado tiene capacidad para otro número de teléfono de WhatsApp.
* [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) no muestra problemas sin resolver de estado del número ni de capacidad.
* [WhatsApp account settings](https://business.facebook.com/latest/settings/whatsapp_account) no muestra problemas sin resolver de estado de la WABA, verificación de la empresa, facturación o indicaciones de pago.
* El perfil de tu empresa tiene información completa, incluyendo un sitio web público HTTPS si Meta lo solicita.

<Warning>
  Nunca elijas **Display name only** en el flujo de Meta para ningún método de conexión. Esa opción puede crear un número genérico y limitado administrado por Meta en lugar del número que pretendes conectar. Estos números están muy limitados y suelen dejar de enviar muy rápido, y requieren la aprobación del nombre para mostrar antes de que puedas seguir usándolos, lo que también puede tardar bastante más. Si ya completaste la configuración con **Display name only**, desconecta o elimina ese perfil antes de reiniciar.
</Warning>

## Configuración instantánea

La configuración instantánea usa el registro integrado de Meta para conectar un número de WhatsApp proporcionado por Nexor. Solo funciona cuando seleccionas un número proporcionado por Nexor dentro de Meta, listado bajo **BSP provided number**.

<AccordionGroup>
  <Accordion title="La ventana emergente de Meta no se abre">
    <Steps>
      <Step title="Usa un navegador compatible">
        Usa Chrome o Firefox.
      </Step>

      <Step title="Desactiva las extensiones de bloqueo">
        Desactiva los bloqueadores de anuncios y las extensiones de privacidad durante la sesión de configuración, y permite las ventanas emergentes y las cookies.
      </Step>

      <Step title="Inicia sesión primero">
        Inicia sesión en Facebook antes de reiniciar la configuración.
      </Step>

      <Step title="Reinicia">
        Reinicia la configuración instantánea desde Nexor.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Falta tu Business Portfolio o tu WABA">
    Esto normalmente significa que has iniciado sesión en la cuenta de Facebook equivocada, que la WABA pertenece a otro Business Portfolio o que tu usuario de Meta no tiene suficientes permisos.

    <Steps>
      <Step title="Confirma la cuenta">
        Confirma que has iniciado sesión en la cuenta de Facebook que es propietaria de la empresa o la administra.
      </Step>

      <Step title="Verifica que la WABA exista">
        Abre Meta Business Settings y verifica que la WABA exista bajo esa empresa.
      </Step>

      <Step title="Corrige el acceso">
        Pide a un administrador de la empresa en Meta que te otorgue acceso si no puedes ver la empresa o la WABA.
      </Step>

      <Step title="Reintenta">
        Reintenta la configuración instantánea después de corregir el acceso.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="El paso del perfil de la empresa se queda atascado y Next está deshabilitado">
    Meta no pudo validar los datos del perfil de tu empresa.

    <Steps>
      <Step title="Usa un sitio web real">
        Usa un sitio web público HTTPS real y confirma que cargue en un navegador en modo incógnito.
      </Step>

      <Step title="Haz coincidir tus datos">
        Asegúrate de que el nombre legal, la dirección, el sitio web y el número de teléfono coincidan con la empresa.
      </Step>

      <Step title="Reinicia la ventana emergente">
        Reinicia la ventana emergente de Meta después de actualizar la información.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Meta no muestra los números proporcionados por el BSP">
    Si Meta solo muestra **Add a new WhatsApp number** o te pide escribir un número de teléfono, no continúes en ese flujo.

    <Steps>
      <Step title="Cancela y reinicia">
        Cancela la ventana emergente de Meta y reinicia la configuración instantánea desde Nexor.
      </Step>

      <Step title="Elige la opción correcta">
        En el paso del número de teléfono, elige **Use a new or existing WhatsApp number**.
      </Step>

      <Step title="Selecciona un número proporcionado">
        Selecciona un número bajo **BSP provided number**.
      </Step>

      <Step title="Si la sección sigue faltando">
        Revisa WhatsApp Manager en busca de límites o restricciones de la cuenta.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Aparecen números proporcionados por el BSP pero la configuración sigue fallando">
    Que aparezcan números proporcionados por el BSP no siempre significa que el conjunto de números sea el problema. Meta todavía puede rechazar la configuración por el estado de la WABA, del Business Portfolio, de cumplimiento o de la capacidad del número de teléfono.

    <Steps>
      <Step title="Abre los números de teléfono">
        Abre [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) para el mismo Business Portfolio usado en la configuración.
      </Step>

      <Step title="Revisa el estado y las advertencias">
        Revisa el estado del número, la capacidad de números de teléfono y cualquier advertencia visible en la WABA seleccionada.
      </Step>

      <Step title="Resuelve y reintenta">
        Resuelve cualquier advertencia, restricción o solicitud de revisión de Meta y luego reintenta la configuración instantánea.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Meta pide verificación por SMS o por voz">
    La verificación por SMS o por voz significa que Meta te trasladó al registro manual del número, no a la configuración instantánea.

    <Steps>
      <Step title="Cancela y reinicia">
        Cancela la ventana emergente de Meta y reinicia la configuración instantánea desde Nexor.
      </Step>

      <Step title="Selecciona un número proporcionado">
        En el paso del número de teléfono, selecciona un número bajo **BSP provided number**. No escribas un número de teléfono nuevo.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="El portfolio no puede agregar otro número de teléfono">
    Meta aplica la capacidad de números de teléfono a nivel del Business Portfolio. Los portfolios nuevos normalmente comienzan con capacidad para **2 números de teléfono de WhatsApp Business registrados**. Meta puede aumentarla luego a **20** después de la verificación de la empresa o cuando el portfolio alcanza un límite de mensajería de 2.000.

    Cuando el portfolio no tiene capacidad restante, el registro integrado puede fallar sin un error claro en línea. Es posible que solo veas un indicador rojo en el paso del número de teléfono, un botón **Add phone number** deshabilitado o un texto de capacidad como `1 of 2 added`.

    <Steps>
      <Step title="Revisa todos los números">
        Abre [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) y revisa cada número en cada WABA bajo el Business Portfolio seleccionado.
      </Step>

      <Step title="Elimina los números no utilizados">
        Elimina los números no utilizados, pendientes o desactualizados si tienes acceso de administrador en Meta.
      </Step>

      <Step title="Aumenta tu límite">
        Completa la verificación de empresa de Meta (Meta Business Verification) si necesitas límites más altos de números de teléfono.
      </Step>

      <Step title="Reintenta">
        Reintenta después de que Meta muestre que hay capacidad disponible.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Meta muestra el error #2655121">
    Esto normalmente apunta a una restricción del lado de Meta en la WABA o el Business Portfolio seleccionado.

    <Steps>
      <Step title="Revisa las alertas">
        Abre [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) y revisa las alertas de la WABA, del número de teléfono o del Business Portfolio.
      </Step>

      <Step title="Revisa la configuración a nivel de cuenta">
        Si Meta apunta a la configuración a nivel de cuenta, abre [WhatsApp account settings](https://business.facebook.com/latest/settings/whatsapp_account) y revisa el estado de la WABA, la verificación de la empresa y las indicaciones de facturación o pago.
      </Step>

      <Step title="Solicita una revisión">
        Usa la opción **Request Review** de Meta si está disponible.
      </Step>

      <Step title="Reintenta">
        Reintenta la configuración instantánea solo después de que Meta levante la restricción.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Meta muestra el error 141000">
    Meta no pudo vincular el número de teléfono a la cuenta de WhatsApp seleccionada, o el número quedó pendiente o bloqueado después de la selección.

    <Steps>
      <Step title="Revisa la WABA">
        Revisa la WABA seleccionada en WhatsApp Manager y resuelve cualquier advertencia de verificación o de cuenta.
      </Step>

      <Step title="Reintenta">
        Reintenta la configuración instantánea.
      </Step>

      <Step title="Prueba con otro número">
        Si el mismo número proporcionado sigue pendiente, reinicia y elige otro número proporcionado por el BSP.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="La revisión de la WABA está pendiente y el número permanece pendiente">
    Cada WABA recién creada pasa por una revisión de Meta antes de quedar completamente incorporada. Durante este período, el número puede permanecer pendiente incluso si el Business Portfolio ya aparece como verificado.

    <Steps>
      <Step title="Confirma el estado">
        Abre [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) y confirma el estado del número.
      </Step>

      <Step title="Completa la información de la empresa">
        Asegúrate de que el Business Portfolio tenga información de empresa completa, incluyendo el nombre legal, la dirección, el número de teléfono de la empresa y un sitio web público HTTPS.
      </Step>

      <Step title="Realiza cualquier acción solicitada">
        Completa cualquier acción solicitada por Meta que sea visible si aparece alguna. Si no aparece ninguna acción, espera a que Meta termine la revisión de la WABA.
      </Step>
    </Steps>

    <Note>
      Nexor guarda el estado de la revisión de la WABA y lo muestra en el número conectado mientras está pendiente. Cuando Meta envía la actualización de la revisión, Nexor reintenta automáticamente el registro del número de teléfono. No necesitas seguir reiniciando la configuración instantánea a menos que el soporte te lo pida.
    </Note>
  </Accordion>

  <Accordion title="La WABA está bloqueada o restringida (141014, 131031)">
    Si Meta muestra errores como `141014`, `131031` o mensajes sobre una WABA bloqueada, bloqueo de cuenta, revisión de cumplimiento o revisión de la empresa, el bloqueo lo controla Meta.

    <Steps>
      <Step title="Revisa las advertencias">
        Abre [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) y revisa si hay advertencias de la WABA o del número de teléfono.
      </Step>

      <Step title="Revisa la configuración a nivel de cuenta">
        Si Meta apunta a la configuración a nivel de cuenta, abre [WhatsApp account settings](https://business.facebook.com/latest/settings/whatsapp_account) y revisa el estado de la WABA, la verificación de la empresa y las indicaciones de facturación o pago.
      </Step>

      <Step title="Remedia">
        Completa cualquier paso solicitado de verificación de empresa, revisión o remediación.
      </Step>

      <Step title="Reintenta con una WABA limpia">
        Reintenta con una WABA que no esté bloqueada.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## WhatsApp Business App (coexistencia)

La coexistencia te permite usar la **WhatsApp Business App** y Nexor al mismo tiempo. Es conveniente, pero menos estable que una conexión dedicada de Cloud API.

El flujo estándar es: en Nexor, inicia la conexión de WhatsApp (desde el canal de **WhatsApp** de un agente o desde **Integrations → WhatsApp**) → elige **WhatsApp Business App** → iniciar sesión con Facebook → escanear el código QR que muestra Meta. Si funciona, el número permanece activo en la app del teléfono y en Nexor.

<Note>
  La coexistencia solo cambia el modo de conexión. No elimina las restricciones de aprobación del nombre para mostrar, verificación de empresa, método de pago ni plantillas. Si necesitas la máxima estabilidad para producción, usa en su lugar la ruta dedicada / Cloud API.
</Note>

<AccordionGroup>
  <Accordion title="El número estaba conectado anteriormente como Cloud API o con otro proveedor">
    Esta es la causa más común de fallos, especialmente después de migraciones desde otro BSP.

    <Steps>
      <Step title="Abre la WABA antigua">
        En Meta Business Settings, abre **Accounts → WhatsApp accounts** y selecciona la cuenta de WhatsApp / WABA antigua del número.
      </Step>

      <Step title="Revisa qué conservar">
        Comprueba si esa WABA tiene otros números de producción activos, plantillas o recursos que necesites. Si los tiene, conserva, migra o vuelve a crear lo que necesites antes de continuar.
      </Step>

      <Step title="Elimina los partners">
        Abre **Partners** y elimina todos los partners listados para esa cuenta de WhatsApp.
      </Step>

      <Step title="Elimina la WABA">
        Elimina o quita la cuenta de WhatsApp del Business Portfolio.
      </Step>

      <Step title="Limpia en Nexor">
        En Nexor, quita el número en **Integrations → WhatsApp** si todavía aparece allí.
      </Step>

      <Step title="Vuelve a conectar">
        Inicia de nuevo el flujo de coexistencia de Nexor y crea o selecciona una nueva WABA en el registro integrado de Meta.
      </Step>
    </Steps>

    <Warning>
      Quitar la cuenta de WhatsApp del Business Portfolio **no** elimina la cuenta de la WhatsApp Business App en el teléfono. Puede afectar a otros números de producción, plantillas y acceso de partners dentro de la misma WABA, así que continúa solo después de haber comprobado que es seguro eliminar la WABA antigua.
    </Warning>
  </Accordion>

  <Accordion title="Tu WABA existente no aparece en el registro integrado">
    Esto normalmente significa que seleccionaste el Business Portfolio equivocado, que la WABA todavía la controla otro partner o que el número todavía está vinculado a una WABA o asignación de app antigua.

    <Steps>
      <Step title="Confirma el portfolio">
        Confirma que has iniciado sesión en el Business Portfolio correcto en Meta.
      </Step>

      <Step title="Busca en otro lugar">
        Comprueba si la WABA aparece bajo un portfolio diferente.
      </Step>

      <Step title="Revisa los partners">
        Comprueba si un partner antiguo todavía aparece en la pestaña **Partners**.
      </Step>

      <Step title="Reintenta">
        Reintenta después de los pasos de limpieza anteriores. Si usas tu propia app de desarrollador de Facebook, considera la **Configuración manual** en lugar del registro integrado.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="El flujo del QR no se muestra, o Meta te empuja a la verificación por SMS o por voz">
    Durante la incorporación, elige la ruta para conectar la **WhatsApp Business App**. Elegir la opción equivocada puede dejar el número asociado a la app equivocada o con suscripciones de webhook faltantes.

    <Steps>
      <Step title="Reinicia">
        Reinicia el flujo desde Nexor.
      </Step>

      <Step title="Elige WhatsApp Business App">
        Asegúrate de haber elegido **WhatsApp Business App** y usa la ruta de emparejamiento basada en QR.
      </Step>

      <Step title="Evita las rutas equivocadas">
        No elijas la ruta equivocada de "existing app" ni elijas **Display name only**.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Meta dice que el número no es elegible o necesita más actividad en la app">
    Meta puede bloquear el paso del número de teléfono con un mensaje que indica que el número no es elegible para conectarse a la WhatsApp Business Platform, o que se necesita más actividad en la WhatsApp Business App para determinar la elegibilidad.

    Si el número o la cuenta son nuevos, primero asegúrate de que el número esté activo en la **WhatsApp Business App** y luego reintenta el flujo de coexistencia de Nexor. Si el error sigue apareciendo, restablecer la cuenta de la WhatsApp Business App para ese número suele ser la recuperación más confiable:

    <Steps>
      <Step title="Elimina la cuenta">
        En la WhatsApp Business App, abre **Settings → Account → Delete account** y elimina la cuenta de WhatsApp Business de ese número de teléfono.
      </Step>

      <Step title="Vuelve a crearla">
        Crea de nuevo la cuenta en la WhatsApp Business App usando el mismo número de teléfono.
      </Step>

      <Step title="Reinicia en Nexor">
        Regresa a Nexor y reinicia el flujo de coexistencia de **WhatsApp Business App**.
      </Step>
    </Steps>

    <Note>
      No vincules el número manualmente a un Meta Business Portfolio antes de reintentar. Crea primero la cuenta en la WhatsApp Business App y luego deja que el flujo de Nexor maneje la conexión con Meta. Si el error persiste después de volver a crear la cuenta, prueba con un número de teléfono diferente, y ten a mano el texto exacto del error de Meta y capturas de pantalla de la ventana emergente de Meta.
    </Note>
  </Accordion>

  <Accordion title="Error 3441041 — el número no está asociado a la empresa seleccionada">
    Meta muestra este error cuando el número de teléfono no está asociado a la empresa seleccionada en el flujo. En la práctica, esto suele ocurrir cuando el número todavía está asociado a otra compañía o portfolio, cuando una relación antigua con un BSP sigue parcialmente adjunta, o cuando el número se limpió solo del lado de la app pero no del lado del portfolio o de la WABA.

    <Steps>
      <Step title="Abre la WABA">
        En Meta Business Settings, abre **Accounts → WhatsApp accounts** y selecciona la cuenta de WhatsApp / WABA asociada actualmente al número.
      </Step>

      <Step title="Revisa qué conservar">
        Comprueba si esa WABA tiene otros números de producción activos, plantillas o recursos que necesites. Si los tiene, conserva, migra o vuelve a crear primero lo que necesites.
      </Step>

      <Step title="Elimina los partners">
        Abre **Partners** y elimina todos los partners listados para esa cuenta de WhatsApp.
      </Step>

      <Step title="Elimina la WABA">
        Elimina o quita la cuenta de WhatsApp del Business Portfolio.
      </Step>

      <Step title="Limpia y vuelve a conectar">
        Quita el número en **Integrations → WhatsApp** en Nexor si todavía aparece, luego vuelve a conectar desde Nexor y crea o selecciona una nueva WABA en el registro integrado de Meta.
      </Step>
    </Steps>

    <Note>
      Si el error persiste después de una limpieza completa, reúne el `phone_number_id`, el `waba_id`, el error exacto de Meta y capturas de pantalla de las páginas de Meta relevantes.
    </Note>
  </Accordion>

  <Accordion title="Error 2655093 — la cuenta ya está compartida con otro partner">
    Meta muestra este error cuando la empresa ya está compartiendo esa WhatsApp Business Account con otro partner, y cambiar de partner no es compatible con este flujo. Normalmente Meta dice que el número todavía está compartido con un partner o que debe desconectarse primero, incluso cuando crees que el proveedor anterior ya está desconectado.

    <Steps>
      <Step title="Vuelve a revisar la app">
        Vuelve a revisar la WhatsApp Business App en busca de conexiones con la business platform.
      </Step>

      <Step title="Vuelve a revisar los partners">
        Vuelve a revisar la pestaña **Partners** en WhatsApp Manager.
      </Step>

      <Step title="Vuelve a revisar el portfolio">
        Vuelve a comprobar si la cuenta de WhatsApp todavía reside bajo un portfolio antiguo.
      </Step>

      <Step title="Cuando la limpieza no basta">
        Si todas las asociaciones visibles han desaparecido y el error persiste, es posible que Meta todavía trate el número como vinculado a un partner anterior incluso después de una limpieza visible.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

<Info>
  Comportamientos conocidos de la coexistencia que debes esperar: desconexiones ocasionales, algunos problemas de sincronización con WhatsApp Web, algunos problemas de sincronización de nombres de contactos, y que algunos primeros mensajes entrantes pueden no llegar a Nexor de inmediato. Si tu caso de uso necesita automatización, plantillas, webhooks y confiabilidad de producción estables, usa en su lugar la ruta dedicada / Cloud API.
</Info>

## Trae tu propio número

Trae tu propio número usa el registro integrado de Meta para conectar un número de teléfono que controlas como un número dedicado de Cloud API. El número no debería permanecer activo en la WhatsApp Business App después de la configuración.

Además de las [verificaciones previas compartidas](#antes-de-volver-a-intentarlo), confirma que:

* El número puede recibir SMS o llamadas de voz durante la configuración.
* El número no está ya conectado a otro proyecto de Nexor.
* El número no sigue adjunto a otra WABA, a un proveedor anterior o a una cuenta de la WhatsApp Business App.
* La verificación en dos pasos está deshabilitada en la WABA de origen si Meta lo requiere.

<AccordionGroup>
  <Accordion title="Falta tu Business Portfolio, tu WABA o tu perfil">
    Esto normalmente significa que has iniciado sesión en la cuenta de Facebook equivocada, que la WABA pertenece a otro Business Portfolio o que tu usuario de Meta no tiene suficientes permisos.

    <Steps>
      <Step title="Confirma la cuenta">
        Confirma que has iniciado sesión en la cuenta de Facebook que es propietaria de la empresa o la administra.
      </Step>

      <Step title="Verifica la WABA">
        Abre Meta Business Settings y verifica que la WABA exista bajo esa empresa.
      </Step>

      <Step title="Corrige el acceso">
        Pide a un administrador de la empresa en Meta que te otorgue acceso si no puedes ver la empresa o la WABA.
      </Step>

      <Step title="Crea un nuevo perfil">
        Si el portfolio y la WABA son correctos pero falta tu número, elige **Create a new WhatsApp Business profile**.
      </Step>

      <Step title="Reintenta">
        Reintenta después de corregir el acceso y la selección de recursos.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Meta solo muestra perfiles de WhatsApp Business no relacionados">
    Meta puede mostrar perfiles existentes bajo la cuenta de empresa seleccionada. Esa lista está limitada al contexto de empresa de Meta seleccionado; no es una lista de todos los números que controlas.

    <Steps>
      <Step title="No elijas un perfil no relacionado">
        Elige **Create a new WhatsApp Business profile** si Meta lo ofrece.
      </Step>

      <Step title="Verifica tu número">
        Continúa hasta la entrada del número de teléfono y verifica el número previsto.
      </Step>

      <Step title="Corrige el portfolio si es necesario">
        Si falta el Business Portfolio correcto, reinicia mientras tienes iniciada sesión en una cuenta de Facebook con acceso de administrador completo.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="El portfolio no puede agregar otro número de teléfono">
    Meta aplica la capacidad de números de teléfono a nivel del Business Portfolio. Los portfolios nuevos normalmente comienzan con capacidad para **2 números de teléfono de WhatsApp Business registrados**, que Meta puede aumentar luego a **20** después de la verificación de la empresa o cuando el portfolio alcanza un límite de mensajería de 2.000.

    Cuando el portfolio no tiene capacidad restante, el registro integrado puede fallar sin un error claro en línea. Es posible que solo veas un indicador rojo en el paso del número de teléfono, un botón **Add phone number** deshabilitado o un texto de capacidad como `1 of 2 added`.

    <Steps>
      <Step title="Revisa todos los números">
        Abre [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) y revisa cada número en cada WABA bajo el Business Portfolio seleccionado.
      </Step>

      <Step title="Elimina los números no utilizados">
        Elimina los números no utilizados, pendientes o desactualizados si tienes acceso de administrador en Meta.
      </Step>

      <Step title="Aumenta tu límite">
        Completa la verificación de empresa de Meta (Meta Business Verification) si necesitas límites más altos de números de teléfono.
      </Step>

      <Step title="Reintenta">
        Reintenta después de que Meta muestre que hay capacidad disponible.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Nexor dice que el número ya existe">
    Si Nexor dice `A WhatsApp config with the same display phone number already exists`, el número ya está conectado a otra cuenta o proyecto de Nexor.

    <Steps>
      <Step title="Desconecta primero">
        Desconecta el número de la cuenta de Nexor donde está conectado actualmente.
      </Step>

      <Step title="Ambas cuentas son tuyas">
        Si eres dueño de ambas cuentas, ten lista la prueba de que controlas el número y ambas cuentas.
      </Step>

      <Step title="Deja de reintentar">
        No sigas reintentando la misma configuración. El número no se puede conectar dos veces.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Meta dice que el número ya está vinculado en otro lugar">
    Meta puede bloquear la configuración cuando el número todavía está adjunto a otra WABA, a un proveedor anterior, a un registro de la WhatsApp Business App o a un estado de propiedad desactualizado.

    <Steps>
      <Step title="Elimina de WABAs antiguas">
        Elimina el número de las WABAs antiguas en WhatsApp Manager donde tengas acceso de administrador.
      </Step>

      <Step title="Desconecta vínculos antiguos">
        Desconecta los vínculos antiguos de la Business Platform o de partners.
      </Step>

      <Step title="Elimina de la app">
        Elimina el número de la ruta de la WhatsApp Business App si se usó allí.
      </Step>

      <Step title="Deshabilita la verificación en dos pasos">
        Deshabilita la verificación en dos pasos en la WABA de origen si Meta lo requiere.
      </Step>

      <Step title="Espera y reintenta">
        Espera unos minutos a que la limpieza de Meta se asiente, luego reintenta a través de una sola ruta.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="La verificación por SMS o por voz falla">
    La verificación por SMS o por voz es esperable en Trae tu propio número. Demuestra que controlas la línea telefónica.

    <Steps>
      <Step title="Confirma el número">
        Confirma el número de teléfono y el código de país.
      </Step>

      <Step title="Usa la voz si es necesario">
        Usa la opción de llamada de voz si el número es una línea fija o no puede recibir SMS.
      </Step>

      <Step title="Deja de reintentar">
        Deja de reintentar si el temporizador de reenvío se sigue reiniciando o si Meta sigue rechazando el código.
      </Step>

      <Step title="Espera a que pase un bucle de reinicio">
        Para casos persistentes de estado pendiente o bucles de reinicio, espera 72 horas sin intentos de verificación, registro, baja de registro, SMS ni voz.
      </Step>

      <Step title="Limpia antes de reintentar">
        Antes de reintentar, elimina los vínculos desactualizados de WABA, WhatsApp Business App y proveedor anterior donde corresponda.
      </Step>

      <Step title="Un reintento limpio">
        Después de la ventana de silencio, haz un reintento limpio a través de Nexor.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="El paso del perfil de la empresa se queda atascado y Next está deshabilitado">
    Meta no pudo validar los datos del perfil de tu empresa.

    <Steps>
      <Step title="Usa un sitio web real">
        Usa un sitio web público HTTPS real y confirma que cargue en un navegador en modo incógnito.
      </Step>

      <Step title="Haz coincidir tus datos">
        Asegúrate de que el nombre legal, la dirección, el sitio web y el número de teléfono coincidan con la empresa.
      </Step>

      <Step title="Reinicia la ventana emergente">
        Reinicia la ventana emergente de Meta después de actualizar la información.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="La revisión de la WABA bloquea el registro y el número permanece pendiente">
    Cada WABA recién creada pasa por una revisión de Meta antes de quedar completamente incorporada. Durante este período, la verificación por SMS o por voz puede tener éxito, pero el número aún puede permanecer pendiente mientras Meta termina la revisión.

    <Steps>
      <Step title="Confirma el estado">
        Abre [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) y confirma el estado del número.
      </Step>

      <Step title="Completa la información de la empresa">
        Asegúrate de que el Business Portfolio tenga información de empresa completa, incluyendo el nombre legal, la dirección, el número de teléfono de la empresa y un sitio web público HTTPS.
      </Step>

      <Step title="Realiza cualquier acción solicitada">
        Completa cualquier acción solicitada por Meta que sea visible si aparece alguna. Si no aparece ninguna acción, espera a que Meta termine la revisión.
      </Step>
    </Steps>

    <Note>
      Nexor guarda el estado de la revisión de la WABA y lo muestra en el número conectado mientras está pendiente. Cuando Meta envía la actualización de la revisión, Nexor reintenta automáticamente el registro del número de teléfono. No necesitas seguir reiniciando Trae tu propio número a menos que el soporte te lo pida.
    </Note>
  </Accordion>

  <Accordion title="Restricciones de la WABA, de la empresa o de pago bloquean la configuración">
    Meta puede bloquear la configuración o el envío posterior incluso después de que el número parezca conectado. Causas comunes: la WABA está bloqueada, restringida o en revisión de cumplimiento; el Business Portfolio está en revisión de cumplimiento; la elegibilidad de pago o la información de facturación está incompleta; el nombre para mostrar todavía está pendiente o rechazado; o aplican restricciones por país.

    <Steps>
      <Step title="Revisa las advertencias">
        Abre [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) y revisa si hay advertencias de la WABA o del número de teléfono.
      </Step>

      <Step title="Revisa la configuración a nivel de cuenta">
        Si Meta apunta a la configuración a nivel de cuenta, abre [WhatsApp account settings](https://business.facebook.com/latest/settings/whatsapp_account) y revisa el estado de la WABA, la verificación de la empresa y las indicaciones de facturación o pago.
      </Step>

      <Step title="Completa lo que Meta pide">
        Completa cualquier verificación de empresa, revisión o información de facturación solicitada.
      </Step>

      <Step title="Reintenta y prueba">
        Reintenta solo después de que Meta levante la restricción, luego envía un mensaje de prueba en producción antes de considerar el número como completamente listo.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Meta tiene éxito pero Nexor permanece pendiente">
    Meta puede mostrar éxito mientras Nexor todavía no puede terminar de crear el número conectado.

    <Steps>
      <Step title="Confirma el éxito de Meta">
        Confirma que Meta mostró éxito.
      </Step>

      <Step title="Revisa Nexor">
        Confirma si Nexor todavía muestra la configuración como pendiente o fallida.
      </Step>

      <Step title="Reintenta de forma limpia">
        Reintenta una vez en una sesión de navegador limpia si no se creó ningún número.
      </Step>

      <Step title="Si el error persiste">
        Si Meta reporta éxito pero Nexor todavía no puede crear el número, espera unos minutos y reintenta.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Método de pago

Las plantillas de WhatsApp pueden fallar incluso cuando la plantilla en sí está aprobada. Si Meta no puede facturar a la WhatsApp Business Account (WABA), bloquea los mensajes de plantilla salientes hasta que el pago y la configuración de la empresa estén completos. Nexor muestra el error, pero la solución ocurre en la configuración de Meta Business.

### Mensajes de error comunes

Es posible que veas uno de estos en las comprobaciones de estado de Nexor, en las difusiones, en los flujos de trabajo o en las respuestas de la API:

| Mensaje                                                                                     |
| ------------------------------------------------------------------------------------------- |
| `There is an issue with the payment method`                                                 |
| `Meta blocked this template because your WhatsApp Business account is not payment eligible` |
| `Payment method required`                                                                   |
| `WhatsApp Business Account is not eligible to send template messages`                       |

### Por qué ocurre esto

Los mensajes de plantilla los factura Meta. Los envíos normalmente se rechazan por una de estas razones:

* No hay un método de pago activo en la cuenta de la WABA.
* Un método de pago que no superó la verificación.
* Faltan datos de la empresa en el Billing Hub.
* Falta información fiscal cuando Meta la requiere.
* El estado de la cuenta de WhatsApp todavía está en revisión o restringido.

### Cómo solucionarlo

<Steps>
  <Step title="Agrega o confirma un método de pago">
    Abre [Billing Hub account details](https://business.facebook.com/latest/billing_hub/accounts/details), selecciona la cuenta conectada a Nexor y agrega o confirma un método de pago activo. Resuelve cualquier indicación de pago fallido, verificación o facturación que muestre Meta.
  </Step>

  <Step title="Completa la información de la empresa">
    Abre Business info en la configuración de Meta Business y completa el nombre legal de la empresa, la dirección, el número de teléfono, el sitio web, la moneda y cualquier información fiscal requerida. Guarda los cambios y regresa al Billing Hub para confirmar que no queden indicaciones pendientes.
  </Step>

  <Step title="Confirma que el estado de la cuenta esté aprobado">
    Abre [WhatsApp account settings](https://business.facebook.com/latest/settings/whatsapp_account) y confirma que el estado de la WABA sea **Approved**. No debería estar en revisión, restringido, deshabilitado ni a la espera de una acción solicitada por Meta.
  </Step>

  <Step title="Espera y reintenta">
    Espera de 5 a 10 minutos, luego reintenta enviar la misma plantilla.
  </Step>
</Steps>

## ¿Sigues atascado?

Si has seguido los pasos anteriores y la conexión sigue fallando, reúne lo siguiente antes de reintentar o escalar:

* La URL de tu proyecto de Nexor.
* El número de teléfono que intentas conectar.
* El Business Portfolio y la WABA que seleccionaste.
* El texto exacto del error de Meta (y `phone_number_id` / `waba_id` si los tienes).
* Capturas de pantalla de la ventana emergente de Meta.
* Capturas de pantalla de WhatsApp account settings o WhatsApp phone numbers si muestran advertencias.

<Note>
  Esta guía está adaptada de la [documentación de Kapso](https://docs.kapso.ai/docs/how-to/whatsapp). Nexor usa Kapso como su proveedor de infraestructura de WhatsApp — créditos y agradecimientos al equipo de Kapso.
</Note>