Guías · Referencia rápida
Fichas por canal · Referencia rápida
Una tarjeta por canal: qué necesitas, cómo se identifica, y el paso que más falla · consulta de 1 minuto
Cómo usar esto: cada ficha es un resumen de bolsillo para elegir y conectar un canal. Para el paso a paso completo, ve a la guía del canal correspondiente. Todos los canales de Meta se conectan con el mismo flujo de 2 pasos del panel (ver la adenda de conexión en 2 pasos).
Índice de fichas
Ficha 1 · WhatsApp (modo QR)
| Para quién | Quien quiere conservar su número y su app de WhatsApp en el teléfono. |
|---|---|
| Cómo se conecta | Escaneas un código QR desde el panel (como Dispositivos Vinculados). |
| Mínimo | Tu teléfono con WhatsApp. |
| Qué necesitas | Tu teléfono con WhatsApp, 2 minutos. Sin App de Meta. |
| Identidad técnica | canal whatsapp (sin identidad Meta). |
| Ventaja | Rapidísimo, conservas la app del teléfono. |
| Riesgo | Es una vía no oficial: Meta puede desconectar/bloquear el número. No uses un número crítico de negocio como único canal. |
| Trampa #1 | Un número, una vía. El mismo número no puede estar en QR y en Cloud a la vez, ni escaneado en dos sesiones (se expulsan y arriesgas bloqueo). |
Captura próximamenteFOTO/CLIP 1 — panel mostrando el QR de WhatsApp listo para escanear.
Ficha 2 · WhatsApp Cloud API (oficial, BYOC)
| Para quién | Quien quiere la vía oficial y estable de Meta y puede dedicar un número. |
|---|---|
| Cómo se conecta | App de Meta → producto WhatsApp → credenciales → webhook 2 pasos. |
| Mínimo | App de Meta + un número dedicado (no activo en la app normal). |
| Qué necesitas | App de Meta, WABA, un número dedicado (no activo en la app normal), App Secret (32 hex), Access Token. |
| Identidad técnica | canal meta, meta_object_type = whatsapp, meta_object_id = Phone Number ID. |
| Ventaja | Máxima estabilidad, plantillas oficiales, sin riesgo de baneo. |
| Riesgo | El número queda dedicado a la API (no lo usas en el teléfono). Requiere verificación del negocio para producción. |
| Trampa #1 | El token de API Setup expira en 24 h → usa un token permanente de System User para producción. |
| Guía completa | WhatsApp Cloud API — Capítulo 1 (en preparación) |
Captura próximamenteFOTO/CLIP 2 — pantalla API Setup con Phone Number ID y WABA ID.
Ficha 3 · Facebook Messenger (Página)
| Para quién | Negocios que reciben mensajes en su Página de Facebook. |
|---|---|
| Cómo se conecta | App de Meta → Messenger → credenciales → webhook 2 pasos. |
| Mínimo | Una Página de Facebook que administres con acceso completo. |
| Qué necesitas | Página de Facebook (tú administrador con acceso completo), App Secret (32 hex), Page Access Token, Page ID. |
| Identidad técnica | canal meta, meta_object_type = page, meta_object_id = Page ID. |
| Campo del webhook | suscribe messages en el objeto Page. |
| Trampa #1 | Al Connect de la Página, permite popups y da Full access; si tu Página no aparece, agrégate en Business Settings → Pages → People. |
| Guía completa | Guía A — Crea tu App de Meta y conecta Messenger(+ adenda de conexión en 2 pasos) |
Captura próximamenteFOTO/CLIP 3 — Messenger API Settings con la Página conectada (✓).
Ficha 4 · Instagram (DMs)
| Para quién | Negocios que atienden por mensajes directos de Instagram. |
|---|---|
| Cómo se conecta | Instagram Profesional + Página vinculada → App de Meta → Instagram → webhook 2 pasos. |
| Mínimo | Instagram Profesional + Página de Facebook vinculada. |
| Qué necesitas | Instagram Profesional, Página de Facebook vinculada, App Secret (32 hex), Instagram Access Token, Instagram ID. |
| Identidad técnica | canal meta, meta_object_type = instagram, meta_object_id = Instagram ID. |
| Campo del webhook | suscribe messages en el objeto Instagram. |
| Trampa #1 | Activa Configuración → Mensajes → Herramientas conectadas → Permitir acceso a los mensajes; sin esa llave, 0 mensajes. |
| Trampa #2 | El object_id es el Instagram ID numérico, no tu @usuario. |
| Guía completa | Conecta tu Instagram al asistente |
Captura próximamenteFOTO/CLIP 4 — Instagram con "Permitir acceso a los mensajes" en verde.
Tabla comparativa (elige tu canal)
| Canal | Oficial | Conserva app del teléfono | Riesgo de bloqueo | Identidad (meta_object_type) | Dato clave (object_id) |
|---|---|---|---|---|---|
| WhatsApp QR | No | Sí | Medio-alto | — (whatsapp) | — |
| WhatsApp Cloud | Sí | No | Nulo | whatsapp | Phone Number ID |
| Messenger | Sí | N/A | Nulo | page | Page ID |
| Sí | N/A | Nulo | instagram | Instagram ID |
Lo que TODOS los canales Meta comparten
- App Secret = 32 caracteres hexadecimales exactos (0-9, a-f). Cortado o con espacios → todo falla en silencio.
- Webhook en 2 pasos: genera Callback+Verify en el panel → pega en Meta → conecta con credenciales. Genera una sola vez, no regeneres tras pegar.
- Suscribe solo el campo
messages(no las 30+ casillas del diálogo). - El primer mensaje válido activa el canal (pendiente → conectado).
- En el panel, cada canal muestra su tipo (whatsapp / page / instagram) para que sepas de un vistazo qué es cada tarjeta.
Fichas basadas en el modelo real de canales del sistema. La interfaz de Meta cambia con frecuencia: los rótulos pueden variar, pero la identidad de cada canal (tipo + id) y el flujo de 2 pasos se mantienen.