Rechercher des contacts

Recherchez les contacts qui correspondent aux critères de recherche fournis.

Pour restreindre les résultats de votre recherche, choisissez All Matching Contacts pour votre jeu de résultats et effectuez une recherche à l'aide d'un seul champ (par exemple, Email). Vous pouvez faire suivre cette carte d'une carte de fonction Filtre ou Filtre personnalisé pour affiner davantage les résultats de la recherche.

Options

Champ Définition Type Obligatoire

Jeu de résultats

Choisissez si vous souhaitez renvoyer un ou tous les contacts correspondants :

  • First Matching Contact

  • All Matching Contacts

Liste déroulante TRUE

Utiliser des filtres ?

Indique s'il faut utiliser des filtres.

Si vous sélectionnez No, puis choisissez -- No Filters -- dans le menu déroulant Opérateur de filtres.

 Liste déroulante TRUE

Opérateur de filtres

Type de filtre à utiliser. Si l'option Utiliser des filtres ? est définie sur No, sélectionnez -- No Filters --. Sinon, choisissez l'une des options suivantes :

  • Equal to

  • Not equal to

  • Less than

  • Less than or equal to

  • Greater than

  • Greater than or equal to

  • Has property value

  • Does not have property value

  • Contains word

  • Does not contain word

Liste déroulante TRUE

Afficher les propriétés masquées ?

Sélectionnez Yes pour afficher les propriétés qui sont des champs masqués dans HubSpot CRM.

 Liste déroulante TRUE

Entrée

Les champs de saisie disponibles sont générés de façon dynamique sur la base des propriétés qui sont définies pour les contacts dans HubSpot CRM. La liste des propriétés disponibles comprend toutes les propriétés personnalisées que vous avez créées pour les contacts. Sélectionnez les champs sur lesquels vous souhaitez baser votre recherche.

Champ Définition Type Obligatoire

Rechercher

Nom, Téléphone, Adresse e-mail ou Entreprise

La valeur que vous souhaitez rechercher.

 Texte FALSE

Propriétés

Dynamique

Les champs disponibles sont générés de façon dynamique, en fonction de la configuration de votre organisation HubSpot CRM.

Le type dépend des champs de la configuration HubSpot CRM

 FALSE

Filtres personnalisés

HubSpot CRM vous permet de créer jusqu'à trois groupes de filtres, chacun d'entre eux pouvant contenir trois filtres maximum.

Par exemple, un filtre qui vérifie les entrées dont le prénom est Alice serait écrit comme suit :

{
    "propertyName": "firstname",
    "operator": "EQ",
    "value": "Alice"
}

De même, vous pouvez filtrer les entrées selon qu'elles possèdent ou non une propriété :

{
    "propertyName": "enum1",
    "operator": "HAS_PROPERTY",
}

Vous pouvez filtrer les entrées qui ne possèdent pas de propriété spécifique :

{
    "propertyName": "enum2",
    "operator": "NOT_HAS_PROPERTY",
}

Les entrées multiples d'un groupe de filtres sont combinées à l'aide d'un opérateur logique AND. Prenez l'exemple suivant :

{
    "propertyName": "associations.company",
    "operator": "EQ",
    "value": "Example"
},
{
    "propertyName": "associations.contact",
    "operator": "EQ",
    "value": "123"
},
{
    "propertyName": "associations.deal",
    "operator": "EQ",
    "value": "456"
}

Les résultats du groupe de filtres précédent correspondent à toutes les entrées dont l'entreprise est Example et l'ID du contact est 123 et l'ID de l'offre est 456.

Si vous avez plusieurs groupes de filtres, un groupe logique OR est alors utilisé pour combiner leurs résultats. Par exemple, vous avez trois groupes de filtres : filtergrp1, filtergrp2 et filtergrp3. Les filtres de chaque groupe sont combinés à l'aide de l'opérateur AND. Les entrées résultantes sont compilées en combinant les groupes à l'aide de l'expression filtergrp1 OR filtergrp2 OR filtergrp3.

Par ailleurs, supposons que votre carte possède deux propriétés d'entrée, input1 et input2, ainsi qu'un groupe de filtre, filtergrp1. Ensuite, le jeu de résultats combine les résultats de : (input1 AND input2) OR filtergrp1.

Consultez l'HubSpot CRM API de recherche pour obtenir la liste complète des types d'objets, des propriétés et des opérateurs pris en charge pour l'utilisation avec des filtres personnalisés.

 Liste d'objets FALSE

Sortie

Vous obtenez soit un seul contact, soit une liste de contacts, selon l'option Jeu de résultats que vous avez choisie.

Chaque contact contient une liste de champs de propriétés qui sont générés de façon dynamique sur la base des propriétés qui sont définies pour les contacts dans HubSpot CRM. Cela comprend toutes les propriétés personnalisées que vous avez créées pour les contacts.