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

# Conectar con WhatsApp Existente

> Conecta tu aplicación WhatsApp Business existente a Eazybe usando el modo de coexistencia - usa tanto la aplicación móvil como la Cloud API simultáneamente

La coexistencia de WhatsApp Business App permite que tu negocio use el mismo número de WhatsApp con la aplicación WhatsApp Business y la WhatsApp Cloud API simultáneamente. Esto evita la pérdida del historial de chats durante la transición a mensajería impulsada por API.

## ¿Qué es la Coexistencia?

<CardGroup cols={2}>
  <Card title="Número Unificado" icon="phone">
    Usa el mismo número de WhatsApp en ambas plataformas sin problemas
  </Card>

  <Card title="Sincronización en Tiempo Real" icon="arrows-rotate">
    Sincronización de mensajes y contactos en tiempo real entre la app y la API
  </Card>

  <Card title="Combina Flujos de Trabajo" icon="shuffle">
    Combina interacciones manuales con flujos de trabajo automatizados
  </Card>

  <Card title="Preserva Todo" icon="shield-check">
    Mantén conversaciones existentes, contactos y acceso a la interfaz móvil
  </Card>
</CardGroup>

<Info>
  Este es el método más seguro para migrar a la Cloud API sin perder ningún dato. Puedes continuar usando la aplicación WhatsApp Business normalmente después de conectar.
</Info>

## Requisitos Previos

Antes de iniciar el proceso de incorporación, asegúrate de cumplir con todos estos requisitos:

<AccordionGroup>
  <Accordion title="Versión de WhatsApp Business App" icon="mobile">
    Se requiere WhatsApp Business App **versión 2.24.17 o superior**. Las versiones anteriores fallarán durante el enlace QR.
  </Accordion>

  <Accordion title="Cuenta de Meta Business Verificada" icon="badge-check">
    Debes tener una cuenta de Meta Business verificada con la verificación comercial completada.
  </Accordion>

  <Accordion title="Número de Teléfono Elegible" icon="phone">
    Tu número debe:

    * No estar vinculado a otros proveedores de API
    * Ser un número activo de WhatsApp Business
    * No tener restricciones de Meta ni violaciones de políticas
  </Accordion>

  <Accordion title="Acceso a Eazybe Cloud API" icon="cloud">
    Se requiere acceso activo a Eazybe Cloud API con los permisos adecuados.
  </Accordion>

  <Accordion title="Requisitos Técnicos" icon="gear">
    * Endpoints de webhook configurados
    * Registro de sesión habilitado
  </Accordion>
</AccordionGroup>

## Proceso de Incorporación en 8 Pasos

<Steps>
  <Step title="Acceder a la Cuenta de Facebook Business">
    Haz clic en el botón **Conectar** para acceder a tu cuenta de Facebook Business e iniciar el flujo de registro integrado.

    <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1720506698.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=adebcd175d4caf5ca2f97fa4c8815a4a" alt="Acceder a la Cuenta de Facebook Business" width="2560" height="1422" data-path="images/1720506698.png" />
  </Step>

  <Step title="Completar Información del Negocio">
    Completa el formulario de información comercial con datos precisos en todos los campos requeridos.

    <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1710744494.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=9733dfecc15d5e2997ddcfbd65d47364" alt="Completar Información del Negocio" width="1116" height="1420" data-path="images/1710744494.png" />
  </Step>

  <Step title="Ingresar tu Número Móvil">
    Ingresa tu número móvil de WhatsApp Business existente con el código de país correcto.

    <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1710745572.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=ea5a372544e7058ca7259a6b473aa056" alt="Ingresar Número Móvil" width="1122" height="1420" data-path="images/1710745572.png" />
  </Step>

  <Step title="Escanear Código QR">
    Escanea el código QR usando tu aplicación WhatsApp Business. Hay dos opciones disponibles:

    <Tabs>
      <Tab title="Opción 1: Escaneo Directo">
        Abre la aplicación WhatsApp Business y escanea el código QR mostrado en pantalla.

        <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1713494691.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=5188266f00d2b9790fac82bc6d546e23" alt="Código QR Opción 1" width="886" height="1070" data-path="images/1713494691.png" />
      </Tab>

      <Tab title="Opción 2: Vincular Dispositivo">
        Navega a Configuración > Dispositivos vinculados > Vincular un dispositivo en tu aplicación WhatsApp Business.

        <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1713499623.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=526c35c1ea20b67c68d40f8991598740" alt="Código QR Opción 2" width="890" height="1068" data-path="images/1713499623.png" />
      </Tab>
    </Tabs>
  </Step>

  <Step title="Sincronizar Historial de Chats (Opcional)">
    Elige si deseas sincronizar tu historial de chats:

    * **Todos los contactos** se importan automáticamente
    * **Opcional:** Hasta 6 meses de historial de chats 1:1
    * **Opcional:** Hasta 2 semanas de archivos multimedia
    * **Nota:** Los chats grupales no se importan

          <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1720537088.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=5af0148e0b262da2ee4ad7eb9c4fb290" alt="Sincronizar Historial de Chats" width="1114" height="1358" data-path="images/1720537088.png" />

    <Warning>
      Mantén la aplicación WhatsApp Business ejecutándose durante la configuración para evitar pérdida de mensajes.
    </Warning>
  </Step>

  <Step title="Verificar Detalles de la Cuenta">
    Revisa y actualiza los detalles de tu cuenta de WhatsApp Business incluyendo:

    * Nombre comercial visible
    * Categoría del negocio
    * Configuración de zona horaria

          <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1720535910.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=8f5f7044c2339a4567b10e35ddd59781" alt="Verificar Detalles de la Cuenta" width="596" height="1292" data-path="images/1720535910.png" />
  </Step>

  <Step title="Revisar Permisos de Acceso">
    Revisa y confirma los permisos de acceso necesarios para que la integración funcione correctamente.

    <Tabs>
      <Tab title="iOS">
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/eazybe/images/1720564805.PNG" alt="Permisos iOS" />
      </Tab>

      <Tab title="Android">
        <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1720564008.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=501922d7898e85108f1021db2454d588" alt="Permisos Android" width="1290" height="2796" data-path="images/1720564008.png" />
      </Tab>
    </Tabs>
  </Step>

  <Step title="Completar Conexión">
    Haz clic en **Finalizar** para completar el proceso de conexión. Tu aplicación WhatsApp Business ahora está conectada a Eazybe Cloud API.

    <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1720577061.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=c7717b6cb2eff87149314bd320a5f4d2" alt="Conexión Completa" width="898" height="1058" data-path="images/1720577061.png" />
  </Step>
</Steps>

## Configuración Posterior a la Conexión

Después de completar la conexión:

<CardGroup cols={2}>
  <Card title="Sincronización de Mensajes" icon="messages">
    Los mensajes se sincronizarán en tiempo real entre la aplicación móvil y el panel de Eazybe
  </Card>

  <Card title="Importación de Contactos" icon="address-book">
    Todos los contactos se importan automáticamente a tu espacio de trabajo de Eazybe
  </Card>
</CardGroup>

<img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1720600772.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=0144f4d61cb0601dc7724cfe5a705208" alt="Panel Posterior a la Conexión" width="890" height="1412" data-path="images/1720600772.png" />

## Pasos de Verificación

Para verificar que tu conexión funciona correctamente:

<Steps>
  <Step title="Verificar Estado de Conexión">
    Navega a tu espacio de trabajo de Eazybe y verifica que el estado de conexión muestre "Conectado".

    <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1720609270.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=2c0554b3a2bf40bb14abc3dee5c17e46" alt="Estado de Conexión" width="898" height="1126" data-path="images/1720609270.png" />
  </Step>

  <Step title="Enviar Mensaje de Prueba">
    Envía un mensaje de prueba desde la aplicación móvil o el panel de Eazybe para confirmar que la sincronización funciona.

    <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1720611072.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=ae1cc0cbe83da7ac7aedcee08a32ac44" alt="Mensaje de Prueba" width="894" height="1176" data-path="images/1720611072.png" />
  </Step>

  <Step title="Verificar en la Aplicación Móvil">
    Comprueba que los mensajes enviados desde Eazybe aparezcan en tu aplicación WhatsApp Business.

    <img src="https://mintcdn.com/eazybe/497g_LQYI9iizmFL/images/1720632884.png?fit=max&auto=format&n=497g_LQYI9iizmFL&q=85&s=9d9d11010c23103b3ff75a3e7d0c106e" alt="Verificación en Aplicación Móvil" width="1918" height="908" data-path="images/1720632884.png" />
  </Step>
</Steps>

## Solución de Problemas

<AccordionGroup>
  <Accordion title="El Código QR No Escanea" icon="qrcode">
    **Causas comunes:**

    * La versión de WhatsApp Business App está desactualizada
    * Conexión a internet deficiente
    * Permiso de cámara no otorgado

    **Solución:** Actualiza tu aplicación a la versión 2.24.17 o superior y asegura una conexión a internet estable.
  </Accordion>

  <Accordion title="El Historial de Chats No Se Importó" icon="clock-rotate-left">
    Si omitiste la importación del historial inicialmente:

    1. Abre la aplicación WhatsApp Business
    2. Navega a **Configuración > Herramientas de Negocio > WhatsApp Business Platform**
    3. Toca **Desconectar** para eliminar la conexión actual
    4. Reinicia el proceso de incorporación desde el principio
  </Accordion>

  <Accordion title="Conexión Fallida" icon="triangle-exclamation">
    **Razones comunes:**

    * El número está vinculado a otro proveedor de API
    * Restricciones de Meta en la cuenta
    * Sin acceso de administrador a la página de Facebook

    **Solución:** Usa un número con uso activo de WhatsApp Business y sin violaciones de políticas.
  </Accordion>

  <Accordion title="Los Mensajes No Se Sincronizan" icon="rotate">
    * Asegúrate de que ambos dispositivos tengan conexión a internet estable
    * Verifica que la aplicación WhatsApp Business esté ejecutándose en segundo plano
    * Comprueba que los endpoints de webhook estén configurados correctamente
  </Accordion>
</AccordionGroup>

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿La coexistencia funciona con mi número existente?" icon="question">
    **Sí**, si tu número cumple con todos los requisitos previos: WhatsApp Business App versión 2.24.17+, cuenta de Meta Business verificada y sin conexiones de proveedores de API existentes.
  </Accordion>

  <Accordion title="¿Perderé mis contactos o historial de chats?" icon="question">
    **No** — la sincronización fluida ocurre durante el proceso de configuración. Todos los contactos se importan automáticamente y puedes sincronizar opcionalmente hasta 6 meses de historial de chats.
  </Accordion>

  <Accordion title="¿Puedo seguir usando la aplicación WhatsApp Business después de conectar?" icon="question">
    **Sí**, puedes continuar usando la aplicación WhatsApp Business para chats personales mientras Eazybe gestiona respuestas automatizadas y difusiones.
  </Accordion>

  <Accordion title="¿Cómo desactivo la coexistencia?" icon="question">
    Puedes desvincular la conexión a través de la configuración de tu espacio de trabajo de Eazybe. Ten en cuenta que aplica un **período de enfriamiento de 1-2 meses** si deseas reconectar el número.
  </Accordion>

  <Accordion title="¿La coexistencia tiene costos adicionales?" icon="question">
    **No**, no hay tarifas adicionales por la coexistencia en sí. Se aplican las tarifas estándar de mensajería de Meta y los cargos de suscripción de Eazybe de forma normal.
  </Accordion>
</AccordionGroup>

## ¿Necesitas Ayuda?

Si tienes alguna pregunta o necesitas más asistencia, no dudes en contactarnos en [hey@eazybe.com](mailto:hey@eazybe.com). ¡Estaremos encantados de ayudarte!