Sacar la lista de interesados en un auto

AutomotorasSolo en los workspaces de automotoras.

Un mismo auto recibe consultas desde el sitio, Chileautos, Yapo, Mercado Libre y Facebook. Esta receta responde la pregunta que hace un vendedor frente a una unidad: quién preguntó, desde dónde y qué tan avanzada va la conversación con cada uno.

Trampa

El lead no trae un campo vehicle_id

Un lead puede tener varios autos de interés a la vez, y un mismo auto puede tener varios leads. Filtra siempre por el auto (paso 1), no busques un campo vehicle_id dentro del lead.

Antes de empezar

Una key con leads:read para las oportunidades.
contacts:read para el nombre y el teléfono de cada interesado, y stages:read para saber en qué etapa va.
marketplace:read para los dos endpoints que resumen el auto.

1. Los leads de esta unidad

curl "https://api.vitrinadev.com/api/v1/leads?resource_type=vehicle&resource_id=26a00eb8-62ce-4a02-a9a7-72204ed8a392" \
  -H "Authorization: Bearer $VITRINA_KEY"

{
  "data": [
    {
      "id": "ce5fdcc1-ae78-468f-a7aa-5b9b587c38ca",
      "status": "open",
      "source": "yapo",
      "title": "Toyota Yaris 2022, consulta Yapo",
      "intent": "buy",
      "contact_id": "01a0ce14-39dd-7fc8-8c45-b3b1721a78c2",
      "stage_id": "00000000-0000-4000-8000-000000004101",
      "display_id": "L-33",
      "contact": {
        "id": "01a0ce14-39dd-7fc8-8c45-b3b1721a78c2",
        "name": "Rodrigo Paredes",
        "email": null,
        "phone": "+56978451236"
      },
      "stage": { "id": "00000000-0000-4000-8000-000000004101", "name": "Nuevo", "slug": "new" },
      "pipeline": { "id": "00000000-0000-4000-8000-000000004000", "kind": "sales", "name": "Ventas" }
    },
    {
      "id": "2fa9c593-1200-4e2d-88d6-0bf8e637261f",
      "status": "open",
      "source": "website",
      "title": "Toyota Yaris 2022, consulta del sitio",
      "intent": "buy",
      "contact_id": "01a0ce13-d6a9-70cd-8d7f-7345a88df003",
      "stage_id": "00000000-0000-4000-8000-000000004101",
      "display_id": "L-32",
      "contact": {
        "id": "01a0ce13-d6a9-70cd-8d7f-7345a88df003",
        "name": "Camila Rojas",
        "email": "[email protected]",
        "phone": "+56945678123"
      },
      "stage": { "id": "00000000-0000-4000-8000-000000004101", "name": "Nuevo", "slug": "new" },
      "pipeline": { "id": "00000000-0000-4000-8000-000000004000", "kind": "sales", "name": "Ventas" }
    }
  ],
  "meta": { "pagination": { "total": 2, "limit": 25 } }
}

resource_type y resource_id van juntos o no van: mandar uno sin el otro rechaza la llamada. source dice el portal (website, yapo, chileautos, mercadolibre). contact aparece solo con contacts:read, y stage solo con stages:read. Sin esos scopes, el lead llega sin esos bloques.

2. Cuánto interés hay, resumido

curl "https://api.vitrinadev.com/api/v1/vehicles/26a00eb8-62ce-4a02-a9a7-72204ed8a392/interest" \
  -H "Authorization: Bearer $VITRINA_KEY"

{
  "data": {
    "distinct_contacts": 2,
    "named_leads": 2,
    "by_portal": [
      { "source": "website", "count": 1 },
      { "source": "yapo", "count": 1 }
    ],
    "first_contact_at": "2026-09-23T11:43:28.152Z",
    "last_contact_at": "2026-09-23T11:43:47.214Z",
    "anonymous_interest": 0,
    "time_in_stock_days": 0,
    "is_sold": false
  }
}

Este endpoint no trae ids de contacto: es el resumen «7 personas preguntaron», y basta con una key que lee stock. Si el auto ya se vendió, este resumen sale vacío.

3. La línea de tiempo del auto

Para el historial completo, con quién y cuándo, incluidos los vendido:

curl "https://api.vitrinadev.com/api/v1/vehicles/26a00eb8-62ce-4a02-a9a7-72204ed8a392/activity" \
  -H "Authorization: Bearer $VITRINA_KEY"

{
  "data": [
    {
      "kind": "lead",
      "contact_id": "01a0ce14-39dd-7fc8-8c45-b3b1721a78c2",
      "lead_id": "ce5fdcc1-ae78-468f-a7aa-5b9b587c38ca",
      "source": "yapo",
      "contact_name": "Rodrigo Paredes",
      "at": "2026-09-23T11:43:47.214Z"
    },
    {
      "kind": "lead",
      "contact_id": "01a0ce13-d6a9-70cd-8d7f-7345a88df003",
      "lead_id": "2fa9c593-1200-4e2d-88d6-0bf8e637261f",
      "source": "website",
      "contact_name": "Camila Rojas",
      "at": "2026-09-23T11:43:28.152Z"
    }
  ]
}

A diferencia de /interest, esta lista sobrevive a la venta. Un auto vendido conserva aquí su historial completo. Es el registro de lo que pasó.

4. Quién es la persona

Con el contact_id de cualquiera de las llamadas anteriores, el registro completo:

curl "https://api.vitrinadev.com/api/v1/contacts/01a0ce13-d6a9-70cd-8d7f-7345a88df003" \
  -H "Authorization: Bearer $VITRINA_KEY"

{
  "data": {
    "id": "01a0ce13-d6a9-70cd-8d7f-7345a88df003",
    "name": "Camila Rojas",
    "email": "[email protected]",
    "phone": "+56945678123",
    "lifecycle_stage": "unknown",
    "lead_sources": ["website"],
    "named": true,
    "display_name": "Camila Rojas"
  }
}

Requiere contacts:read, un scope aparte de leads:read. Una key que solo lista oportunidades no abre el contacto.

Cuando falla

Mandar resource_id sin resource_type en el paso 1, o al revés, rechaza la llamada completa con VALIDATION_ERROR.

En la aplicación: la misma lista está en la ficha del auto, en la tarjeta Interés. La ficha no tiene pestañas: es una página que se recorre, y la tarjeta vive entre Publicaciones y Solicitudes.

La tarjeta Interés en la ficha de un auto: cuántas personas preguntaron, de qué portal vino cada lead y cuándo

Con la lista en la mano, el siguiente paso es escribirles: Reabre una conversación fría con una plantilla, sin que Meta te bloquee. Cubre cómo mandarles WhatsApp sin quemar el número, por ejemplo cuando entra un auto parecido al que vieron.

Cómo entran los leads en primer lugar, con la firma del webhook incluida, está en Recibir los leads en tu CRM.