> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Incorporar la aplicación WhatsApp Business
> Desbloquee capacidades avanzadas de mensajería API sin salir de la aplicación WhatsApp Business
## Qué es la coexistencia de WhatsApp
**¡Esto significa que su WhatsApp Business API y su aplicación WhatsApp Business ahora pueden coexistir juntas!**
Incorporar un número que ya está en uso con la aplicación WhatsApp Business para el acceso a la API permite que tanto la API como la aplicación funcionen en el mismo número de teléfono. Puede utilizar funciones como mensajería a gran escala, respuestas de agentes de IA, flujos basados en reglas y Recorridos (Journeys), mientras continúa enviando mensajes desde la aplicación WhatsApp Business.
Esta función es perfecta para los equipos que buscan realizar la transición a flujos de trabajo basados en API mientras siguen utilizando su aplicación existente.
## Por qué usar la coexistencia de WhatsApp
**Escenario 1:** Si sus empleados necesitan comunicarse con los usuarios utilizando una computadora de trabajo durante el día y continuar la conversación sin problemas a través de la aplicación por la noche.
**✅ Beneficios correspondientes:** Los mensajes se reflejarán entre la aplicación móvil y la API. Es decir:
1. Los mensajes enviados a través de la API aparecerán en la aplicación WhatsApp Business.
2. Los mensajes enviados a través de la aplicación aparecerán en el historial de conversaciones de Cloud API, el cual puede consultar en computadoras.
**Escenario 2:** Si desea utilizar funciones como mensajes de marketing masivos, respuestas automáticas inteligentes con agentes de IA, interacción con clientes basada en Recorridos y otras funcionalidades avanzadas, manteniendo el acceso a través de la aplicación móvil.
**✅ Beneficios correspondientes:** La coexistencia de WhatsApp le permite utilizar todas estas funciones avanzadas de API mientras conserva la mensajería personalizada uno a uno en la aplicación.
**Escenario 3:** Si ya tiene un número activo en la aplicación WhatsApp Business y desea ahorrarse la molestia de registrar un nuevo número para la API.
**✅ Beneficios correspondientes:** Conecte sin problemas su número de la aplicación WhatsApp Business y utilice las funcionalidades de la API sin eliminar su cuenta de WhatsApp Business original.
## Información importante
#### **Rendimiento (Throughput)**
1. Para mantener la compatibilidad con la aplicación WhatsApp Business, los números de teléfono comerciales que se utilizan tanto con la aplicación WhatsApp Business como con Cloud API tienen un rendimiento fijo de 5 mps (mensajes por segundo).
#### **Requisito**
Para utilizar esta función, debe estar utilizando la versión 2.24.17 o superior de la aplicación WhatsApp Business.
#### **Precios**
Los mensajes enviados desde la aplicación WhatsApp Business siguen siendo gratuitos; los mensajes enviados desde la plataforma de socios de API se cobran según el [modelo de precios de API](https://www.ycloud.com/price) existente.
#### **Comparación de funciones tras la vinculación**
La siguiente tabla describe las funciones disponibles para los clientes empresariales que se han incorporado a Cloud API, así como cualquier cambio en la funcionalidad de la aplicación WhatsApp Business tras la incorporación. Nota: Los mensajes multimedia (como los que contienen imágenes, videos y audio) que tengan más de 14 días no se podrán sincronizar.
## Cómo funciona
Abra **Cuentas de WhatsApp**, haga clic en **Crear canal** y localice **Coexistencia de WhatsApp Business APP**.
La coexistencia con la aplicación WhatsApp Business se puede conectar de dos maneras. Elija el método que coincida con la forma en que su empresa gestiona los activos de Meta.
| Método de conexión | Cuándo usarlo | Qué necesita |
| - | - | - |
| **Conectar con Facebook** | Utilice este método cuando desee que el número de la aplicación WhatsApp Business pertenezca y sea administrado dentro de su portafolio comercial de Meta. | Una cuenta de Facebook, documentos de registro de la empresa y un sitio web comercial para la Verificación comercial. |
| **Conectar mediante código QR** | Utilice este método más rápido cuando no desee iniciar sesión con Facebook ni crear un portafolio comercial durante la incorporación. | La información de su empresa y acceso a la aplicación WhatsApp Business en el teléfono que se va a conectar. |
Ambos métodos mantienen el número de teléfono disponible en la aplicación WhatsApp Business mientras lo conectan a YCloud.
## Opción 1: Conectar con Facebook
Este método vincula el número de la aplicación WhatsApp Business a un portafolio comercial de Meta. Posteriormente, puede mantener y gestionar los activos comerciales asociados en Meta Business Portfolio.
Antes de comenzar, prepare una cuenta de Facebook, los documentos de registro de su empresa y su sitio web. Estos materiales son necesarios para la Verificación comercial.
1. Inicie sesión en su cuenta de Facebook.
2. Cree un portafolio comercial o seleccione uno existente.
3. En el paso de la cuenta de WhatsApp Business, seleccione **Conectar una aplicación WhatsApp Business**.
4. Ingrese el número de teléfono utilizado por su aplicación WhatsApp Business.
5. Cuando aparezca el código QR, abre la aplicación WhatsApp Business en el teléfono y escanéalo para autorizar la conexión.
6. En el teléfono, elige si deseas sincronizar tu historial de chat. Puedes sincronizar hasta los últimos seis meses de historial.
## Opción 2: Conectar mediante código QR
Este es el método de incorporación más rápido. No requiere iniciar sesión en Facebook ni crear un portafolio comercial durante el proceso de conexión.
1. Selecciona el método de conexión por código QR.
2. Introduce el nombre de tu empresa y la información del sitio web.
La coexistencia con la aplicación WhatsApp Business aún requiere la verificación del negocio. El **Nombre de la empresa** ingresado durante la incorporación debe coincidir exactamente con el nombre legal de la empresa en los documentos de registro que planeas enviar. Una discrepancia puede afectar la verificación del negocio más adelante.
Introduce el **Sitio web** correctamente. Si tu empresa no tiene un sitio web, selecciona **Mi empresa no tiene un sitio web ni una página de perfil** en lugar de dejar el campo incompleto.
3. Introduce el número de teléfono de la aplicación WhatsApp Business que deseas conectar.
4. Abre la aplicación WhatsApp Business en el teléfono y escanea el código QR para autorizar la conexión.
5. En el teléfono, elige si deseas sincronizar tu historial de chat. Puedes sincronizar hasta los últimos seis meses de historial.
## Sincronizar historial de chat
Una vez completada la autorización, YCloud comienza a sincronizar los chats inmediatamente si elegiste compartir tu historial de chat.
Mantén abierta la aplicación WhatsApp Business durante la sincronización. Los mensajes nuevos aparecerán en la Bandeja de entrada de YCloud solo después de que se complete la sincronización.
## Ver el video tutorial
[Ver el tutorial de coexistencia de la aplicación WhatsApp Business](https://youtu.be/gIJx2XGC3gA)
## Preguntas frecuentes
No. Puedes seguir enviando y recibiendo mensajes, así como administrando contactos en la aplicación WhatsApp Business.
No. La coexistencia de la aplicación WhatsApp Business debe conectarse a través de la plataforma de YCloud. YCloud no proporciona una API para esta operación de incorporación.
Esto suele significar que la autorización se realizó correctamente pero la vinculación final falló. Las posibles causas incluyen:
* **Conectado previamente a otra plataforma:** La cuenta aún puede estar asociada con otro proveedor. Sigue el proceso de migración de cuentas de coexistencia antes de intentar vincularla a YCloud.
* **Fallo temporal de vinculación:** Si la interfaz de vinculación estuvo temporalmente inestable, desvincula YCloud de la aplicación WhatsApp Business en el teléfono y luego inicia la conexión nuevamente.
* **Información del sitio web incompleta:** Si no se ingresó un sitio web válido ni se seleccionó **Mi empresa no tiene un sitio web ni una página de perfil** , la cuenta puede permanecer pendiente. Desvincúlala en el teléfono y repite la conexión con la información completa de la empresa.
| Error | Significado y acción recomendada |
| - | - |
| `#2655093: already shared with another partner` | La cuenta estuvo asociada previamente con otro proveedor. Pide al proveedor anterior que elimine por completo su acceso de socio y vuelve a intentarlo. No se puede garantizar una reconexión exitosa. |
| `#2655121: Restricted WhatsApp Business Account` | La cuenta está bloqueada o ha sido bloqueada previamente en la aplicación móvil y puede considerarse de alto riesgo. Usa un número diferente o espera varios días antes de intentarlo de nuevo. |
| `#3441061: phone number linked to automated events` | Desactiva los eventos automatizados indicados por Meta, espera a que los cambios de Meta se sincronicen y luego inténtalo de nuevo. |
| `Your phone number isn't eligible to connect to the WhatsApp Business platform. More activity on the WhatsApp Business app is needed to help determine eligibility.` | Meta aún no tiene suficiente actividad reciente para determinar que el número es elegible. Esto puede ocurrir cuando la cuenta es nueva, tiene pocas conversaciones recientes o no ha estado activa recientemente. Continúa usando la aplicación WhatsApp Business para mantener conversaciones auténticas y luego intenta conectarte nuevamente más tarde. |
Meta puede desvincular automáticamente la cuenta cuando la aplicación WhatsApp Business ha estado inactiva o cuando se ha iniciado sesión en la aplicación desde un dispositivo diferente. Vuelve a conectar la cuenta en YCloud.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.