🎯 Tutorial paso a paso para conectar tus campañas de Meta Lead Ads con tu CRM KiteProp.
Cada lead que se genere en Facebook o Instagram va a llegar automaticamente a tu bandeja de mensajes, listo para que lo contactes.

📋 Indice

  1. 🧰 Que necesitas antes de empezar
  2. 👤 Registrarte como desarrollador en Meta
  3. 📱 Crear una App de Meta
  4. 🔗 Configurar el Webhook en la App
  5. 🔑 Obtener el Page Access Token
  6. 📡 Suscribir tu pagina a eventos de leads
  7. 🔓 Habilitar acceso a leads en Meta Business
  8. 🚀 Pasar la App a modo Live
  9. ⚙️ Configurar KiteProp
  10. 📢 Crear una campaña de Lead Ads
  11. ✅ Probar que todo funcione
  12. 🔍 Que es el Graph API Explorer
  13. 🛠️ Problemas frecuentes y soluciones

🔄 Como funciona todo esto (resumen rapido)

Antes de empezar, te explicamos brevemente que es lo que estamos armando para que entiendas el panorama completo:

  1. 📝 Un potencial cliente ve tu anuncio en Facebook o Instagram y completa un formulario con sus datos (nombre, email, telefono).
  2. 📨 Facebook detecta que se completo un formulario y le avisa a KiteProp mediante un "webhook" (una notificacion automatica de servidor a servidor).
  3. 📥 KiteProp recibe esa notificacion, se conecta a Facebook para obtener los datos del lead, y lo guarda como un nuevo mensaje en tu bandeja del CRM.
  4. 🔔 Vos recibis la notificacion en KiteProp (y por email/WhatsApp si lo tenes configurado) y podes contactar al lead de inmediato.
Todo esto pasa en segundos, de forma totalmente automatica. Lo unico que necesitas hacer es la configuracion inicial que explicamos a continuacion.

🧰 Parte 0: Que necesitas antes de empezar

Antes de arrancar, asegurate de tener todo esto a mano:

  • ✅ Una cuenta personal de Facebook que sea Administrador de la Pagina de Facebook de tu inmobiliaria. Si no sabes si sos admin, anda a tu Pagina de Facebook > Configuracion > Roles de la pagina y fijate que tu cuenta aparezca como "Admin".
  • ✅ Un Meta Business Portfolio (antes se llamaba "Business Manager") vinculado a esa Pagina. Si no tenes uno, crealo gratis en 👉 https://business.facebook.com. Es basicamente el panel de control que Meta te da para administrar tus paginas y anuncios de forma profesional.
  • ✅ Tu URL de webhook de KiteProp — esta es siempre la misma para todos:
    https://www.kiteprop.com/difusions/messages/callback/meta/push
    No necesitas cambiar nada de esta URL, es fija.
  • ✅ El Verify Token de KiteProp — es un codigo secreto que KiteProp usa para validar la conexion con Facebook. Pedilo al equipo de soporte de KiteProp.
  • ✅ Una computadora con navegador de escritorio (Chrome o Firefox recomendados). ⚠️ No intentes hacer esto desde el celular, la interfaz de Meta for Developers no funciona bien en mobile.
⏱️ Tiempo estimado: 30-45 minutos la primera vez. Parece mucho, pero la mayoria de los pasos son muy simples — solo que son varios.

👤 Parte 1: Registrarte como desarrollador en Meta

Lo primero que necesitas es registrar tu cuenta de Facebook como "cuenta de desarrollador".

🤔 Que significa esto? No te preocupes — esto NO te convierte en programador ni necesitas saber programar. Simplemente es un paso que Meta te pide para darte acceso a sus herramientas de configuracion avanzadas. Es como registrarte en un sitio web: pones tus datos y listo.
Paso 1. Abri tu navegador y anda a: 👉 https://developers.facebook.com
Paso 2. Hace clic en el boton azul "Get Started" (o "Comenzar" si te aparece en español) que esta en la esquina superior derecha.
Paso 3. Inicia sesion con la misma cuenta de Facebook que es administradora de tu Pagina de Facebook de la inmobiliaria. Esto es clave — si usas otra cuenta no va a funcionar despues.
Paso 4. Te van a pedir que aceptes los Terminos de la Plataforma Meta y las Politicas para Desarrolladores. Hace clic en "Aceptar".
Paso 5. Es posible que te pidan verificar tu identidad por SMS. Si es asi, ingresa tu numero de telefono, vas a recibir un codigo por mensaje de texto, y lo escribis en la pantalla.
Paso 6. ¡Listo! 🎉 Una vez completado, vas a ser redirigido al panel de Meta for Developers. Ya sos un desarrollador registrado. ¡Facil!
⚠️ Error comun: Loguearse con una cuenta de Facebook que NO es administradora de tu pagina de negocio. Si haces esto, mas adelante no vas a poder acceder a los leads de tu pagina. Siempre usa la cuenta que es admin de la pagina.

📱 Parte 2: Crear una App de Meta

Ahora vamos a crear una "App de Meta".

🤔 Que es una App de Meta? Pensala como un "puente" entre Facebook y KiteProp. Es una configuracion que le dice a Facebook: "cuando alguien complete un formulario de lead en mis anuncios, mandalo a mi CRM". No estas construyendo ninguna app ni software — simplemente estas creando esta configuracion.
Paso 1. Anda a: 👉 https://developers.facebook.com/apps/
Paso 2. Hace clic en el boton verde "Create App" (Crear App).
Paso 3. Te van a preguntar: "What do you want your app to do?" (¿Que queres que haga tu app?). Selecciona la opcion "Other" (Otro) y hace clic en "Next" (Siguiente).
Paso 4. Te van a pedir que elijas un Tipo de App. Selecciona "Business" (Negocio) y hace clic en "Next".
Paso 5. Completa los datos de la app:
  • App name (Nombre de la app): Pone algo que te ayude a identificarla, por ejemplo: KiteProp Leads - Mi Inmobiliaria
  • App contact email (Email de contacto): Tu email de trabajo
  • Business Portfolio: ⚡ Este paso es MUY IMPORTANTE. Hace clic en el desplegable y selecciona el Meta Business Portfolio que tiene tu Pagina de Facebook. Si seleccionas el portfolio equivocado (o no seleccionas ninguno), la app no va a tener acceso a los leads de tu pagina y nada va a funcionar.
Paso 6. Hace clic en "Create App" (Crear App). Facebook puede pedirte que ingreses tu contraseña como medida de seguridad.
Paso 7. ¡Genial! 🎉 Vas a ver el dashboard (panel de control) de tu nueva app.

💾 Guarda tus credenciales de la App

Antes de seguir, vamos a guardar dos datos importantes de tu app:

  1. En el menu de la izquierda, hace clic en "Settings" (Configuracion) y luego en "Basic" (Basico).
  2. Vas a ver dos campos importantes:
    • App ID: Es un numero largo, algo como 123456789012345. Copialo.
    • App Secret: Esta oculto detras de asteriscos (••••••). Hace clic en "Show" para revelarlo, y copialo.
  3. 📌 Guarda ambos valores en un lugar seguro (un bloc de notas, un email a vos mismo, etc.). Los vas a necesitar mas adelante.
⚠️ Error comun: No seleccionar el Business Portfolio correcto. Si tu Pagina de Facebook pertenece al Business Portfolio "ABC Inmobiliaria" pero seleccionas otro portfolio, el webhook nunca va a recibir leads de esa pagina. Asegurate de elegir el correcto.

🔗 Parte 3: Configurar el Webhook en la App

Ahora vamos a configurar el "webhook" — que es basicamente decirle a Facebook a donde tiene que mandar los leads cuando alguien complete un formulario.

🤔 Que es un webhook? Es una URL (una direccion web) a la que Facebook va a enviar automaticamente la informacion de cada lead. En nuestro caso, esa URL es de KiteProp, que se va a encargar de recibir el lead y guardarlo en tu CRM.
Paso 1. En el dashboard de tu app, mira el menu de la izquierda.
Paso 2. Hace clic en "Add Product" (Agregar Producto). Tambien puede aparecer como una seccion "Add Products to Your App" en la pagina principal del dashboard.
💡 Tip: Si no encontras "Add Product", busca un boton con un "+" o scrollea hacia abajo en el menu izquierdo.
Paso 3. Vas a ver una lista de productos disponibles (son como "modulos" que podes agregarle a tu app). Busca "Webhooks" y hace clic en el boton "Set Up" (Configurar) que aparece al lado.
Paso 4. Ya estas en la pagina de configuracion de Webhooks. Arriba vas a ver un menu desplegable que probablemente diga "User" (Usuario). Hace clic en ese desplegable y cambialo a "Page" (Pagina). Esto es porque queremos recibir eventos de tu Pagina de Facebook, no de tu usuario.
Paso 5. Hace clic en el boton "Subscribe to this object" (Suscribirse a este objeto). Si ya hay una suscripcion, vas a ver "Edit subscription" — hace clic ahi.
Paso 6. Va a aparecer un cuadro de dialogo (una ventanita) pidiendo dos datos:
  • Callback URL (URL de retorno): Copia y pega exactamente esto:
    https://www.kiteprop.com/difusions/messages/callback/meta/push
  • Verify Token (Token de verificacion): Pega el verify token que te dio el equipo de soporte de KiteProp.
Paso 7. Hace clic en "Verify and Save" (Verificar y Guardar).
🔄 ¿Que pasa ahora? Facebook envia una solicitud de prueba a la URL de KiteProp para verificar que todo esta bien configurado. KiteProp recibe esa solicitud, chequea que el token coincida, y responde "todo OK". Si todo sale bien, vas a ver un ✅ mensaje de exito en pantalla.
Paso 8. Despues de la verificacion exitosa, vas a ver una lista larga de eventos. Necesitas encontrar uno que dice "leadgen" — scrollea la lista hasta encontrarlo. Cuando lo encuentres, hace clic en el boton/toggle "Subscribe" al lado para activarlo.
✅ Deberias ver "leadgen" marcado como suscrito (con un checkmark o un toggle en verde/encendido).
⚠️ Errores comunes en este paso:
  • La URL de Callback debe usar HTTPS (empieza con https://, no con http://). La URL de KiteProp ya usa HTTPS asi que no deberia haber problema.
  • Errores de tipeo en la URL. Lo mejor es copiar y pegar la URL directamente en vez de escribirla a mano. Una sola letra equivocada y la verificacion falla.
  • Verify token incorrecto. Tambien copialo y pegalo, no lo escribas a mano. Fijate que no haya espacios en blanco extra al principio o al final del token.

🔑 Parte 4: Obtener el Page Access Token

Este es el paso mas tecnico de toda la guia, pero vamos de a poco y te explicamos cada cosa.

🤔 Que es un Page Access Token? Es una "llave digital" que le permite a KiteProp conectarse a Facebook en nombre de tu pagina para obtener los datos de los leads. Sin este token, Facebook no le daria la informacion a nadie. Pensalo como la llave de una caja fuerte — KiteProp necesita esa llave para poder abrir la caja y sacar los datos del lead.

Vamos a usar una herramienta de Facebook llamada Graph API Explorer para obtener este token. Suena tecnico, pero solo vamos a clickear botones y copiar textos.

📌 Paso A: Abrir el Graph API Explorer

Paso 1. Abri una nueva pestaña del navegador y anda a: 👉 https://developers.facebook.com/tools/explorer/
Paso 2. Arriba a la derecha vas a ver un desplegable que dice "Meta App". Hace clic y selecciona la app que creaste en la Parte 2 (ej: KiteProp Leads - Mi Inmobiliaria). Esto le dice a la herramienta que trabaje con tu app.

📌 Paso B: Generar un User Access Token con permisos

Ahora vamos a generar un token temporal (despues lo convertimos en permanente, no te preocupes).

Paso 3. Hace clic en el boton "Generate Access Token" (Generar Token de Acceso). Puede estar en la parte superior de la pagina.
Paso 4. Va a aparecer una ventana con una lista larga de "permisos". Necesitas buscar y marcar/activar los siguientes. Usa la caja de busqueda para encontrarlos mas rapido:
Permiso 🤔 Para que sirve
pages_show_list Le permite a la app ver la lista de Paginas que administras
pages_read_engagement Le permite leer informacion de interaccion de tu pagina
pages_manage_metadata Le permite administrar datos de configuracion de tu pagina
pages_manage_ads Le permite gestionar los anuncios de tu pagina
leads_retrieval ⭐ ESTE ES EL MAS IMPORTANTE — Le permite obtener los datos reales de los leads
ads_management Le permite gestionar tus campañas de anuncios
ads_read Le permite leer la informacion de tus campañas
💡 Tip: Escribi el nombre del permiso en la caja de busqueda para encontrarlo rapidamente. Son 7 permisos en total.
Paso 5. Una vez que marcaste los 7 permisos, hace clic en el boton azul "Generate Access Token" abajo de la ventana.
Paso 6. Va a aparecer un dialogo de autorizacion de Facebook. Te va a pedir que confirmes a que Paginas de Facebook le das acceso. Busca y marca la casilla al lado de tu Pagina de Facebook de la inmobiliaria. Despues hace clic en "Next" o "Done".
⚠️ Muy importante: Si tenes varias paginas, asegurate de marcar la correcta. Si no marcas tu pagina aca, despues no vas a poder obtener su token.
Paso 7. De vuelta en el Graph API Explorer, vas a ver un texto largo y raro (algo como EAAGm0PX...) en el campo "Access Token". Este es tu User Access Token. Es temporal (dura 1 hora), pero lo vamos a necesitar para los siguientes pasos.

📌 Paso C: Obtener el token de tu Pagina

Ahora vamos a pedirle a Facebook que nos de la lista de paginas con sus tokens.

Paso 8. En el Graph API Explorer, vas a ver un campo de texto donde dice algo como me?fields=id,name. Borra eso y escribi:
me/accounts
🤔 Que estamos haciendo? Le estamos preguntando a Facebook: "Mostrame todas las Paginas que administro y sus tokens de acceso".
Paso 9. Hace clic en el boton azul "Submit" (Enviar) que esta a la derecha del campo.
Paso 10. Abajo, en el panel de resultados, vas a ver un bloque de texto con formato JSON. Dentro vas a encontrar una lista de tus paginas. Cada una tiene:
  • access_token: un texto largo (esto es el Page Access Token 🔑)
  • name: el nombre de tu pagina (ej: "Mi Inmobiliaria")
  • id: un numero (ej: 123456789012345 — esto es el Page ID)
Paso 11. Busca tu pagina de la inmobiliaria en la lista y copia dos cosas:
  • 📋 El valor de access_token (todo el texto largo)
  • 📋 El valor de id (el numero)
Guardalos en un lugar seguro — los vas a necesitar en los proximos pasos.
⚠️ Atencion: El Page Access Token que acabas de obtener es temporal (dura lo mismo que el User Access Token, alrededor de 1 hora). En el siguiente paso lo vamos a convertir en un token permanente que no se vence nunca.

📌 Paso D: Convertir el Token en permanente (que nunca expire)

Este paso es super importante. Si no lo haces, tu token va a expirar y los leads van a dejar de llegar.

Paso 12. Abri una nueva pestaña y anda al Access Token Debugger: 👉 https://developers.facebook.com/tools/debug/accesstoken/
Paso 13. En el campo de texto, pega el User Access Token (el del Paso 7 — es el token de usuario, NO el de la pagina) y hace clic en "Debug".
Paso 14. Te va a mostrar informacion sobre el token. Busca abajo un enlace/boton que dice "Extend Access Token" (Extender Token de Acceso). Hace clic ahi.
🤔 Que estamos haciendo? Estamos convirtiendo tu token de usuario de "corta duracion" (1 hora) a "larga duracion" (60 dias). Pero tranquilo, despues lo convertimos a uno que no vence nunca.
Paso 15. Facebook va a generar un nuevo token mas largo. Copialo — este es tu Long-Lived User Access Token (token de usuario de larga duracion).
Paso 16. Ahora volve al Graph API Explorer (https://developers.facebook.com/tools/explorer/). Pega el token de larga duracion (el que acabas de copiar en el paso anterior) en el campo Access Token de la herramienta.
Paso 17. En el campo de query (donde antes escribiste me/accounts), ahora escribi:
TU_PAGE_ID?fields=access_token
Reemplaza TU_PAGE_ID con el numero de ID de tu pagina (el que copiaste en el Paso 11). Por ejemplo, si tu Page ID es 123456789012345, escribirias: 123456789012345?fields=access_token
Paso 18. Hace clic en "Submit".
Paso 19. En los resultados vas a ver un campo access_token con un texto largo. 🎉 ¡Este es tu Page Access Token PERMANENTE! Nunca expira. Copialo y guardalo muy bien — este es el token que vas a pegar en KiteProp.
Paso 20. Para estar 100% seguro de que es permanente, anda de nuevo al Access Token Debugger, pega este nuevo token de pagina, y hace clic en "Debug". Busca el campo "Expires" (Expira) — deberia decir "Never" (Nunca). Si dice "Never", ¡todo perfecto! ✅
⚠️ Errores comunes en este paso:
  • 🔀 Confundir los tokens. Hay tres tipos: User Access Token (temporal), Long-Lived User Access Token (60 dias), y Page Access Token (permanente). El que necesitas para KiteProp es el ultimo — el de la Pagina, permanente.
  • ⏰ No extender el token. Si te salteas el paso de extension y usas el token temporal, va a expirar en 1 hora y tus leads van a dejar de llegar.
  • 📄 No seleccionar tu pagina. Si en el Paso 6 no marcaste tu pagina al autorizar los permisos, no va a aparecer en la lista del Paso 10.

📡 Parte 5: Suscribir tu pagina a eventos de leads

Ya configuraste el webhook (a donde llegan los leads) y obtuviste el token (la llave para acceder a los datos). Ahora falta un paso mas del lado de Facebook: decirle explicitamente a tu Pagina que mande los eventos de leads a tu app.

🤔 Por que hace falta este paso extra? Porque en la Parte 3 configuraste que tu app puede recibir eventos de paginas. Pero todavia no le dijiste a tu pagina especifica que le mande eventos a tu app. Es como haber conectado un telefono a la red, pero falta marcar el numero para hacer la llamada.
Paso 1. Anda al Graph API Explorer: 👉 https://developers.facebook.com/tools/explorer/
Paso 2. Asegurate de que tu app este seleccionada en el desplegable "Meta App" de arriba.
Paso 3. En el campo Access Token, pega tu Page Access Token permanente (el que obtuviste en la Parte 4, Paso 19).
Paso 4. Aca viene algo importante: cambia el metodo HTTP de GET a POST. Para hacerlo, busca el desplegable que dice "GET" (esta al lado del campo de query) y cambialo a "POST". Esto es porque ahora no estamos pidiendo informacion, sino enviando una instruccion a Facebook.
Paso 5. En el campo de query, escribi:
TU_PAGE_ID/subscribed_apps?subscribed_fields=leadgen
Reemplaza TU_PAGE_ID con tu numero de Page ID (ej: 123456789012345/subscribed_apps?subscribed_fields=leadgen).
Paso 6. Hace clic en "Submit".
Paso 7. Si todo salio bien, vas a ver esta respuesta en el panel de resultados:
{ "success": true }
🎉 ¡Excelente! Tu Pagina de Facebook ahora esta oficialmente suscrita para enviar notificaciones de leads a KiteProp.
⚠️ Errores comunes:
  • Usar un User Access Token en vez de un Page Access Token. Aca tenes que usar el token de pagina permanente.
  • Olvidar cambiar el metodo de GET a POST. Si lo dejas en GET, no va a funcionar.

🔓 Parte 6: Habilitar acceso a leads en Meta Business

Hay una capa mas de seguridad que muchos se olvidan y es una de las causas mas comunes de que los leads no lleguen. Se llama "Leads Access Manager" (Administrador de Acceso a Leads) y esta en la configuracion de tu cuenta de Meta Business.

🤔 Que es esto? Meta agrego este control extra de seguridad para que solo las apps y personas que vos autorices puedan ver los datos de tus leads. Si no le das permiso a tu app aca, Facebook simplemente no le va a mandar los leads, aunque todo lo demas este bien configurado.
Paso 1. Anda a: 👉 https://business.facebook.com/settings/leads-accesses/
Si esa URL no funciona (a veces Meta cambia las rutas), navega manualmente: anda a https://business.facebook.com > ⚙️ Configuracion > Integraciones > Acceso a Leads
Paso 2. Vas a ver una lista de tus Paginas de Facebook. Hace clic en la pagina de la que queres recibir leads.
Paso 3. Adentro vas a ver secciones para "CRMs", "Socios" y "Personas":
  • 🔹 Hace clic en "Asignar CRMs" y busca tu App de Meta (la que creaste en la Parte 2 — se va a llamar algo como "KiteProp Leads - Mi Inmobiliaria"). Seleccionala.
  • 🔹 Hace clic en "Asignar Personas" y agregarte a vos mismo (o a cualquier otra persona de tu equipo que necesite poder ver/descargar leads).
Paso 4. Hace clic en "Asignar" para confirmar.
🚨 MUY IMPORTANTE: Si te salteas este paso, podes tener TODO lo demas perfecto y aun asi NO recibir ni un solo lead. Este es literalmente el paso que mas gente se olvida. Si tus leads no llegan, lo primero que tenes que revisar es esto.

🚀 Parte 7: Pasar la App a modo Live

Tu App de Meta comienza en "Modo Desarrollo" (Development Mode), lo cual significa que tiene funcionalidad limitada. Para que los leads reales (no solo los de prueba) lleguen a KiteProp, es recomendable pasarla a Modo Live.

Paso 1. Anda al dashboard de tu app: 👉 https://developers.facebook.com/apps/ y selecciona tu app.
Paso 2. Arriba de la pagina, vas a ver un switch/toggle que dice "In Development" (En Desarrollo). Hace clic para cambiarlo a "Live".
Paso 3. Facebook puede pedirte que completes algunos requisitos antes de dejarte activar el modo Live:
  • 📄 Privacy Policy URL (Politica de Privacidad): Necesitas poner la URL de una politica de privacidad. Podes usar la de tu sitio web o la de tu KiteProp.
  • 🗑️ Data Deletion instructions (Instrucciones de eliminacion de datos): Facebook puede pedirte una URL o instrucciones de como los usuarios pueden solicitar que se borren sus datos.

📋 Sobre el App Review (Revision de App)

Para algunos permisos (particularmente leads_retrieval), Facebook puede requerir que pases por una "revision de app". Esto suena intimidante pero es bastante simple:

  • 📹 Tenes que grabar un video corto (30-60 segundos) mostrando como usas los leads. Algo como: "Cuando un cliente potencial completa nuestro formulario en Facebook, su informacion llega automaticamente a nuestro CRM KiteProp, donde nuestros agentes lo contactan para asesorarlo sobre propiedades."
  • 👤 Puede que te pidan crear una cuenta de prueba para que los revisores de Facebook verifiquen el funcionamiento.

Sin embargo, hay una buena noticia: si tu app solo la usan personas que tienen un Rol dentro de la app (admin, developer, tester), muchas veces funciona en Modo Desarrollo sin necesidad de revision. Como vos sos el dueño de la app y la pagina, puede que no necesites pasar por el review.

💡 Nota: La herramienta de prueba de Lead Ads (que vamos a usar en la Parte 10) solo funciona cuando tu app esta en Modo Live. Si no podes testear, probablemente sea por esto.

⚙️ Parte 8: Configurar KiteProp

¡Ya casi terminamos! 🏁 Ahora que tenes todo configurado del lado de Facebook, solo falta ingresar tus datos en KiteProp para completar la conexion.

Paso 1. Inicia sesion en tu panel de administracion de KiteProp con tu usuario habitual.
Paso 2. Anda a ⚙️ Configuracion > Difusiones (es la seccion donde se configuran los portales inmobiliarios y las integraciones externas).
Paso 3. Scrollea hasta encontrar la seccion que dice "Meta Campaigns (Lead Ads)" y hace clic en la cabecera para expandirla/abrirla.
Paso 4. Vas a ver los siguientes campos para completar:
  • 📋 Facebook Page ID: Pega el ID numerico de tu pagina (es un numero largo que copiaste en la Parte 4, Paso 11). Se ve algo como 123456789012345.
  • 🔑 Page Access Token: Pega el Page Access Token permanente (el que obtuviste en la Parte 4, Paso 19). Es un texto largo de letras y numeros.
  • 🏠 Propiedad para recibir mensajes (opcional): Este campo es opcional. Si lo completas, todos los leads que lleguen de Meta se van a asociar a esa propiedad especifica. Si lo dejas vacio, los leads se crean sin propiedad asociada y se asignan al administrador de la empresa. Podes usar el buscador para buscar y seleccionar una propiedad.
💡 Tip: Podes crear una propiedad "ficticia" o inactiva que se llame algo como "Leads de Facebook" solo para organizar los leads que llegan de Meta, o dejarlo vacio si preferis que lleguen sin propiedad.
Paso 5. Tambien vas a ver la URL de Webhook que deberia estar configurada en Meta (la misma que usaste en la Parte 3):
https://www.kiteprop.com/difusions/messages/callback/meta/push
Paso 6. Hace clic en "Guardar" para guardar toda la configuracion.
✅ ¡KiteProp ya esta listo para recibir leads de Meta!

📢 Parte 9: Crear una campaña de Lead Ads

Ya esta todo conectado. 🔌 Ahora necesitas crear una campaña de Lead Ads en Facebook, que es el anuncio que la gente va a ver y donde va a completar el formulario con sus datos.

🤔 Que es un Lead Ad? Es un tipo especial de anuncio de Facebook/Instagram que incluye un formulario dentro de la plataforma. Cuando alguien ve tu anuncio y le interesa, hace clic y le aparece un formulario que se llena automaticamente con sus datos de Facebook (nombre, email, telefono). Cuando lo envia, ese lead llega a KiteProp.
Paso 1. Anda al Administrador de Anuncios: 👉 https://www.facebook.com/adsmanager/
Paso 2. Hace clic en el boton verde "+ Crear".
Paso 3. Vas a ver una lista de objetivos de campaña. Selecciona "Leads" (o "Clientes Potenciales") y hace clic en "Continuar".
Paso 4. Nombra tu campaña. Usa algo descriptivo, por ejemplo: Leads - Departamentos Centro - Febrero 2026. Hace clic en "Siguiente".
🏠 Importante para inmobiliaria: Si tus anuncios son sobre vivienda, DEBES activar "Categorias Especiales de Anuncios" a nivel de campaña y seleccionar "Vivienda". Facebook exige esto para anuncios relacionados con propiedades y restringe algunas opciones de segmentacion. Si no declaras esto, Facebook puede rechazar tu anuncio o suspender tu cuenta publicitaria.
Paso 5. Configura el Conjunto de Anuncios:
  • Ubicacion de conversion: Selecciona "Formularios Instantaneos" (Instant Forms). ⚡ Esto es CLAVE — si elegis otra opcion (como "Sitio web"), los leads NO van a llegar a KiteProp porque no se genera el formulario dentro de Facebook.
  • Objetivo de rendimiento: Tenes dos opciones:
    • "Maximizar cantidad de leads": Facebook va a mostrar tu anuncio a mas gente para conseguir mas leads (puede haber algunos de menor calidad).
    • "Maximizar cantidad de leads de conversion": Facebook va a buscar leads de mayor calidad (menos cantidad pero mas interesados).
  • Presupuesto: Configura cuanto queres gastar por dia o en total.
  • Calendario: Pone las fechas de inicio y fin de tu campaña.
  • Audiencia: Define a quien queres que le aparezca tu anuncio:
    • 📍 Ubicacion: Tu ciudad o barrio objetivo
    • 👤 Edad: Generalmente 25-65 para inmobiliaria
    • 🎯 Intereses: Inmobiliaria, compra de vivienda, departamentos, casas, mudanza, etc.
Paso 6. Hace clic en "Siguiente" para avanzar al nivel de Anuncio.
Paso 7. Crea tu Anuncio (lo que la gente va a ver en su feed):
  • Formato: Elegi entre Imagen unica, Carrusel (varias fotos) o Video.
  • Media: Subi las fotos de tu propiedad o un video del inmueble. Usa fotos de buena calidad, bien iluminadas.
  • Texto del anuncio: Escribi algo atractivo. Por ejemplo:
    "🏠 ¿Buscas tu hogar ideal en [Ciudad]? Tenemos las mejores opciones en departamentos y casas. Completa el formulario y te contactamos con opciones personalizadas. ¡Sin compromiso!"
  • Llamada a la accion: Selecciona un boton como "Mas informacion", "Registrarte" o "Obtener presupuesto".
Paso 8. Crea tu Formulario Instantaneo (el formulario que el usuario completa):
  • Busca la seccion "Formulario Instantaneo" y hace clic en "Crear formulario".
  • Nombre del formulario: Ponele algo como Formulario Contacto - Departamentos Centro
  • Tipo de formulario:
    • 📝 "Mas volumen": El formulario es mas simple y rapido de completar. Conseguis mas leads, pero algunos pueden ser de menor calidad.
    • ✍️ "Mayor intencion": Agrega un paso extra donde el usuario revisa y confirma sus datos antes de enviar. Conseguis menos leads pero de mejor calidad.
  • Preguntas (los campos del formulario):
    • ✅ Nombre completo — Se autocompleta con el nombre de Facebook del usuario
    • ✅ Email — Se autocompleta con su email de Facebook
    • ✅ Numero de telefono — Se autocompleta con su telefono (si lo tiene en Facebook)
    • ➕ Podes agregar preguntas personalizadas como:
      • "¿Que tipo de propiedad buscas?" (opcion multiple: Departamento, Casa, Local, etc.)
      • "¿Cual es tu presupuesto estimado?"
      • "¿Cuando buscas mudarte?"
  • Politica de privacidad: Facebook te obliga a poner la URL de tu politica de privacidad.
  • Pantalla de agradecimiento: Es lo que ve el usuario despues de enviar el formulario. Personaliza el mensaje, por ejemplo:
    "¡Gracias por tu consulta! 🎉 Uno de nuestros asesores te va a contactar en las proximas horas con opciones que se ajusten a lo que buscas."
Paso 9. Revisa todo y hace clic en "Publicar" 🚀 para lanzar tu campaña.
✅ ¡Tu campaña esta activa! Cada vez que alguien complete el formulario, Facebook se lo va a avisar a KiteProp y el lead va a aparecer automaticamente en tu bandeja de mensajes.

✅ Parte 10: Probar que todo funcione

Antes de confiar en que todo anda perfecto, es buena idea hacer una prueba. Meta ofrece una herramienta especial para esto.

🧪 Metodo 1: Usando la herramienta de prueba de Lead Ads (recomendado)

Paso 1. Anda a: 👉 https://developers.facebook.com/tools/lead-ads-testing/
Paso 2. En el desplegable "Page", selecciona tu Pagina de Facebook.
Paso 3. En el desplegable "Form", selecciona un formulario (necesitas tener al menos un formulario de leads creado — el que hiciste en la Parte 9).
Paso 4. Busca la seccion "Webhook Subscription for the Selected Page" y verifica que tu app aparezca listada y muestre como suscrita. Si no aparece, revisa la Parte 5.
Paso 5. Hace clic en el boton "Create Lead" (Crear Lead).
Paso 6. 🔍 Anda a tu CRM KiteProp y verifica que el lead de prueba haya llegado a tu bandeja de mensajes. Deberia aparecer como un nuevo mensaje con source "meta_lead".
📌 Notas importantes:
  • Meta solo permite UN lead de prueba por formulario a la vez. Si queres probar de nuevo, primero hace clic en "Delete Lead" (Eliminar Lead) y despues "Create Lead" otra vez.
  • Esta herramienta solo funciona cuando tu app esta en Modo Live (Parte 7). Si el boton "Create Lead" no hace nada o da error, verifica que tu app este en modo Live.

📱 Metodo 2: Probar con un anuncio real (alternativo)

Si la herramienta de prueba no funciona (porque tu app esta en Modo Desarrollo), podes probar con un anuncio real:

  1. Crea una campaña de Lead Ads con un presupuesto muy chico (ej: $1 por dia)
  2. Configura la audiencia para que solo te apunte a vos (usa tu edad exacta, tu ubicacion y intereses muy especificos)
  3. Cuando veas el anuncio en tu feed de Facebook o Instagram, completa el formulario
  4. Verifica si el lead aparece en KiteProp

💡 Una vez que verifiques que funciona, podes pausar o eliminar esa campaña de prueba.

🔍 Parte 11: Que es el Graph API Explorer

Si llegaste aca quizas te quedo la duda de que era esa herramienta que usamos en la Parte 4 y 5. Aca te lo explicamos un poco mas.

El Graph API Explorer es una herramienta que Meta ofrece para interactuar con los datos de Facebook directamente desde tu navegador. 💻 Pensalo como un "control remoto" con el que le podes pedir cosas a Facebook o darle instrucciones.

URL: 👉 https://developers.facebook.com/tools/explorer/

🖥️ Que ves en la pantalla:

Elemento Donde esta Para que sirve
Desplegable "Meta App" Arriba a la derecha Para elegir con que app trabajar. Siempre selecciona tu app de KiteProp
Campo "Access Token" Arriba Aca va tu token (tu "llave"). Segun que token pongas, tenes acceso a cosas distintas
Desplegable del metodo A la izquierda del campo de query Dice "GET" por defecto. Podes cambiarlo a "POST", etc.
Campo de query Al medio Aca escribis que queres hacer. Ej: me/accounts
Boton "Submit" A la derecha Ejecuta tu solicitud
Panel de resultados Abajo Muestra la respuesta de Facebook

🤔 Que significan GET y POST?

  • GET = "Dame informacion" 📖 — Por ejemplo: "mostrame mis paginas", "decime los datos de este token"
  • POST = "Hace algo" ✍️ — Por ejemplo: "suscribi mi pagina a eventos de leads"

📋 Tabla de comandos utiles:

Que queres hacer Metodo Que escribir
Ver tus paginas y sus tokens GET me/accounts
Obtener el token de una pagina especifica GET TU_PAGE_ID?fields=access_token
Suscribir tu pagina a leads POST TU_PAGE_ID/subscribed_apps?subscribed_fields=leadgen
Ver a que esta suscrita tu pagina GET TU_PAGE_ID/subscribed_apps

💡 Siempre reemplaza TU_PAGE_ID con el numero real de ID de tu pagina.

🛠️ Parte 12: Problemas frecuentes y soluciones

❌ "The Callback URL or Verify Token couldn't be validated"

🤔 Que significa: Facebook intento conectarse a la URL de KiteProp para verificar la conexion, pero no recibio la respuesta que esperaba.

✅ Solucion:

  • Verifica que la URL sea exactamente https://www.kiteprop.com/difusions/messages/callback/meta/push (sin espacios, sin letras extra).
  • Verifica que el Verify Token coincida exactamente con el que te dio KiteProp (copialo y pegalo, no lo escribas a mano).
  • Contacta al equipo de soporte de KiteProp para confirmar que el servidor este funcionando y el verify token este configurado en el sistema.
❌ "Configure todo pero los leads no llegan a KiteProp"

✅ Checklist de verificacion (revisalos en orden):

☐ ¿Suscribiste "leadgen" en el producto Webhooks de tu app? → Parte 3, Paso 8
☐ ¿Suscribiste tu pagina especifica mediante el request POST en el Graph API Explorer? → Parte 5
☐ ¿Le diste acceso CRM a tu app en el Lead Access Manager? → Parte 6 (¡este es el que mas se olvida!)
☐ ¿Tu app esta en Modo Live? → Parte 7
☐ ¿El Page Access Token sigue siendo valido? → Anda al Access Token Debugger, pega tu token y fijate si dice "Expired"
☐ ¿Configuraste el Page ID y el Page Access Token en KiteProp? → Parte 8
❌ "No puedo encontrar mi pagina en el Graph API Explorer"

🤔 Que significa: Cuando escribis me/accounts no aparece tu pagina en los resultados.

✅ Solucion: Esto pasa cuando no estas logueado con la cuenta correcta o no autorizaste los permisos para esa pagina. Volve a generar el Access Token (Parte 4, Paso 3) y cuando te aparezca la ventana de autorizacion, asegurate de marcar tu pagina en la lista.

❌ "La herramienta de prueba de Lead Ads dice 'No forms found'"

🤔 Que significa: No encontro ningun formulario de leads para hacer la prueba.

✅ Solucion: Primero necesitas crear al menos una campaña de Lead Ads con un Formulario Instantaneo (Parte 9). Sin formulario, no hay nada que probar.

❌ "El App Review me pide un video de screencast"

🤔 Que significa: Facebook quiere verificar que tu app usa los datos de leads de forma legitima antes de aprobar el permiso leads_retrieval.

✅ Solucion: Graba una grabacion de pantalla simple de 30-60 segundos con estos pasos:

  1. 📹 Mostra tu campaña de Lead Ads activa en Facebook
  2. 📹 Mostra como un lead llega automaticamente a tu CRM KiteProp
  3. 🎙️ Explica brevemente (podes poner texto o narrar): "Somos una inmobiliaria que usa leads de Facebook para contactar a potenciales clientes interesados en nuestras propiedades. Los leads se reciben automaticamente en nuestro CRM para seguimiento."
❌ "Mi token expiro y los leads dejaron de llegar"

🤔 Que significa: El token que guardaste en KiteProp se vencio, y sin un token valido, KiteProp no puede obtener los datos de los leads de Facebook.

✅ Solucion: Segui la Parte 4D de nuevo para generar un Page Access Token permanente (que nunca expira). Despues actualizalo en KiteProp (Parte 8). Para verificar que el nuevo token sea permanente, usa el Access Token Debugger y confirma que diga "Expires: Never".

❌ "El webhook estaba funcionando pero dejo de funcionar de repente"

🤔 Posibles causas:

  • El servidor de KiteProp estuvo inaccesible por un tiempo prolongado y Facebook dejo de enviar eventos.
  • Alguien cambio los permisos de administrador de la pagina.
  • Se revocaron los permisos en el Lead Access Manager.
  • Meta actualizo los requisitos de la API.

✅ Solucion:

  1. Revisita todos los pasos de la Parte 3 a la Parte 6 para verificar que todo siga configurado
  2. Re-suscribi tu pagina ejecutando el POST del Paso 5 otra vez
  3. Si es necesario, genera un nuevo Page Access Token permanente (Parte 4D) y actualizalo en KiteProp (Parte 8)
  4. Si nada funciona, contacta al soporte de KiteProp

📌 Resumen de URLs importantes

Guarda esta tabla a mano para tener rapido acceso a todas las herramientas:

🔗 Proposito URL
Portal de Meta para Desarrolladores https://developers.facebook.com
Dashboard de tus Apps https://developers.facebook.com/apps/
Graph API Explorer https://developers.facebook.com/tools/explorer/
Access Token Debugger https://developers.facebook.com/tools/debug/accesstoken/
Herramienta de prueba de Lead Ads https://developers.facebook.com/tools/lead-ads-testing/
Administrador de Anuncios de Facebook https://www.facebook.com/adsmanager/
Configuracion de Meta Business https://business.facebook.com/settings/
Lead Access Manager https://business.facebook.com/settings/leads-accesses/
Webhook URL de KiteProp https://www.kiteprop.com/difusions/messages/callback/meta/push

💡 Tips finales y advertencias

🔄 Facebook cambia su interfaz con frecuencia. Los nombres de botones, ubicaciones de menu e incluso nombres de permisos pueden cambiar. El proceso central es el mismo, pero si algo no coincide exactamente con esta guia, busca la opcion equivalente.
⏰ Los tokens pueden dejar de funcionar. Incluso los tokens "permanentes" pueden ser invalidados si: cambias tu contraseña de Facebook, la pagina se transfiere a otro Business Portfolio, alguien te quita el rol de admin, o desactivas tu cuenta temporalmente. Revisalo si algo deja de funcionar.
🔒 Todo usa HTTPS. La URL de KiteProp ya usa HTTPS, que es el protocolo seguro que Facebook requiere. No necesitas hacer nada extra respecto a esto.
🏠 Los anuncios de vivienda tienen restricciones especiales. En muchos paises, Facebook exige que declares tus anuncios como "Categoria Especial de Anuncios: Vivienda". Esto limita algunas opciones de targeting pero es obligatorio para anuncios inmobiliarios.
🧪 Solo un lead de prueba a la vez. Cuando uses la herramienta de testing, tenes que eliminar el lead de prueba anterior antes de crear uno nuevo.
🔑 El Page Access Token es tu pieza clave. Sin un token valido con el permiso leads_retrieval, KiteProp no puede obtener los datos del lead. Si los leads dejan de llegar, lo primero que tenes que chequear es si el token sigue vigente.
🤫 Tu App Secret es secreto de verdad. Nunca lo compartas publicamente, en emails, ni en grupos de WhatsApp. Es equivalente a la contraseña de tu app.
📞 ¿Tenes dudas o algo no funciona? Contacta al equipo de soporte de KiteProp que te van a ayudar a resolver cualquier problema con la integracion.