> For the complete documentation index, see [llms.txt](https://prometheo.gitbook.io/prometheo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prometheo.gitbook.io/prometheo/primeros-pasos/como-conectar-whatsapp.md).

# Cómo conectar WhatsApp

En Prometheo hoy existen **dos formas de conectar WhatsApp**, y es clave entender bien cuál usar según tu objetivo:

1️⃣ **Conexión por QR** (tipo WhatsApp Web)\
2️⃣ **Conexión por API oficial de Meta** (WhatsApp Business API)

Ambas se configuran desde el mismo lugar:

👉 **Conexiones → WhatsApp**

## Conexión por QR (WhatsApp Web)

#### 🔹 Qué es

Funciona igual que **WhatsApp Web**: Prometheo se vincula como un dispositivo más a tu WhatsApp o WhatsApp Business del celular.\
Todo depende de que el teléfono esté correctamente vinculado.

***

#### ✅ Qué permite

* Responder automáticamente chats **1 a 1**.
* Enviar y recibir:
  * texto
  * imágenes
  * audios (el bot responde con texto).
* Usar:
  * asistentes
  * smart tags
  * seguimientos
* Responder dentro y fuera de la **ventana de 24 hs** desde el último mensaje del cliente de forma manual.

***

#### ⚠️ Limitaciones importantes

* ❌ No responde en **grupos**.
* ❌ No sirve para campañas masivas.
* ❌ No permite usar plantillas oficiales de Meta.
* ❌ No funciona con Meta Forms / Ads.
* Puede fallar si el WhatsApp está vinculado a **demasiados dispositivos**.

#### 🛠️ Paso a paso para conectar por QR

**En el celular**

1. Abrí WhatsApp o WhatsApp Business.
2. Entrá a **Dispositivos vinculados**.

**En Prometheo**\
3\. Entrá a **Conexiones → WhatsApp**.\
4\. Hacé clic en **Conectar**.\
5\. Ingresá tu número con código de país y área (todo junto, sin símbolos).\
6\. Tocá **Generar QR** (puede tardar hasta 1 minuto).

<figure><img src="/files/FnmlLXlyCRkRvpGhtXkV" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/BEbsLSDttGMgSNUGHuMv" alt=""><figcaption></figcaption></figure>

**Vinculación**\
7\. Desde el celular, tocá *Vincular un dispositivo*.\
8\. Escaneá el QR que aparece en Prometheo.\
9\. Si todo sale bien, la línea queda conectada.

#### 🧯 Problemas típicos con QR

* El QR no aparece → esperar unos segundos y reintentar.
* Se desconecta rápido → revisar y eliminar dispositivos vinculados antiguos.
* Mensaje “esperando mensaje en WhatsApp” →
  * En WhatsApp Business:\
    **Ajustes → Cuenta → Business Platform**\
    Desconectar integraciones previas antes de usar Prometheo.

***

#### 🔌 Cómo desconectar el QR

* Desde el celular: **Dispositivos vinculados → cerrar sesión**.
* O desde Prometheo, cerrando la conexión.

***

## Conexión por API oficial de Meta (WhatsApp Business API)

#### 🔹 Qué es

Es la conexión **empresarial oficial** de WhatsApp.\
El número ya **no depende del celular**, sino que queda conectado vía Meta (Business Manager).

***

#### 🚀 Qué permite (la gran diferencia)

* Enviar mensajes **después de 24 hs** usando **plantillas aprobadas**.
* Recordatorios programados
* Hacer **campañas masivas** (plan Enterprise).
* Usar integraciones que requieren API oficial:
  * Meta Forms
  * Meta Ads
  * Google Sheets forms.
  * disparadores externos
* Mucha más **estabilidad y escalabilidad**.
* Costos gestionados desde Meta (tarjeta en el Business manager).

***

#### 🔁 Qué mantiene igual que QR

* Respuestas 1 a 1 (no grupos).
* Uso de:
  * asistentes
  * smart tags
  * seguimientos
  * variables

***

#### 📋 Requisitos obligatorios

* Portfolio comercial (Business Manager) en Meta.
* Número configurado en WhatsApp Business API.
* Medio de pago cargado en Meta.
* El número **no debe estar atado a otro proveedor**.

***

#### 🛠️ Paso a paso (resumido)

1. En Prometheo: **Conexiones → WhatsApp (B)→ Continuar**<br>

<figure><img src="/files/W1q5yR1wqW2IIiigLY2S" alt=""><figcaption></figcaption></figure>

1. Se abre Meta:
   * Iniciás sesión con un usuario **Administrador** del portfolio.
   * Elegís el negocio correcto.
   * Vinculás un número nuevo o existente.\
     ![](/files/TZ0k4aeXaz6EidBuj9UM)
2. Meta verifica el número (SMS o llamada).
3. Al finalizar, volvés a Prometheo con la línea conectada.

***

#### 🧯 Problemas frecuentes con API oficial

* No aparece el número → está vinculado a otro portfolio/proveedor.
* Portfolio en gris → tu usuario no es Administrador.
* Bloqueos o límites → se gestionan **directamente en Meta**, no desde Prometheo.

***

### 3️⃣ Cambiar entre QR y API oficial

⚠️ Importante:

* No se puede cambiar desde la interfaz.
* El cambio lo hace el **equipo técnico de Prometheo**.
* Si lo necesitás, avisás y se escala internamente.

***

### ❓ Preguntas frecuentes – WhatsApp API oficial (Meta)

#### **Completé el flujo pero el número no aparece conectado en Prometheo**

Generalmente el proceso quedó incompleto en Meta. Puede faltar:

* Confirmar el número por SMS o llamada.
* Aceptar permisos finales del negocio.\
  Conviene repetir el flujo desde Conexiones → WhatsApp y verificar cada paso.
* Recordá clickear "Finalizar" en el último paso de Meta para completar la conexión.

#### **¿Por qué con API oficial necesito plantillas y con QR no?**

Porque es una **regla de Meta**, no de Prometheo.\
Con API oficial:

* Pasadas 24 hs, solo se puede escribir usando **plantillas aprobadas**.\
  Con QR:
* Solo se responde dentro de la ventana de 24 hs, como WhatsApp normal.

#### **¿Qué pasa si mi cuenta de Meta tiene bloqueos o límites?**

Prometheo no puede intervenir en sanciones, límites o revisiones de Meta.\
Esas situaciones se gestionan directamente desde:\
business.facebook.com\
o con el soporte oficial de Meta.

#### **¿Por qué conviene usar WhatsApp API oficial en lugar de QR?**

Porque habilita cosas que el QR no permite:

* Enviar mensajes después de 24 hs.
* Usar campañas masivas.
* Integrarse con Meta Forms y Ads.
* Mayor estabilidad con alto volumen.
* Control y trazabilidad desde Meta Business.

#### **¿La API oficial es más cara que el QR?**

Depende del uso:

* Meta cobra por conversaciones.
* Para negocios con volumen, campañas o formularios, suele ser **más eficiente y escalable** que QR.\
  El QR no tiene costo directo, pero tiene muchas limitaciones operativas.

#### **¿Qué tipo de empresas deberían usar sí o sí API oficial?**

Recomendado si:

* Usás anuncios con formularios.
* Tenés equipo comercial.
* Querés campañas o reactivaciones.
* Tenés alto volumen de mensajes.
* Necesitás estabilidad y trazabilidad.

#### **¿Puedo cambiar de QR a API oficial más adelante?**

Sí, pero:

* No se hace desde la interfaz.
* Lo tiene que ajustar el equipo técnico de Prometheo.\
  Solo hay que solicitar el cambio.

## Qué revisar primero

1. Permisos de Administrador en Meta
2. Portfolio correcto y cuenta correcta
3. Que el número no esté tomado por otro proveedor
4. Estado de la línea y medio de pago

## Alcance del soporte

Prometheo puede orientarte sobre el paso a paso para conectar, qué revisar si el portfolio está gris, qué mirar si el número no aparece, cómo interpretar errores frecuentes de Meta y dónde revisar bloqueos o problemas de pago.

{% hint style="success" %}
**Sí puede ayudarte con:**

paso a paso de conexión, chequeos de permisos, revisión general de escenarios comunes y orientación sobre errores típicos de Meta.
{% endhint %}

## Gestiones que dependen de Meta

Prometheo no hace reclamos dentro de Meta, no mueve líneas entre portfolios, no libera números, no desbloquea cuentas, no apela restricciones y no gestiona cambios dentro del Business Manager.

{% hint style="warning" %}
**Importante:**

si el problema requiere intervención interna sobre tu cuenta de Meta, la gestión debe hacerse desde Meta o con soporte oficial.
{% endhint %}

## FAQ

<details>

<summary>1. ¿Por qué no veo mi número para conectar?</summary>

Suele significar que el número está vinculado a otro portfolio comercial o a otro proveedor anterior. Cuando intentás conectar desde Prometheo, Meta no te ofrece ese número o lo muestra asociado a otra cuenta.

**Solución:** revisar desde Meta dónde está asociado el número y gestionarlo para liberarlo o reasignarlo. Una vez resuelto eso, recién ahí volver a intentar la conexión desde Prometheo.

**Importante:** Prometheo no puede liberar números ni moverlos de un portfolio a otro dentro de Meta.

</details>

<details>

<summary>2. ¿Qué significa que el portfolio comercial aparezca en gris o no se pueda seleccionar?</summary>

Normalmente significa que la cuenta con la que estás iniciando sesión en Meta no tiene rol de **Administrador** en ese portfolio. No alcanza con tener acceso a la página, al WhatsApp o a la cuenta publicitaria.

**Cómo revisarlo:** entrá a la configuración del negocio, asegurate de estar en el portfolio correcto, luego andá a **Usuarios > Personas** y verificá que tu usuario figure como Administrador.

Link útil: <https://business.facebook.com/settings>

</details>

<details>

<summary>3. ¿Qué significa el error “No se puede acceder al administrador de WhatsApp con esta cuenta”?</summary>

Casi siempre es un problema de permisos dentro de Meta. La causa más habitual es que la cuenta de Facebook con la que estás intentando conectar no tenga permisos de administrador sobre el portfolio comercial donde está el WhatsApp.

**Solución:** revisar el rol dentro de Meta Business Settings y asegurarte de tener rol de Administrador.

Link útil: <https://business.facebook.com/settings>

</details>

<details>

<summary>4. ¿Qué pasa si mi número está asociado a otro portfolio o a otro proveedor?</summary>

Significa que ese número ya fue usado con otro Business Manager o con otro proveedor de WhatsApp API.

**Qué tenés que hacer:** gestionar la liberación o reasignación desde Meta o con el soporte oficial del proveedor anterior.

**Qué no se puede hacer desde Prometheo:** reclamar ni intervenir dentro de Meta para mover esa línea.

</details>

<details>

<summary>5. ¿Qué significa que Meta tire errores de revisión, bloqueo, límites o políticas durante la conexión?</summary>

Significa que hay una restricción propia de Meta, no de Prometheo. Puede tratarse de una cuenta en revisión, limitaciones de envío, bloqueos, restricciones por políticas o límites de mensajería.

**Qué hacer:** revisar directamente el estado de la línea dentro de Meta y, si hay bloqueo o restricción, gestionarlo desde ahí o con soporte oficial.

Estado de la línea: <https://business.facebook.com/latest/whatsapp_manager/phone_numbers>

</details>

<details>

<summary>6. ¿Cómo reviso si la cuenta de WhatsApp Business está bloqueada o restringida?</summary>

Si no podés operar normalmente, no podés enviar mensajes o Meta muestra avisos y limitaciones, entrá a la sección de números en WhatsApp Manager y revisá si hay bloqueos, revisiones pendientes o restricciones.

Si hay una restricción, la apelación o desbloqueo debe hacerse desde Meta.

Estado de la línea: <https://business.facebook.com/latest/whatsapp_manager/phone_numbers>

</details>

<details>

<summary>7. ¿Los problemas de facturación en Meta pueden afectar la conexión o los envíos?</summary>

Sí. Problemas con tarjeta, pagos pendientes, saldo, cobros o medios de pago suelen frenar plantillas, campañas, seguimientos y otros envíos.

**Importante:** Prometheo no administra la facturación de Meta. Si hay un problema de cobro, saldo o medio de pago, se tiene que resolver dentro de Meta.

Facturación de Meta: <https://business.facebook.com/billing_hub/accounts/details>\
Medio de pago en Whatsapp: <https://business.facebook.com/latest/settings/whatsapp_account/>

</details>

<details>

<summary>8. ¿Por qué puede pasar que las plantillas no se envíen?</summary>

Una causa muy frecuente es que la cuenta de WhatsApp Business no tenga medio de pago asociado, aunque la cuenta de Ads sí lo tenga.

**No alcanza** con que Ads esté bien: WhatsApp Business puede requerir su propio medio de pago configurado.

Configuración de cuenta de WhatsApp: <https://business.facebook.com/latest/settings/whatsapp_account/> Cuentas y facturación de WhatsApp Business: <https://business.facebook.com/latest/billing_hub/accounts>

</details>

<details>

<summary>9. ¿Qué revisar si quiero usar mensajes salientes, campañas o seguimientos y no salen?</summary>

Si ya pasaron más de 24 horas, Meta exige plantilla aprobada. Entonces hay que chequear que la plantilla exista, que esté aprobada, que la cuenta de WhatsApp tenga medio de pago y que la línea esté sana dentro de Meta.

Estado de la línea: <https://business.facebook.com/latest/whatsapp_manager/phone_numbers> Facturación: <https://business.facebook.com/latest/billing_hub/accounts> Configuración de cuenta de WhatsApp: <https://business.facebook.com/latest/settings/whatsapp_account/>

</details>

<details>

<summary>10. ¿Por qué mis clientes ven “esperando mensaje en WhatsApp” o comportamientos raros si antes usaba API oficial y ahora uso QR?</summary>

Esto pasa mucho cuando antes hubo una integración API oficial y después se usa QR, o cuando quedaron integraciones viejas activas.

**Solución recomendada:** desde la app de WhatsApp Business en el celular ir a **Ajustes > Cuenta > Business Platform** y desconectar integraciones anteriores o plataformas viejas.

</details>

<details>

<summary>11. ¿Qué significa el mensaje “Por restricciones de META, este mensaje no es compatible con API y solo puede visualizarse desde WhatsApp”?</summary>

Significa que hay tipos de mensajes que la API todavía no puede recibir. No es un problema de Prometheo, sino una limitación actual de Meta.

**Cómo mitigarlo:** en Prometheo ir a **Conexiones > WhatsApp > plantillas y configuración**, buscar “Mensaje no soportado” y configurar un mini prompt para que el asistente responda algo general cuando llegue ese tipo de mensaje.

**Recomendación:** usar una respuesta simple, sin mencionar que el mensaje fue no soportado.

</details>

<details>

<summary>12. ¿Es normal que al conectar me mande a Facebook y me pida iniciar sesión?</summary>

Sí, es normal. La conexión oficial de WhatsApp en Prometheo se hace mediante la API oficial de Meta. Por eso, al hacer click en conectar, Meta te redirige a Facebook para validar la cuenta y el portfolio.

Si ya tenías la línea asociada a un portfolio comercial, conviene iniciar sesión con esa misma cuenta. Si Meta pregunta si querés conectar una línea nueva o existente, y ya tenías el número, deberías elegir línea existente.

Paso a paso oficial de Meta: <https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users>

</details>

<details>

<summary>13. ¿Qué pasa si no puedo usar mi número porque estaba con otro proveedor?</summary>

La causa es que el número sigue atado al proveedor anterior o a otro portfolio.

**Solución:** gestionar la liberación o reasignación desde Meta o con el soporte oficial del proveedor anterior, según el caso. Desde Prometheo no se puede intervenir en eso.

</details>

<details>

<summary>14. ¿Qué pasa si el número está en WhatsApp Messenger y no en WhatsApp Business?</summary>

Eso también puede frenar el proceso. Si necesitás usar funciones comerciales, normalmente hay que migrar ese número a WhatsApp Business.

La lógica general es: hacer backup, instalar WhatsApp Business, verificar el número y completar el perfil de empresa.

</details>

<details>

<summary>15. ¿Por qué el portfolio correcto no aparece o no puedo seleccionarlo?</summary>

Casi siempre es por una de estas dos razones: no sos administrador o el WhatsApp no está dentro de ese portfolio.

**Qué revisar en Meta:** Usuarios / Personas y Cuentas / Cuentas de WhatsApp.

Configuración del negocio: <https://business.facebook.com/latest/settings/business_users>

</details>

<details>

<summary>16. ¿Por qué pueden quedar detenidas campañas o notificaciones?</summary>

Si usás campañas o notificaciones por API oficial y se frenan, una causa frecuente es que no haya medio de pago asociado a la cuenta de WhatsApp Business.

Cuentas y facturación de WhatsApp Business: <https://business.facebook.com/latest/billing_hub/accounts>

</details>

<details>

<summary>17. ¿Qué hago si el número figura conectado pero no se comporta bien?</summary>

Si en Prometheo figura conectado pero el funcionamiento es raro, conviene revisar que la cuenta en Meta esté bien, que la línea no tenga restricciones, que el número no venga arrastrando integraciones previas y que no haya conflictos entre QR y API oficial.

Si hubo usos anteriores con otras plataformas, revisar **Business Platform** en la app de WhatsApp Business suele ayudar bastante.

Estado de la línea: <https://business.facebook.com/latest/whatsapp_manager/phone_numbers>

</details>

<details>

<summary>18. ¿Qué checklist conviene revisar antes de conectar?</summary>

* Que el usuario con el que vas a iniciar sesión en Meta sea Administrador del portfolio.
* Que la cuenta de WhatsApp esté dentro de ese portfolio.
* Que el número no siga asociado a otro proveedor o portfolio.
* Que no haya bloqueos o revisiones pendientes.
* Que haya medio de pago configurado en WhatsApp Business si vas a usar plantillas, campañas o envíos salientes.
* Que no haya integraciones viejas activas en Business Platform.
* Que estés entrando con la cuenta correcta de Facebook.

</details>

<details>

<summary>19. ¿En qué orden conviene revisar si algo falla?</summary>

1. Permisos de Administrador en Meta
2. Que el portfolio sea el correcto
3. Que el número no esté tomado por otro portfolio o proveedor
4. Estado de la línea en WhatsApp Manager
5. Medio de pago en Meta
6. Integraciones viejas en Business Platform
7. Si el problema es de plantilla, revisar aprobación y facturación

</details>

## Accesos rápidos para revisar Meta

| Qué querés revisar                         | Link                                                                  |
| ------------------------------------------ | --------------------------------------------------------------------- |
| Estado de la línea                         | <https://business.facebook.com/latest/whatsapp_manager/phone_numbers> |
| Facturación de Meta                        | <https://business.facebook.com/billing_hub/accounts/details>          |
| Cuentas y facturación de WhatsApp Business | <https://business.facebook.com/latest/billing_hub/accounts>           |
| Configuración de cuenta de WhatsApp        | <https://business.facebook.com/latest/settings/whatsapp_account/>     |
| Configuración del negocio                  | <https://business.facebook.com/settings>                              |