Referencia (endpoints)Puntaje
Ver el puntaje de un contacto
Úsalo para saber qué tan caliente está un lead: puntaje, categoría, confianza, si está descalificado y el historial de señales que lo explican, paginado por cursor.
GET
Permiso requerido: Contactos y conversaciones → Ver
httpheader
AuthorizationBearer <clave>OK
application/json- response
score*stringsignals_count*stringcategory*stringconfidence*stringdisqualified*stringdisqualified_at*stringdisqualification_reasons*stringupdated_at*string|nullevents*array<>next_cursor*stringhas_more*booleancurl -X GET "https://example.com/contacts/{contact}/lead-score"{ "score": "string", "signals_count": "string", "category": "string", "confidence": "string", "disqualified": "string", "disqualified_at": "string", "disqualification_reasons": "string", "updated_at": "string", "events": [ { "id": "string", "signal": "string", "source": "string", "raw_points": "string", "applied_points": "string", "cap_reason": "string", "occurred_at": "string", "actor_user_id": "usr_AdaVCroxOubVJxQ0exvtano", "reason": "string" } ], "next_cursor": "string", "has_more": true}Ver cómo se reparte el puntaje GET
Sirve para ver cómo se reparte tu base entre leads calientes, tibios, fríos y sin datos suficientes, junto con los umbrales vigentes. Ideal para un tablero de calidad de leads.
Ajustar el puntaje de un contacto POST
Sirve para sumar o restar puntos al lead score de un contacto a mano, con un motivo, por ejemplo cuando tu equipo comercial confirma interés por otro canal.