Rechercher des contacts
boond_contacts_searchSearch contacts in BoondManager with server-side filters by name, company, state, type, completeness, and more. Retrieve paginated results with sorting and field projection.
Instructions
Recherche des contacts (interlocuteurs clients / prospects) dans BoondManager avec filtres serveur.
⚠️ Utilisez les filtres structurés plutôt que la pagination intégrale. Les noms de paramètres sont ceux exacts de l'API.
Cas d'usage courants :
• Mes contacts sans connaître son propre ID : perimeterDynamic: ["data"]. Pour "contacts gérés par X" : perimeterManagers: [<X_id>].
• Contacts d'une société donnée : utiliser keywords: "CSOC<companyId>" (préfixe CSOC + ID). Exemple : keywords: "CSOC6420" pour la société 6420.
• États / types : states: [<id>] (dictionnaire setting.state.contact), typesOf: [<id>] (⚠️ avec un 's' final, dictionnaire setting.typeOf.contact), companyStates (états des sociétés rattachées). IDs entiers.
• Périmètre orga : perimeterAgencies, perimeterPoles, perimeterBusinessUnits. narrowPerimeter: true pour ET.
• Profil métier : activityAreas, expertiseAreas, tools, origins (sources), influencers.
• Période : period: "created"|"updated"|"withActions"|"withoutActions"|"noAction" + startDate/endDate.
• Complétude : completeness: ["email:empty","phone:empty"] (OU par défaut, '#AND#' en 1er pour ET) — utile pour "contacts sans email".
• Recherche par nom : keywords: "Dupont" + keywordsType: "lastName" (ou firstName, fullName "NOM#PRENOM", companyFullName "CSOCid#NOM#PRENOM", emails, phones, socialNetworks).
Pagination : page, pageSize (max 500). Tri : sort + order.
Returns : liste paginée des contacts. Utiliser boond_contacts_get ou les outils d'onglets pour le détail.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Numéro de page (défaut: 1, max: 100) | |
| sort | No | Champ de tri (ex: lastName, firstName, updateDate) | |
| flags | No | IDs de tags. | |
| order | No | Ordre de tri (asc/desc) | |
| tools | No | IDs d'outils/technos (dictionnaire setting.tool). Logique OU par défaut. Pour ET, ajouter '#AND#' en 1er élément: tools=['#AND#','12','34']. | |
| fields | No | Projection côté client : liste d'attributs JSON:API à afficher pour chaque résultat (ex: ['title', 'updateDate', 'numberOfActiveProjects']). Réduit fortement la taille de la réponse. Absent = résumé standard (nom, email, ville, statut...). Les noms inconnus sont ignorés. | |
| period | No | Filtre temporel : 'created', 'updated', 'noAction'/'withActions'/'withoutActions'. À combiner avec `startDate` + `endDate`. | |
| states | No | IDs d'états de contact (dictionnaire setting.state.contact). | |
| endDate | No | Date de fin (YYYY-MM-DD), à utiliser avec `period`. | |
| origins | No | IDs d'origines (dictionnaire setting.origin). | |
| shields | No | Niveau de complétude. | |
| typesOf | No | IDs de types de contact (dictionnaire setting.typeOf.contact). ⚠️ Le paramètre s'appelle `typesOf` (avec un 's'), PAS `typeOf`. | |
| keywords | No | Mots-clés (défaut: nom + prénom + société + fonction + périmètre technique). Combinable avec `keywordsType`. | |
| pageSize | No | Nombre de résultats par page (max: 500, défaut: 30) | |
| startDate | No | Date de début (YYYY-MM-DD), à utiliser avec `period`. | |
| influencers | No | IDs de contacts influenceurs. | |
| completeness | No | Filtre par complétude des champs au format `fieldId:mode` (fieldId: email/phone/socialNetworks ; mode: empty/filled). Logique OU par défaut, '#AND#' en 1er pour ET. Ex: ['email:empty','phone:empty']. | |
| keywordsType | No | Champ ciblé. Défaut: 'default'. Pour 'fullName' utiliser `keywords = 'NOM#PRENOM'`. Pour 'companyFullName' utiliser `keywords = 'CSOCid#NOM#PRENOM'`. | |
| activityAreas | No | IDs de secteurs d'activité de la société. | |
| companyStates | No | IDs d'états des sociétés rattachées (dictionnaire setting.state.company). | |
| expertiseAreas | No | IDs de domaines d'expertise de la société. | |
| perimeterPoles | No | IDs de pôles. Conserve les entités dont le responsable appartient à ces pôles. | |
| narrowPerimeter | No | Si true, jointure ET entre les filtres `perimeter*` (au lieu de OU par défaut). | |
| perimeterDynamic | No | Périmètre dynamique relatif à l'utilisateur courant (raccourci sans avoir à connaître son propre ID). Valeurs : 'data' (mes propres données), 'managers' (mon équipe / mes N-1), 'agencies' (mes agences), 'poles' (mes pôles), 'businessUnits' (mes BU). Combinable. | |
| perimeterAgencies | No | IDs d'agences. Conserve les entités dont le responsable appartient à ces agences. | |
| perimeterManagers | No | IDs des managers (ressources). Conserve les entités dont le responsable est l'un de ces managers. Pour 'mon équipe / N-1 d'une personne X', passer [X_id]. Obtenir son propre ID via boond_application_current_user. | |
| perimeterBusinessUnits | No | IDs de business units. Conserve les entités dont le responsable appartient à ces BU. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | Nombre d'éléments retournés sur cette page | |
| items | Yes | ||
| total | No | Nombre total de résultats côté BoondManager |