Propiedades de contacto

Las Propiedades de contacto te permiten adjuntar datos estructurados a las conversaciones más allá de los campos integrados (email, name, userId). A diferencia de los metadata de formato libre, las propiedades tienen un esquema definido con tipos, etiquetas y validación — similar a los campos personalizados de HubSpot o Salesforce.

Las propiedades se definen por agente en Ajustes del agente → Propiedades de contacto. Cada propiedad tiene:

Pasa los valores de las propiedades en el campo properties de Respondo.identify(). Las claves deben coincidir con las definiciones de propiedades de los Ajustes del agente.

Respondo.identify({
  email: 'user@example.com',
  name: 'Jane Smith',
  userId: 'usr_456',
  properties: {
    account_type: 'enterprise',   // enum
    region: 'eu-west',            // string
    monthly_spend: '15000',       // number (pasado como cadena)
    is_partner: 'true',           // boolean (pasado como cadena)
    contract_end: '2026-12-31',   // date
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});

El Fragmento de integración aparece automáticamente en Ajustes del agente → Propiedades de contacto en cuanto has definido al menos una propiedad, con todas tus claves de propiedad precompletadas. Haz clic en Copiar para tomarlo y pégalo en tu aplicación. El fragmento generado también incluye un placeholder de userHash para la verificación de identidad (HMAC-SHA256).

Los valores de las propiedades se almacenan en el campo JSONB metadata de la conversación con un prefijo cp_. Por ejemplo, una propiedad con la clave account_type se almacena como cp_account_type.

Las propiedades se actualizan en cada mensaje — si el widget envía nuevos valores, sobrescriben los existentes. Esto significa que los valores de las propiedades siempre reflejan los datos más recientes de tu aplicación.

Filtra conversaciones por valores de propiedad usando la barra de filtros de la Bandeja de entrada o una Vista guardada. Añade una condición Property, elige la propiedad por nombre — el selector lista todas las definiciones de todos tus agentes y también acepta una clave sin definición — y luego elige un valor. El campo de valor sugiere los valores observados y los valores enum a medida que escribes.

A través de la API, los endpoints de listado de conversaciones aceptan un parámetro de consulta cp.<key>=<value> (un alias exacto de attr.<key>). No existe una sintaxis de consulta de texto libre:

GET /api/v1/conversations?cp.account_type=enterprise

Los valores de las propiedades los establece tu aplicación — mediante la integración del widget o la API — y son de solo lectura en el panel de detalles de la conversación. El panel enlaza con el perfil del contacto, donde los operadores pueden ver y editar los atributos del contacto (Contactos → contacto → Atributos).