Propriétés de contact

Les propriétés de contact vous permettent d’attacher des données structurées aux conversations, au-delà des champs intégrés (email, name, userId). Contrairement aux metadata libres, les propriétés possèdent un schéma défini avec des types, des libellés et une validation — semblable aux champs personnalisés de HubSpot ou Salesforce.

Les propriétés sont définies par agent dans Paramètres de l’agent → Propriétés de contact. Chaque propriété possède :

Transmettez les valeurs des propriétés dans le champ properties de Respondo.identify(). Les clés doivent correspondre aux définitions de propriétés des Paramètres de l’agent.

Respondo.identify({
  email: 'user@example.com',
  name: 'Jane Smith',
  userId: 'usr_456',
  properties: {
    account_type: 'enterprise',   // enum
    region: 'eu-west',            // chaîne
    monthly_spend: '15000',       // nombre (transmis sous forme de chaîne)
    is_partner: 'true',           // booléen (transmis sous forme de chaîne)
    contract_end: '2026-12-31',   // date
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});

L’extrait d’intégration apparaît automatiquement dans Paramètres de l’agent → Propriétés de contact dès que vous avez défini au moins une propriété, avec toutes vos clés de propriétés préremplies. Cliquez sur Copier pour le récupérer et le coller dans votre application. L’extrait généré inclut aussi un espace réservé userHash pour la vérification d’identité (HMAC-SHA256).

Les valeurs des propriétés sont stockées dans le champ JSONB metadata de la conversation avec un préfixe cp_. Par exemple, une propriété avec la clé account_type est stockée sous cp_account_type.

Les propriétés sont mises à jour à chaque message — si le widget envoie de nouvelles valeurs, elles écrasent les existantes. Cela signifie que les valeurs des propriétés reflètent toujours les données les plus récentes de votre application.

Filtrez les conversations par valeurs de propriétés via la barre de filtres de la boîte de réception ou une vue enregistrée. Ajoutez une condition Propriété, choisissez la propriété par son nom — le sélecteur liste toutes les définitions de vos agents et accepte aussi une clé brute sans définition — puis choisissez une valeur. Le champ de valeur suggère les valeurs observées et les valeurs enum au fil de la saisie.

Via l’API, les endpoints de liste des conversations acceptent un paramètre de requête cp.<key>=<value> (alias exact de attr.<key>). Il n’existe pas de syntaxe de requête en texte libre :

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

Les valeurs des propriétés sont définies par votre application — via l’intégration du widget ou l’API — et sont en lecture seule dans le panneau de détails de la conversation. Le panneau renvoie vers le profil du contact, où les agents peuvent consulter et modifier les attributs du contact (Contacts → contact → Attributs).