Actualizar un Cliente

Actualiza la información de un cliente específico por número de teléfono. Solo se modifican los campos incluidos en la solicitud.

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

Parámetros de URL

ParámetroTipoDescripciónRequerido
idstringNúmero telefónico del cliente en formato E.164 sin + o el id del cliente

Cuerpo de la solicitud

Todos los campos son opcionales. Solo se actualizarán los campos incluidos.

CampoTipoDescripción
namestringNombre completo del cliente
firstnamestringPrimer nombre del cliente
lastnamestringApellido del cliente
emailstringEmail del cliente
birthdatestringFecha de nacimiento. Formato: dd/mm/yyyy
genderenumGénero: male o female
companystringNombre de la compañía
countryenumPaís de residencia (código ISO 3166-1 alpha-2)
statestringEstado de residencia
citystringCiudad de residencia
addressstringDirección completa
postalCodestringCódigo postal
tagsarrayArreglo de etiquetas
customFieldsobjectCampos personalizados
ownersarrayLista de correos de usuarios responsables

Comportamiento de actualización

  • owners debe enviarse como lista de correos electrónicos
  • cada correo debe existir como usuario del workspace
  • tags se combinan con las etiquetas existentes sin duplicados
  • customFields se fusionan con los ya existentes
  • el phoneNumber del path se normaliza y se conserva como identificador del cliente

Ejemplo de solicitud

{
  "name": "José",
  "email": "jose@platica.mx",
  "tags": ["vip"],
  "customFields": {
    "placas": "ABC123",
    "id_recepcion": "REC001"
  }
}

Respuesta

{
  "status": "success",
  "message": "Client updated successfully",
  "data": {
    "id": "274fc73cb7d84a17955914fdc1a1f9d0"
  }
}