Rechercher des sociétés
boond_companies_searchSearch BoondManager companies using structured filters to find clients, prospects, and suppliers by perimeter, status, expertise, or date range.
Instructions
Recherche des sociétés (clients, prospects, fournisseurs…) 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 comptes sans connaître son propre ID : perimeterDynamic: ["data"]. Pour "comptes gérés par X" : perimeterManagers: [<X_id>].
• États : states: [<id>] (dictionnaire setting.state.company). IDs entiers.
• Périmètre orga : perimeterAgencies, perimeterPoles, perimeterBusinessUnits. narrowPerimeter: true pour ET.
• Segmentation métier : expertiseAreas (dictionnaire setting.expertiseArea), origins, influencers.
• Période : period: "created"|"updated"|"withActions"|"withoutActions"|"noAction" + startDate/endDate.
• Recherche : keywords + keywordsType ('default' = nom/ville/pays/expertise/info, ou 'name', 'phones', 'emails', 'socialNetworks'). Pour cibler une société par ID : keywords: "CSOC<id>".
Pagination : page, pageSize (max 500). Tri : sort + order.
Note : il n'y a PAS de filtre typeOf pour les sociétés dans l'API search. Le type (client/prospect/fournisseur) doit être inféré via le détail de la société (boond_companies_get).
Returns : liste paginée des sociétés. Utiliser boond_companies_get ou les outils d'onglets pour le détail.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | No | Mots-clés (défaut: nom + ville + pays + expertise + informations). Combinable avec `keywordsType`. | |
| keywordsType | No | Champ ciblé par `keywords`. Défaut: 'default'. | |
| 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. | |
| perimeterAgencies | No | IDs d'agences. Conserve les entités dont le responsable appartient à ces agences. | |
| perimeterPoles | No | IDs de pôles. Conserve les entités dont le responsable appartient à ces pôles. | |
| perimeterBusinessUnits | No | IDs de business units. Conserve les entités dont le responsable appartient à ces BU. | |
| 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. | |
| narrowPerimeter | No | Si true, jointure ET entre les filtres `perimeter*` (au lieu de OU par défaut). | |
| states | No | IDs d'états de société (dictionnaire setting.state.company). | |
| expertiseAreas | No | IDs de domaines d'expertise (dictionnaire setting.expertiseArea). | |
| origins | No | IDs d'origines (dictionnaire setting.origin). | |
| influencers | No | IDs d'influenceurs. | |
| flags | No | IDs de tags. | |
| period | No | Filtre temporel : 'created', 'updated', 'noAction'/'withActions'/'withoutActions'. À combiner avec `startDate` + `endDate`. | |
| startDate | No | Date de début (YYYY-MM-DD), à utiliser avec `period`. | |
| endDate | No | Date de fin (YYYY-MM-DD), à utiliser avec `period`. | |
| shields | No | Niveau de complétude. | |
| sort | No | Champ de tri (ex: lastName, firstName, updateDate) | |
| order | No | Ordre de tri (asc/desc) | |
| page | No | Numéro de page (défaut: 1, max: 100) | |
| pageSize | No | Nombre de résultats par page (max: 500, défaut: 30) |