IntegracionesAPI de captación
Ejemplos
La misma solicitud en curl, Node.js, PHP y Zapier.
Todos los ejemplos mandan el mismo lead y usan Idempotency-Key para que un reintento no duplique. Cambia zvr_live_TU_LLAVE por tu llave (guardada en una variable de entorno, nunca en el código) y ZVR-0123 por el código de una propiedad de tu catálogo.
curl -X POST https://api.zevra.co/v1/leads \
-H "Authorization: Bearer $ZEVRA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: formulario-web-8f3c2a" \
-d '{
"nombre": "Ana Ruiz",
"telefono": "+52 55 0000 0001",
"email": "ana@ejemplo.com",
"mensaje": "Quiero agendar una visita este fin de semana.",
"propiedad": { "codigo": "ZVR-0123" },
"extras": { "origen_formulario": "landing-casas", "presupuesto": 3500000 }
}'Agrega -i para ver las cabeceras (X-Request-Id, X-RateLimit-*) y -H "X-Zevra-Dry-Run: true" para probar sin escribir.
Sin propiedad
Si tu formulario es general (la página de contacto, por ejemplo), simplemente omite propiedad. El lead entra sin propiedad de interés y tu equipo la asigna después.
{
"nombre": "Ana Ruiz",
"telefono": "+52 55 0000 0001",
"mensaje": "Busco departamento en renta por la zona sur."
}Con tu código propio
Si en ZEVRA capturaste tus propios códigos de propiedad, úsalos en lugar del código ZVR:
{
"nombre": "Ana Ruiz",
"telefono": "+52 55 0000 0001",
"propiedad": { "external_code": "CASA-LOMAS-12" }
}