Cómo conectar WhatsApp con Bluechat paso a paso (API oficial)
¿Qué necesitas antes de comenzar?
Antes de conectar tu número a Bluechat, asegúrate de tener lo siguiente:
1. Una cuenta de desarrollador en Meta (Facebook Developers)
→ Si no tienes una, créala aquí: https://developers.facebook.com
2. Un número de teléfono válido (no debe estar en uso en WhatsApp personal ni en WhatsApp Business App)
¿Qué es WhatsApp Cloud API?
WhatsApp Cloud API es la versión oficial que Meta ofrece a empresas. Te permite integrar WhatsApp directamente con
plataformas como Bluechat, sin depender de intermediarios como Twilio, 360Dialog o MessageBird.
Todo el sistema está alojado por Meta en su nube, lo que garantiza estabilidad y seguridad. Además, es gratuito en su
configuración inicial (solo pagas por el volumen de mensajes enviados o recibidos).
Paso 1: Configura tu perfil empresarial en Meta
Este perfil será la base para que WhatsApp reconozca a tu empresa como legítima. Sigue estos pasos:
1. Ingresa a https://business.facebook.com
2. En el menú superior izquierdo (donde dice “Inicio”), haz clic en “Crear portafolio empresarial”
3. Completa los datos de tu empresa: nombre, país, sitio web, rubro, etc.
4. Asegúrate de verificar tu empresa cargando los documentos legales (esto será obligatorio más adelante para el uso
completo de la API)
Una vez finalizado este proceso, tendrás acceso al panel de configuración de tu empresa en Meta.
Paso 2: Crea tu aplicación en Meta
1. Ve a https://developers.facebook.com
2. Haz clic en “Crear aplicación”
3. Completa los campos obligatorios
4. En el tipo de aplicación, selecciona “Otro”
5. Luego, elige “Empresa” como tipo de app
6. Coloca tu correo electrónico y selecciona el portafolio empresarial que creaste en el paso anterior
7. Presiona “Crear aplicación”
Paso 3: Agrega WhatsApp a tu aplicación
1. Al ingresar al panel de tu nueva app, haz clic en “Agregar producto”
2. Busca WhatsApp en la lista y presiona el botón “Configurar”
3. En ese punto, Meta te pedirá verificar tu empresa (si no lo hiciste antes). Sube los documentos requeridos y espera
la aprobación.
🔒 Nota importante: sin la verificación completa de tu empresa, no podrás generar el token de acceso definitivo.
4. Luego agrega el número de teléfono que usarás, dirígete a "Configuración de la API", luego a "Añadir numero de
teléfono".
Ingresa el nombre que se mostrará en el perfil de WhatsApp Business. Luego selecciona tu zona horaria, una categoría
y, opcionalmente, una descripción. Haz clic en Siguiente para continuar.
Agrega tu numero y haz clic en Siguiente para continuar.
Importante: Este numero no debe estar en uso en WhatsApp personal ni en WhatsApp Business App.
Meta te enviara un código mediante mensaje de texto, ingrésalo para verificar tu número.
Luego de ingresar el código, Meta inicia la validación del número y el perfil de empresa. Si todo está correcto, el
estado de la cuenta pasará a “Aprobada”. Este proceso puede tomar unos minutos o hasta algunas horas, dependiendo de
la revisión automática.
Dirígete a https://business.facebook.com/settings e ingresa a "Cuentas de WhatsApp". El estado del numero que
agregaste debería estar en "Aprobado".
Condiciones necesarias para que aparezca “Aprobada”:
El nombre comercial debe ajustarse a las políticas de WhatsApp, el número ingresado debe ser válido y no haber sido
utilizado previamente en otra cuenta de WhatsApp Business API, la empresa debe estar verificada en el Business
Manager y no deben existir conflictos de propiedad ni uso asociado al número registrado.
Paso 4: Genera el token de acceso permanente para la API de WhatsApp Cloud
Este token es necesario para que Bluechat se conecte de forma segura y continua con WhatsApp. Solo debes hacerlo una
vez.
1. Desde el panel de Meta Business, ve a Configuración del negocio** (https://business.facebook.com/settings)**
2. En el menú izquierdo, busca Usuarios del sistema (System Users)
3. Haz clic en “Agregar” y crea un nuevo usuario con el rol Administrador (Admin)
Nota: Si es tu primera vez en Usuarios del sistema, la lista estará vacía.
Luego:
1. Haz clic en “Asignar activos (Add Assets)”
2. Selecciona tu app, marca “Control total (Full control)”, Haz clic en "Asignar activos".
Después:
1. Vuelve a la lista de usuarios del sistema
2. Selecciona el usuario que creaste
3. Haz clic en “Generar nuevo token o generar identificador (Generate new token)”
4. Selecciona tu app.
Selecciona "Nunca" para evitar que caduque el identificador o token.
5. Seleccione estos tres niveles de permiso para su token:
- whatsapp_business_messaging
- whatsapp_business_management
- whatsapp_business_manage_events
Presiona “Generar identificador ”, y copia tu token.
⚠️ Guárdalo en un lugar seguro. Lo necesitarás en el siguiente paso para integrarlo con Bluechat.
Paso 5: Conecta tu cuenta de Bluechat con WhatsApp
Ahora que tienes tu número configurado, vamos a vincularlo con Bluechat.
1. Ingresa a tu cuenta Bluechat y ve a:
Configuración > Entradas > Añadir bandeja de entrada > WhatsApp
2. En el panel de aplicaciones de Meta:
- Ingresa a Configuración de la API.
- Selecciona y copia el número que agregaste.
- Copia el Identificador del número de teléfono (Phone Number ID).
- Copia el Identificador de la cuenta de WhatsApp Business (Business Account ID).
3. En Bluechat completa los campos:
- Selecciona WhatsApp Cloud.
- Agrega el nombre de la bandeja de entrada.
- Pega el numero de teléfono que copiaste con el signo "+" adelante, código de país y numero sin espacios.
- En "ID de número de teléfono" pega el "Identificador del número de teléfono (Phone Number ID)" que copiaste.
- En "ID de cuenta de negocio" pega el "Identificador de la cuenta de WhatsApp Business (Business Account ID)" que
copiaste**.**
- En "Clave de API" pega el Identificador (Token) que copiaste en el paso 4
- Click en "Crear canal de WhatsApp".
Agrega los miembros de tu equipo que atenderán esta bandeja
Bluechat te mostrará dos datos importantes:
- URL del Webhook
- Token de verificación del Webhook
Copia ambos. Los usaremos en el siguiente paso.
Paso 6: Configura el Webhook en Meta (para recibir mensajes)
Este paso permite que los mensajes que lleguen a tu número en WhatsApp se muestren en Bluechat:
1. Vuelve al panel de desarrollador de Meta (https://developers.facebook.com)
2. Selecciona tu app y ve a WhatsApp > Configuración (Configuration)
3. Busca la sección de Webhooks
4. Luego:
- Pega la "URL del webhook" que te dio Bluechat (ejemplo: https://app.bluechat.lat/webhooks/whatsapp/519XXXXXXXX)
en "URL de devolución de llamada".
- Pega el "Token de verificación del Webhook" que copiaste desde Bluechat en "Identificador de verificación".
- Haz clic en “Verificar y guardar (Verify and Save)”. Actualiza la pagina para ver los cambios.
Luego, en la misma pantalla, activa los permisos del Webhook para que Bluechat reciba los mensajes correctamente:
✔️ messages (Suscríbete a este evento)
Dirígete a "Configuración de la API", y haz clic en "Generar identificador (Token) de acceso".
Otorga los permisos.
Selecciona la App que creaste.
Y guardar.
¡Listo! Ya puedes comenzar a usar tu número de WhatsApp directamente desde Bluechat.
Preguntas frecuentes (FAQ)
¿Puedo conectar varios números en una sola app de Meta?
Sí, puedes agregar varios números a la misma app.
Pero Meta solo permite un Webhook por aplicación, así que:
- En Bluechat, crea una bandeja por cada número
- En Meta, configura el Webhook de uno solo de esos números (el primero)
- Los demás funcionarán sin problema si están en la misma app y portafolio
¿Qué tipo de mensajes de plantilla puedo usar?
Puedes usar cualquier plantilla aprobada por Meta (mensajes estructurados que inician conversaciones fuera de la ventana
de 24 h).
En Bluechat podrás seleccionarlas al iniciar una nueva conversación.
Si necesitas ayuda para crear plantillas, consúltanos por soporte.
¿Qué tipos de archivos/media se pueden enviar?
Bluechat soporta los formatos permitidos por la API oficial de WhatsApp:
- Texto
- Imágenes
- Documentos (PDF, Word, Excel)
- Videos
- Audio
- Stickers.
