DiseñosEnglish

Primeros pasos

La API pública de letsrealty permite que tus propias herramientas —un creador de formularios, Zapier, un bot de WhatsApp, un marcador telefónico, un asistente de IA— lean y escriban los Leads, consultas y actividades de tu agencia, y se enteren de los cambios mediante webhooks. Está incluida en todos los planes, con los mismos límites para todos.

Todas las solicitudes van a https://api.letsrealty.io, envían y reciben JSON y llevan una clave de API.

1. Crea una clave de API

  1. Inicia sesión en tu consola de administración como administrador de la cuenta.
  2. Abre Integraciones → Claves de API y elige Crear clave.
  3. Ponle el nombre de la integración que la va a usar (el nombre aparece como "vía API: nombre" en todo lo que escriba) y elige sus permisos (scopes). Para enviar Leads, basta con leads:ingest.
  4. Copia la clave. Tiene la forma lr_live_… y se muestra una sola vez; si la pierdes, revócala y crea otra.

Guarda la clave en un servidor. Cualquiera que la tenga puede actuar en nombre de tu agencia dentro de sus permisos.

2. Haz tu primera llamada

Envía un Lead con POST /v1/leads:ingest:

curl https://api.letsrealty.io/v1/leads:ingest \
  -H "Authorization: Bearer $LETSREALTY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: form-submission-8841" \
  -d '{
    "source": "Formulario del sitio",
    "type": "inquiry",
    "person": { "name": "Ana Rojas", "email": "ana@example.com", "phone": "+506 8888 1234" },
    "message": "¿Sigue disponible la casa en Escazú?"
  }'

La respuesta es 201 Created con el Lead nuevo, o 200 OK si Ana ya era un Lead (se busca por email y luego por teléfono):

{
  "lead": { "id": "6f1c…", "name": "Ana Rojas", "source": "api", "status": "new", "…": "…" },
  "inquiry_id": "0b9e…",
  "activity_id": null,
  "warnings": []
}

El Lead ya aparece en tu pipeline con su consulta, recibe un responsable del Lead y notifica a tu equipo igual que una consulta desde el sitio web.

3. Léelo de vuelta

Con una clave que tenga leads:read:

curl https://api.letsrealty.io/v1/leads?limit=50 \
  -H "Authorization: Bearer $LETSREALTY_API_KEY"

Siguientes pasos