Conectar WhatsApp Oficial (API de Meta)

El WhatsApp Oficial es el canal de Meta para empresas: entrega previsible, con sello de empresa y habilitado para campañas dentro de las reglas.

El registro se hace en el sitio de Meta y es la parte más trabajosa. Reserva de 30 a 60 minutos (algunas aprobaciones de Meta pueden tardar días). Al final tendrás 4 datos para pegar en ConectaChat.

¿Necesitas un número nuevo? No necesariamente. Desde 2026 Meta ofrece la opción “usar solo un nombre para mostrar”: crea un número virtual gratis para ti y el cliente ve solo el nombre de la empresa. Detalles en la Parte 2.

Antes de empezar

1. Una cuenta personal de Facebook (es la que administra todo en Meta).
2. Un número de teléfono exclusivo — opcional, mira la Parte 2. Si vas a usar un número tuyo, no puede estar registrado en WhatsApp común ni en Business. Si lo está, elimina la cuenta en la aplicación antes (WhatsApp → Configuración → Cuenta → Eliminar cuenta).
3. Documentos de la empresa a mano (para la verificación de negocio, que desbloquea límites mayores).

---

Parte 1 — Crear la app en Meta

1. Entra a developers.facebook.com/apps con tu cuenta de Facebook.
2. Haz clic en Crear app.
3. En “¿Qué caso de uso?”, elige Conectar con clientes por WhatsApp.
4. Ponle un nombre a la app, confirma tu correo y crea (o selecciona) un Portafolio comercial.

Parte 2 — Número e IDs

1. En el menú de la app, abre WhatsApp → Configuración de la API.
2. Meta ya crea tu cuenta de WhatsApp Business (WABA).
3. En “De”, haz clic en Agregar número de teléfono. Hay dos opciones:
   • Usar solo un nombre para mostrar — Meta crea un número virtual gratis, verificado al instante. El cliente ve el nombre de tu empresa. Limitaciones: no hace ni recibe llamadas/SMS, máximo 2 por portafolio, y el nombre pasa por aprobación.
   • Agregar un número nuevo — tu propio número, verificado por SMS o llamada.
4. Copia y guarda (están en esa misma pantalla):
   • ID del número de teléfono (Phone number ID)
   • ID de la cuenta de WhatsApp Business (WABA ID)

⚠️ Error clásico: el ID del número no es el teléfono. Es un código numérico largo, tipo 123456789012345. Ese es el que pide ConectaChat.

Parte 3 — Token permanente

El token que aparece en la pantalla de configuración expira en 24 h y no sirve. El definitivo viene de un Usuario del Sistema:

1. Entra a business.facebook.com/settings y selecciona tu portafolio.
2. Ve a Usuarios → Usuarios del sistema → Agregar.
3. Créalo con el rol Administrador (nombre sugerido: “conectachat-api”).
4. Haz clic en Agregar activos → pestaña Apps → selecciona la app de la Parte 1 → activa Administrar app.
5. Haz clic en Generar nuevo token:
   • Selecciona la app;
   • Expiración: Nunca;
   • Marca los permisos whatsapp_business_messaging, whatsapp_business_management y business_management.
6. Copia el token ahora — solo aparece una vez.

🔒 Trata el token como una contraseña. No lo mandes por WhatsApp ni por correo abierto. En ConectaChat queda guardado cifrado en una bóveda y nunca más aparece en pantalla.

Parte 4 — App Secret

Es la firma que garantiza que los mensajes recibidos vinieron realmente de Meta.

1. En el panel de la app, ve a Configuración de la app → Básico.
2. En el campo Clave secreta de la aplicación, haz clic en Mostrar, confirma tu contraseña y cópiala.

Parte 5 — Pegar en ConectaChat

1. Abre Configuración → Conexiones → Nueva conexión → WhatsApp Oficial.
2. Completa:

1. Haz clic en Conectar. ConectaChat valida al instante con Meta y muestra dos datos para la parte siguiente: la URL de callback y el token de verificación.

Parte 6 — Configurar el webhook (para recibir mensajes)

Sin este paso envías pero no recibes.

1. En el panel de la app: WhatsApp → Configuración → Webhook → Editar.
2. Pega la URL de callback y el token de verificación que mostró ConectaChat.
3. Haz clic en Verificar y guardar.
4. Todavía en la sección Webhook, haz clic en Administrar y suscribe el campo messages. Suscribe también message_template_status_update — es lo que hace que la aprobación de tus plantillas aparezca sola en la app.

La suscripción de la app a tu cuenta de WhatsApp la hace automáticamente ConectaChat al conectar. Si aparece un aviso amarillo diciendo que no fue posible, revisa que el token tenga el permiso whatsapp_business_management.

Parte 7 — Probar

1. Desde otro celular, manda un mensaje al número conectado.
2. Debe aparecer en la Bandeja de entrada en segundos, con el sello azul de canal Oficial.
3. Responde desde ConectaChat y confirma que llegó.

Verificación de negocio (recomendada)

Sin verificar la empresa en Meta, el número empieza limitado:

Los mensajes que inicia el cliente no cuentan en ese límite. Para verificar: business.facebook.com/settings → Centro de seguridad → Iniciar verificación.

Costos

ConectaChat no cobra nada por los mensajes del Oficial — Meta te cobra a ti, en la tarjeta del portafolio.

• Responder a un cliente dentro de la ventana de 24 h: gratis.
• Iniciar conversación fuera de la ventana: solo con plantilla aprobada, cobrada por mensaje. Marketing cuesta más; utilidad cuesta menos.

Problemas comunes