Cómo conectar WhatsApp API
¿Qué vas a lograr en esta lección?
Conectar tu número de WhatsApp Business a PowerLeads usando la API oficial de Meta para poder gestionar conversaciones con tu equipo, enviar plantillas aprobadas, automatizar mensajes y usar el agente de IA con WhatsApp como canal principal.
Antes de empezar
Debes tener una cuenta de Facebook Business Manager activa
Ten a la mano el usuario y contraseña del Facebook vinculado a tu negocio
Acepta todos los permisos que solicita el sistema durante el proceso, si rechazas alguno tendrás que repetirlo
Ve a: Configuración → WhatsApp
Los tres métodos de conexión
Método 1 — Conectar tu WhatsApp Business App existente (el más común)
Este es el escenario más frecuente: ya tienes un número de WhatsApp activo en tu celular y quieres conectarlo a PowerLeads sin dejar de usarlo en el teléfono.
Con esta opción activas la coexistencia, el sistema y tu app de WhatsApp Business funcionan en paralelo. Sigues recibiendo y enviando mensajes desde el celular, y al mismo tiempo todo queda registrado y gestionado en PowerLeads.
Requisitos previos:
Tener la app de WhatsApp Business instalada y actualizada a la versión más reciente
El número debe estar activo en la app de WhatsApp Business — no en WhatsApp personal
Paso a paso:
1. Ve a Configuración → WhatsApp → Registrarse con Facebook
2. Haz clic en Continuar con tu cuenta de Facebook e inicia sesión
3. Haz clic en Comenzar para iniciar el proceso
4. Completa la información de tu negocio y haz clic en Siguiente
5. Selecciona la opción Conectar tu WhatsApp Business App existente
6. Ingresa el número de WhatsApp que quieres conectar
7. Verifica los datos de tu cuenta y confirma
8. Importa tus contactos e historial de chats
El sistema puede importar hasta 6 meses de historial de conversaciones
Espera un mensaje de la cuenta oficial de Facebook en tu app de WhatsApp Business
Escanea el código QR que te envían para autorizar la conexión
9. Haz clic en Finalizar — tu número ya está conectado
⚠️ Con la coexistencia no puedes enviar plantillas aprobadas desde la app del celular — las plantillas solo se envían desde PowerLeads.
Método 2 — Conectar un número nuevo
Usa este método si vas a registrar un número de teléfono que todavía no tiene WhatsApp — ya sea una línea nueva o una que nunca usaste en WhatsApp.
Requisitos previos:
El número no debe estar activo en WhatsApp ni WhatsApp Business — si ya lo está, usa el Método 1
Tener acceso al número para recibir el código de verificación por SMS o llamada
Paso a paso:
1. Ve a Configuración → WhatsApp → Configurar un nuevo número de WhatsApp
2. Haz clic en Continuar con tu cuenta de Facebook e inicia sesión
3. Haz clic en Comenzar
4. Completa la información de tu negocio y haz clic en Siguiente
5. Selecciona Crear cuenta de WhatsApp Business
6. Haz clic en Siguiente → Guardar → Finalizar
7. Agrega tu número de teléfono y elige el método de verificación:
Método | Cómo funciona |
|---|---|
SMS | Recibes un OTP — búscalo en la pestaña de Conversaciones del sistema |
Llamada telefónica | Recibes una llamada en el número que ingresaste |
8. Ingresa el código de 6 dígitos para verificar
9. ¡Listo! Tu número nuevo ya está activo en PowerLeads
Método 3 — Migrar desde otro proveedor de WhatsApp API
Usa este método si tu número ya está conectado a otro proveedor de WhatsApp Business API (BSP) y quieres trasladarlo a PowerLeads. El número se migra manteniendo su historial y configuración.
Requisitos previos:
Tener acceso al panel del proveedor actual para iniciar la migración desde ese lado
El número debe estar verificado en Meta Business Manager
Paso a paso:
1. Ve a Configuración → WhatsApp → Migrar desde otro proveedor
2. Haz clic en Continuar con tu cuenta de Facebook e inicia sesión
3. Selecciona la opción Migrar número existente
4. Ingresa el número que quieres migrar
5. El sistema verifica que el número está registrado en otro BSP y solicita confirmación de migración
6. Confirma desde tu cuenta de Facebook Business Manager
7. Completa la verificación del número con SMS o llamada
8. Una vez migrado, el número queda activo en PowerLeads
⚠️ La migración puede tardar hasta 24 horas en completarse. Durante ese tiempo el número puede tener interrupciones en el servicio.
Cómo funcionan las conversaciones con WhatsApp API
¿Cuándo hay costo y cuándo no?
El cliente te escribe primero → Sin costo Cuando un lead inicia la conversación se abre una ventana de 24 horas donde puedes responder libremente sin costo adicional.
Aquí es donde entra el Sistema Núcleo del Método EVIA — el agente de IA responde en segundos, califica el interés del lead y en muchos casos agenda la cita directamente en el calendario del asesor, todo dentro de esa ventana gratuita. El vendedor entra cuando la conversación ya está caliente, sin haber perdido ni un minuto de la ventana de atención.
La ventana de 24 horas se vence → Requiere plantilla aprobada Si el cliente no vuelve a escribir dentro de las 24 horas, la ventana se cierra. Para retomar la conversación debes usar una plantilla aprobada por Meta — esta sí tiene un costo por conversación.
Tú escribes primero → Requiere plantilla aprobada Por políticas de Meta, cualquier conversación que inicies tú — desde PowerLeads o desde una automatización — debe comenzar con una plantilla aprobada y tiene un costo.
Resumen de costos
Situación | ¿Tiene costo? |
|---|---|
El cliente te escribe y respondes dentro de 24h | ❌ Sin costo |
Tú inicias la conversación desde PowerLeads | ✅ Con costo — requiere plantilla |
Una automatización envía el primer mensaje | ✅ Con costo — requiere plantilla |
La ventana de 24h venció y quieres reactivar | ✅ Con costo — requiere plantilla |
Consulta los precios actualizados aquí: Ver precios de WhatsApp Business Platform
⚠️ Cosas importantes que debes saber
Con coexistencia sigues usando WhatsApp en el celular — la app y PowerLeads funcionan en paralelo sin interrupciones
Solo puedes tener 2 números por cuenta de WhatsApp Business — si necesitas más, contacta directamente a Meta
Las plantillas deben estar aprobadas por Meta antes de usarlas — el proceso puede tardar desde minutos hasta 24 horas
Con coexistencia no puedes enviar plantillas desde la app — solo desde PowerLeads
Si el cliente no responde, solo puedes escribirle usando plantillas aprobadas
Si ves el número en lugar del nombre del negocio, debes verificar tu empresa en Meta Business Manager
Errores comunes y cómo resolverlos
Problema | Solución |
|---|---|
El número ya está en WhatsApp personal | Usa el Método 1 (coexistencia) — no necesitas eliminar nada |
No llega el código OTP por SMS | Revisa la pestaña de Conversaciones del sistema — el OTP llega ahí |
Número máximo de teléfonos alcanzado | Meta permite solo 2 números por WABA — elimina uno antes de agregar otro |
El cliente ve el número en lugar del nombre | Verifica tu empresa en Meta Business Manager |
Error: WABA ya conectado a otra ubicación | Desconecta el WABA de la ubicación actual antes de vincularlo a la nueva |
La migración tarda más de 24 horas | Verifica que el número esté correctamente desvinculado del BSP anterior |
Mensaje no entregado | Verifica que el número del destinatario tenga WhatsApp activo |