Obtener un Cliente

Obtiene la información detallada de un cliente específico.

GET https://api.platica.mx/v1/clients/{id}

Parámetros de URL

ParámetroTipoDescripciónRequerido
idstringPuede ser el ID del cliente o su número de teléfono en formato E.164 sin +✓

Respuesta

{
  "workspaces": [
    {
      "id": "g6yCA16pkWl5eXo7KszB",
      "name": "ws_1",
      "clients": [
        {
          "id": "274fc73cb7d84a17955914fdc1a1f9d0",
          "phoneNumber": "524491255844",
          "name": "Juan Pérez",
          "firstname": "Juan",
          "lastname": "Pérez",
          "email": "juan.perez@email.com",
          "birthdate": null,
          "gender": "male",
          "company": null,
          "country": "MX",
          "state": "Jalisco",
          "city": "Guadalajara",
          "address": null,
          "postalCode": null,
          "status": "active",
          "moderation": {
            "totalStrikes": 0,
            "lastAction": null,
            "lastSource": null,
            "lastSeverity": null,
            "lastFlaggedAt": null,
            "lastCategories": [],
            "lastMatchedTerms": [],
            "blockedAt": null,
            "blockedBy": null,
            "blockedReason": null
          },
          "tags": [],
          "owners": ["user1@company.com", "user2@company.com"],
          "customFields": {
            "placas": "ABC123",
            "id_recepcion": "REC001",
            "fecha_siniestro": "2025-02-01"
          },
          "creationDate": "2025-02-06T16:45:50.146Z",
          "lastUpdate": "2025-02-06T16:45:50.146Z"
        }
      ],
      "clientsCount": 1
    }
  ]
}

Campos de la respuesta

CampoDescripción
idID interno del cliente
phoneNumberNúmero telefónico del cliente sin prefijo +
nameNombre completo del cliente
firstnamePrimer nombre del cliente
lastnameApellido del cliente
emailCorreo electrónico
birthdateFecha de nacimiento
genderGénero
companyNombre de la compañía
countryPaís de residencia
stateEstado de residencia
cityCiudad de residencia
addressDirección completa
postalCodeCódigo postal
statusEstado del cliente: active o blocked
moderationHistorial de moderación — ver abajo
tagsEtiquetas asociadas al cliente
ownersLista de correos de usuarios responsables
customFieldsCampos personalizados del cliente
creationDateFecha de creación en formato ISO 8601
lastUpdateFecha de última actualización en formato ISO 8601

Objeto moderation

Siempre viene completo: un cliente sin incidentes reporta totalStrikes: 0 y el resto de los campos en null o vacíos.

CampoDescripción
totalStrikesStrikes de moderación acumulados por el cliente
lastActionAcción tomada en la última falta: warn, assist o spam
lastSourceQué la detectó: lexicon, openai, llm_guardrail o supervisor
lastSeveritySeveridad de la última falta: low, medium o high
lastFlaggedAtCuándo se registró la última falta, en ISO 8601
lastCategoriesCategorías reportadas por el moderador
lastMatchedTermsTérminos que dispararon la detección
blockedAtCuándo se bloqueó al cliente, en ISO 8601. null si está activo
blockedByQuién lo bloqueó. null si el bloqueo fue automático
blockedReasonMotivo del bloqueo: guardrails_threshold_reached, manual_dashboard, conversation_spam, api_request, o el motivo libre que hayas enviado al bloquearlo
Anterior Listar Clientes Siguiente Crear un Cliente