Guía · Messenger · Modelo A

Crea tu propia App de Meta y conecta Messenger

Guía completa para obtener tus credenciales · ~30 minutos · Sin experiencia previa

🧩 5 partes⚠️ 6 trampas resueltas🖥️ Navegador de computadora

Qué vas a lograr: crear tu aplicación en Meta for Developers, vincular tu Página de Facebook, y obtener los 3 valores que cualquier plataforma de mensajería necesita para conectar tu Messenger:App Secret, Page Access Token yPage ID.

Qué necesitas antes de empezar:

  • Una cuenta personal de Facebook.
  • Una Página de Facebook de tu negocio, donde tu cuenta seaadministradora con acceso completo.
  • Un navegador de computadora (no móvil) conventanas emergentes permitidas para facebook.com.
Índice de la guía

Parte 1 · Crear tu App (una sola vez)

1.1 Entra al portal de desarrolladores

Ve a https://developers.facebook.com e inicia sesión con tu cuenta de Facebook (la que administra tu Página).

Portada de developers.facebook.com con el menú My Apps señalado.
Portal de desarrolladores: entra por My Apps, arriba a la derecha.

Si es tu primera vez, Meta te pedirá registrarte como desarrollador: acepta los términos y verifica tu cuenta (email o teléfono). Es gratis y toma 2 minutos.

1.2 Crea la App

  1. Arriba a la derecha: My Apps → botón Create App.
  2. Cuando pregunte el tipo o caso de uso, elige la opción denegocio / Business (o el caso de uso "Engage with customers on Messenger" si el asistente lo ofrece directamente).
  3. Ponle un nombre reconocible (ej. "MiNegocio Engine"), tu email de contacto, y si tienes un portafolio de negocio (Business portfolio), selecciónalo.
  4. Create App → Meta puede pedirte tu contraseña para confirmar.
Pantalla Create App con el tipo Business seleccionado.
Create App: elige el tipo Business y ponle un nombre reconocible.

La app nace en modo "In development"

Verás "Unpublished". Es normal y suficiente para conectarte: en este modo todo funciona para ti y las cuentas que agregues a la app. El modo "Live" solo hace falta para atender al público general (ver Parte 5).

1.3 Añade Messenger

En el panel de tu app, busca el caso de uso"Engage with customers on Messenger" (o el productoMessenger en el menú lateral) y púlsaleSet up / Configurar. Esto habilita la sección "Messenger API Settings".

Panel de la app mostrando el caso de uso Messenger y su botón Set up.
Dashboard de la app: pulsa Set up en el caso de uso Messenger.

Parte 2 · Vincular tu Página (aquí está la trampa #1)

2.1 Conecta la Página

En Messenger API Settings, sección"2. Generate access tokens", verás "No FB pages yet" con un botónConnect. Púlsalo.

Sección '2. Generate access tokens' mostrando 'No FB pages yet' con el botón Connect.
Sección '2. Generate access tokens': aún sin páginas, pulsa Connect.

2.2 Autoriza en el popup

En la ventana de Facebook:

  1. Selecciona tu Página (solo la del negocio que conectas).
  2. En la pantalla de permisos, déjalos TODOS activados — en especial el de mensajes de la Página. Si desmarcas alguno, tu token saldrá incompleto y el bot no podrá leer o responder.
  3. Confirma (Done / Aceptar).

Cuando funcione, la sección mostrará tu Página listada con uncheck verde ✓.

La sección Generate access tokens muestra tu Página conectada con un check verde.
Página vinculada correctamente: aparece con su check verde.

Parte 3 · Obtener tus 3 credenciales

Regla de oro antes de continuar

Estos valores son secretos (los dos primeros). Guárdalos en un gestor de contraseñas o un archivo local seguro. Nunca los pegues en chats, correos, capturas de pantalla ni publicaciones. Quien tenga tu token puede leer y enviar mensajes como tu Página.

3.1 Page Access Token

En Messenger API Settings → "2. Generate access tokens", en la fila de tu Página, pulsa Generate. Se abre el modal"Token Generation":

  1. Lee el aviso ("este token se muestra UNA sola vez") y marca la casilla"I understand" — sin marcarla no puedes copiar.
  2. El token aparece parcialmente enmascarado (EAAVS•••…). Usa el botónCopy del propio modal — nunca selección manual (evita truncados).
  3. Pulsa Done. La fila ahora mostrará la etiqueta"Token generated" junto al botón Generate — esa etiqueta es tu confirmación de que existe. (El botón Generate permanece: sirve para regenerar si lo pierdes.)
Modal 'Token Generation' con el token enmascarado y el botón Copy.
Modal Token Generation: Meta ya enmascara el valor; usa su botón Copy.

3.2 App Secret

  1. Menú lateral de tu app → App settings → Basic.
  2. Junto a "App secret" (aparece como puntos ••••), pulsa Show.
  3. Meta te pedirá tu contraseña de Facebook (es normal, es una confirmación de seguridad).
  4. Copia el valor y guárdalo en tu lugar seguro.
App settings → Basic con el campo App secret y el botón Show; el secreto nunca visible.
App settings → Basic: el App Secret vive aquí, no en la pantalla de Messenger.

El App Secret está en App settings → Basic, NO en la pantalla de Messenger. Es el despiste más común: buscarlo donde generaste el token.

3.3 Page ID

El ID de tu Página no es secreto. Lo ves en la misma fila donde generaste el token (junto al nombre de la Página), o en tu Página de Facebook → Configuración → al final, "ID de la Página".

Con esto tienes los 3 valores

App Secret · Page Access Token · Page ID. Entrégalos a tu plataforma por el canal seguro que ella indique (normalmente un formulario cifrado o un comando en tu propia terminal — nunca por chat ni email).

Parte 4 · El webhook (si tu plataforma lo pide)

Algunas plataformas, tras recibir tus credenciales, te devuelven dos valores para "cerrar el circuito": una Callback URL y unVerify Token. Se pegan así:

  1. En tu app: Messenger → Webhooks (o la sección "Webhook Subscription" junto a tu página).
  2. Pega la Callback URL y el Verify Tokenexactamente como te los dio la plataforma → Verify and Save.
  3. Suscríbete a los campos correctos: botón Add Subscriptions junto a tu página.
Pantalla de Webhooks en el estado inicial, con la página aún sin suscribir.
Estado 'antes': la pantalla de Webhooks con la página todavía sin suscribir.

Cómo se ve el circuito completo y sano

Tu lista de verificación final — los cuatro indicadores en verde:

  • La sección "1. Configure webhooks" tiene check verde y la Callback URL guardada (trata esa URL como semi-secreta: no la publiques).
  • En la lista de campos, messages y messaging_postbacksaparecen con el toggle en "Subscribed".
  • La fila de tu página dice "messages and messaging_postbacks" bajo Webhook Subscription y "Token generated" en la columna Token.
  • Con esos cuatro indicadores en verde, el lado Meta está terminado.
Sección '1. Configure webhooks' con check verde y la Callback URL guardada.
Indicador 1: 'Configure webhooks' en verde, con la Callback URL guardada.
Lista de campos del webhook con messages y messaging_postbacks en 'Subscribed'.
Indicador 2: los campos messages y messaging_postbacks en 'Subscribed'.
Fila de la página mostrando 'messages and messaging_postbacks' y 'Token generated'.
Indicador 3: la fila de la página muestra los 2 campos y 'Token generated'.

Sin el campo messages suscrito, los mensajes de tus clientesnunca llegarán a la plataforma aunque todo lo demás esté bien. Es el paso que más gente olvida.

Parte 5 · Probar y salir al público

Probar en modo desarrollo (hoy mismo)

Tu app en modo "In development" ya funciona — pero solo con cuentas que tengan un rol en la app. Para probar:

  1. App roles → Roles → Add People → agrega como Testeruna segunda cuenta de Facebook (un socio, un familiar, tu cuenta alterna). Esa persona debe aceptar la invitación (le llega a facebook.com → notificaciones).
  2. Desde esa cuenta, envía un mensaje a tu Página (puedes usar el enlace directom.me/TU_PAGE_ID).
  3. Si tu plataforma responde: tu conexión está viva. 🎉
App roles → Roles con una cuenta agregada como Tester.
App roles → Roles: agrega una segunda cuenta como Tester para probar.

Salir al público (cuando estés listo)

Para que cualquier persona (sin rol en tu app) pueda escribirle a tu bot:

  1. Completa Privacy Policy URL y Terms of Service URLen App settings → Basic (deben ser páginas reales tuyas, no placeholders).
  2. Solicita el permiso pages_messaging vía App Review(Meta pide un video corto mostrando cómo funciona tu bot).
  3. Verifica tu negocio en el Business Manager si Meta lo solicita.
  4. Cambia la app a Live (interruptor "Publish" / modo).

Este proceso toma de días a algunas semanas según Meta. Mientras tanto, tu bot ya funciona con las cuentas de prueba.

El final: tu bot respondiendo

Cuando todo el circuito queda en verde, la prueba definitiva es un mensaje real. Enviamos a la página: "¿Qué planes tienen y cuánto cuestan?" — y en segundos llegó la respuesta del bot con el catálogo completo, los precios y una pregunta de seguimiento. Ese es el estándar de éxito: no un token válido ni un check verde, sinouna conversación real funcionando.

La conversación real: el mensaje del usuario y la respuesta del bot con el catálogo y los precios.
La figura final: una conversación real — el bot responde con el catálogo y los precios.

Resumen de 1 minuto

PasoDóndeResultado
Crear app Businessdevelopers.facebook.com → Create AppTu app "In development"
Añadir MessengerDashboard → caso de uso MessengerMessenger API Settings
Conectar Página"2. Generate access tokens" → ConnectPágina con ✓ (ojo: popups + Full access)
Generar tokenBotón Generate junto a tu páginaPage Access Token (verifícalo: Type=Page)
App SecretApp settings → Basic → ShowApp Secret
Page IDJunto a tu página / config. de la PáginaPage ID (no secreto)
WebhookMessenger → WebhooksCallback + Verify + campo messages
ProbarTester con rol + m.me/PAGE_IDBot respondiendo 🎉

Verificado: jul 2026, interfaz de Meta v25.0. La interfaz de Meta cambia con frecuencia: si una pantalla no coincide exactamente, busca los mismos rótulos en la sección equivalente.


Adenda a la Guía A · Conexión en 2 pasos desde el panel

Reemplaza el webhook manual por el flujo del panel · ~5 minutos · Rompe el problema del "huevo y la gallina"

Para quién es esto: ya seguiste la Guía A (o la de Instagram / WhatsApp Cloud) y tienes tus credenciales. En lugar de configurar el webhook a mano (la PARTE 4 de la Guía A), tu panel lo hace en 2 pasos. Esta adenda sustituye esa parte.

El problema que resuelve: Meta exige un webhook que ya responda para dejarte suscribir mensajes; pero tú aún no tienes el enlace hasta conectar. Es un círculo. El panel lo rompe: primero te entregael enlace (sin pedir credenciales), y después conectas.

PASO 1 · Genera tu Callback URL + Verify Token (sin credenciales todavía)

  1. Entra a tu panel → Conectar canal (o la página /connect).
  2. Elige qué vas a conectar: Messenger (Página), Instagram, o WhatsApp.
  3. Pulsa "Generar Callback URL + Verify Token".
  4. El panel te muestra dos valores. Cópialos:
    • Callback URL (un enlace largo, único para ti).
    • Verify Token (una cadena aleatoria).

No necesitas App Secret ni token todavía. Este paso solo crea tu enlace de webhook, listo para pegar en Meta.

PASO 2 · Pega el webhook en Meta y suscribe messages

  1. En tu App de Meta → sección Webhooks del producto que conectas (Messenger / Instagram / WhatsApp).
  2. Pega el Callback URL y el Verify Token exactamente como te los dio el panel (sin espacios).
  3. Verify and Save → Meta comprueba tu enlace (ahora responde ✓).
  4. En Manage / Edit subscriptions, marca solo el campo messages.

PASO 3 · Conecta con tus 3 credenciales

Vuelve al panel → misma pantalla Conectar canal → secciónConectar:

  1. App Secret — 32 caracteres hexadecimales exactos.
  2. Access Token — el token de tu Página / Instagram / WhatsApp.
  3. ID del objeto — Page ID, Instagram ID o Phone Number ID según el canal.
  4. Pulsa Conectar.

El panel valida tus credenciales contra Meta y deja el canal pendiente.

PASO 4 · El primer mensaje activa el canal

Envía un mensaje de prueba al canal (un DM, un mensaje a tu Página o a tu número Cloud). El primer mensaje válido activa el canal: pasa de pendientea conectado, y el asistente responde.

RESUMEN DE 30 SEGUNDOS

PasoAcciónDónde
1Generar Callback URL + Verify Token (sin credenciales)Panel → Conectar
2Pegar en Meta + suscribir messagesApp de Meta → Webhooks
3Conectar con App Secret + Token + IDPanel → Conectar
4Enviar 1 mensaje de pruebaEl canal → activa (pendiente→conectado)

Regla de oro

Genera el webhook una sola vez, pégalo en Meta, y no regeneres. Si algo falla, regenera y vuelve a pegar el nuevo par.

Adenda basada en el flujo real de conexión en 2 pasos del panel. Sustituye la configuración manual del webhook de la Guía A; el resto de la Guía A (crear la app, vincular la Página, obtener credenciales) sigue igual.