Actualizado el 25/10/2026
Con la API oficial de WhatsApp, una inmobiliaria responde un lead de portal en segundos: el lead llega al CRM, un webhook avisa a tu sistema, el sistema elige al asesor y envía una plantilla aprobada por Meta al WhatsApp del interesado. Cuando responde, se abre una ventana de 24 horas en la que el asesor envía fotos, video y horarios de visita, todo desde el mismo número de la inmobiliaria y con el historial guardado en el CRM.
Esta guía muestra la arquitectura, el código del primer contacto, el reparto de leads entre asesores y los cuidados con plantillas y consentimiento. Los ejemplos vienen de Brasil, donde los portales inmobiliarios generan gran parte de los leads, pero el esquema sirve en cualquier país.
El problema: el lead de portal se enfría rápido
Quien llena el formulario de un anuncio suele mirar varias propiedades y varias inmobiliarias el mismo día. Si la respuesta tarda horas, el interesado puede haber agendado ya una visita con otra inmobiliaria. El cuello de botella rara vez es el asesor; es el camino del lead hasta él: un correo que nadie abre, una planilla que se actualiza por la tarde, el WhatsApp personal de cada asesor sin registro.
La API oficial resuelve tres puntos:
- Velocidad. El primer contacto sale automáticamente, sin esperar a que alguien vea el correo.
- Un solo número de la inmobiliaria. Varios asesores atienden desde el mismo número, y el cliente no queda «atado» al celular de quien dejó la empresa. Consulta varios agentes en el mismo número.
- Historial. Los mensajes recibidos y enviados llegan a tu sistema por webhook y pueden guardarse en el CRM.
La arquitectura
- El portal entrega el lead al CRM inmobiliario.
- El CRM avisa a tu servicio por webhook.
- Tu servicio elige al asesor y envía la plantilla por la API de WhatsApp.
- El lead responde, la respuesta llega a tu webhook y el asesor recibe el aviso.
Cada portal entrega los leads a su manera: integración nativa con CRM, correo o API propia, según el portal y el plan contratado. El camino más simple es que el CRM reciba los leads de todos los portales y usar el webhook o la automatización del propio CRM para avisar a tu servicio. Si el CRM no tiene webhook, herramientas como n8n, Make o Zapier sirven de puente.
Lo mínimo que tu servicio necesita recibir:
{
"lead_id": "L-20931",
"origen": "portal_x",
"nombre": "Carla Mendes",
"telefono": "(11) 98888-7777",
"propiedad": { "codigo": "AP-1042", "titulo": "Departamento de 2 dormitorios, Pinheiros" },
"mensaje": "Me interesa, ¿sigue disponible?",
"recibido_en": "2026-10-25T10:12:04-03:00"
}Este formato es tuyo, no de un portal específico. Normaliza todas las fuentes a él al recibirlas.
¿Quieres probar mientras lees? Crea tu cuenta en Vectalk y envía el primer mensaje por la API oficial. Crear cuenta gratis →
El primer contacto: plantilla
El lead no te escribió por WhatsApp, así que no hay ventana de atención abierta. La única forma de iniciar la conversación es una plantilla aprobada. Fuera de la ventana de 24 horas no se puede enviar texto libre.
Ejemplo de plantilla:
{
"name": "respuesta_interes_propiedad",
"language": "es",
"category": "UTILITY",
"components": [
{
"type": "BODY",
"text": "Hola, {{1}}. Soy {{2}}, de {{3}}. Recibimos tu solicitud de información sobre la propiedad {{4}}. ¿Quieres que te envíe fotos y horarios de visita por aquí?",
"example": {
"body_text": [["Carla", "Rafael", "Inmobiliaria Ejemplo", "AP-1042"]]
}
},
{
"type": "BUTTONS",
"buttons": [
{ "type": "QUICK_REPLY", "text": "Sí, envíalas" },
{ "type": "QUICK_REPLY", "text": "Prefiero una llamada" }
]
}
]
}Sobre la categoría: Meta define la utilidad como un mensaje activado por una acción o solicitud del usuario, sin contenido promocional, y dice que los mensajes para llevar a WhatsApp una conversación que empezó en otro canal no deben enviarse si el usuario no lo pidió. Una respuesta a una solicitud de información, sin ofertas, puede aprobarse como utilidad. Si el texto habla de «condición especial», «otras propiedades que te van a encantar» o descuentos, Meta la clasifica como marketing. La decisión es de Meta, así que presupuesta el peor caso. Consulta cómo clasifica Meta las plantillas.
Código: del webhook del CRM a la plantilla
Un servicio en Node.js que recibe el lead, normaliza el teléfono, elige al asesor y envía la plantilla por la API de Vectalk (mismo payload que la Cloud API):
import express from 'express';
const app = express();
app.use(express.json());
const asesores = ['rafael', 'juliana', 'marcos'];
let siguiente = 0;
function aE164(tel) {
const digitos = tel.replace(/\D/g, '');
return digitos.startsWith('55') ? digitos : `55${digitos}`; // 55 = Brasil
}
app.post('/leads', async (req, res) => {
res.sendStatus(200); // responde rápido y procesa después
const lead = req.body;
const asesor = asesores[siguiente++ % asesores.length];
const to = aE164(lead.telefono);
const r = await fetch('https://apis.vectalk.com.br/api/messages', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.VECTALK_TOKEN}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
messaging_product: 'whatsapp',
to,
type: 'template',
template: {
name: 'respuesta_interes_propiedad',
language: { code: 'es' },
components: [{
type: 'body',
parameters: [
{ type: 'text', text: lead.nombre.split(' ')[0] },
{ type: 'text', text: asesor },
{ type: 'text', text: 'Inmobiliaria Ejemplo' },
{ type: 'text', text: lead.propiedad.codigo },
],
}],
},
}),
});
const cuerpo = await r.json();
await guardarEnCrm(lead.lead_id, {
asesor,
wa_id: to,
wamid: cuerpo.messages?.[0]?.id,
error: cuerpo.error?.code,
});
});El reparto rotativo simple (round-robin) sirve para empezar. En la práctica suele hacer falta aplicar reglas: el asesor responsable de la propiedad, la zona, venta o alquiler, la guardia del día o el asesor que ya atendió a ese cliente. Guarda las reglas en tu sistema, no en el código, para ajustarlas sin un deploy.
Si la API devuelve un error, regístralo y avisa al equipo. Los teléfonos inválidos y los números sin WhatsApp son comunes en los formularios. Una respuesta 200 solo indica que el mensaje fue aceptado; la entrega y la lectura llegan después en el webhook de estados.
Cuando el lead responde
La respuesta del lead (botón o texto) llega a tu webhook y abre la ventana de 24 horas. A partir de ahí, el asesor puede:
- enviar fotos, video de la propiedad y la ficha en PDF. Consulta cómo enviar multimedia por la API;
- ofrecer horarios de visita con una lista o botones;
- enviar la ubicación de la propiedad;
- pasar la conversación a otro asesor sin cambiar de número.
Lo ideal es que el asesor atienda desde la plataforma de atención o el CRM, no desde un celular. Todos los mensajes quedan en el historial del lead.
Si el lead no responde la plantilla, no insistas con varias plantillas seguidas. Cada plantilla fuera de la ventana se cobra, y los mensajes repetidos a quien no respondió aumentan la probabilidad de bloqueos y denuncias, lo que afecta la calidad del número. Define un tope, por ejemplo un segundo intento al día siguiente, y detente ahí.
Consentimiento y opt-in
La política de WhatsApp Business exige que la persona te haya dado su número y su permiso para recibir mensajes de tu empresa, y que se respeten las solicitudes para dejar de recibirlos. Quien llena un formulario de interés en un anuncio de tu inmobiliaria dio su número para que lo contacten sobre esa propiedad, pero el texto del formulario y los términos del portal importan. Revisa con tu área legal cómo se obtiene el consentimiento en cada fuente. Para campañas futuras (lanzamientos, nuevas propiedades), pide un opt-in de marketing aparte. Consulta cómo armar una lista opt-in.
Leads de anuncios Click-to-WhatsApp
Además de los portales, los leads pueden llegar por anuncios de Meta que abren la conversación directamente en WhatsApp. En ese caso, el cliente inicia la conversación, la ventana ya está abierta y la primera respuesta no necesita plantilla. El webhook trae datos del anuncio de origen, lo que ayuda a saber qué campaña generó la visita. Consulta cómo rastrear anuncios Click-to-WhatsApp.
Volumen
Las plantillas de primer contacto cuentan en el límite de mensajes del portafolio, que empieza en 250 destinatarios únicos en 24 horas fuera de la ventana. Para inmobiliarias con muchos leads por día, la verificación de la empresa es uno de los caminos para llegar a 2.000.
Cómo hacerlo con Vectalk
En Vectalk, envías la plantilla con POST /messages, creas plantillas con POST /templates y registras todas las URL de webhook que necesites por instancia con POST /webhooks, así los mismos eventos pueden ir al CRM y a tu servicio de reparto. Los payloads son los de Meta. Vectalk usa la Cloud API oficial y le paga a Meta por ti. Consulta la documentación y crea tu cuenta.
Preguntas frecuentes
¿Puedo enviar texto libre al lead del portal?
No, mientras no te escriba por WhatsApp. El primer contacto debe ser una plantilla aprobada. Cuando el lead responde, tienes 24 horas para mensajes libres.
¿La plantilla de respuesta es de utilidad o de marketing?
Depende del texto y de la revisión de Meta. Una respuesta sin ofertas a una solicitud de información puede ser utilidad; cualquier contenido promocional la lleva a marketing.
¿Cada asesor necesita su propio número?
No. Varios asesores pueden atender desde el mismo número de la inmobiliaria, cada uno en la plataforma de atención. Además, el historial queda en la empresa cuando un asesor se va.
¿Se puede integrar sin programar?
Sí, si el CRM tiene webhook o integración con herramientas como n8n, Make o Zapier. La herramienta recibe el lead y llama a la API de envío de plantillas.
¿Puedo enviar nuevas propiedades a leads antiguos?
Solo con una plantilla de marketing y un opt-in para ese tipo de mensaje. Respeta a quien pidió dejar de recibirlos.
Fuentes oficiales consultadas el 25/10/2026: Pautas de categorías de plantillas, Plantillas de utilidad, Límites de mensajes, Precios, Política de mensajería de WhatsApp Business, Webhooks de Vectalk.
Pon a funcionar el WhatsApp oficial de tu empresa
Crea tu cuenta, conecta tu número a la API oficial (puedes mantener la app con coexistencia) y empieza a atender y enviar mensajes.