Rechercher des opportunités
boond_opportunities_searchSearch business opportunities in BoondManager using structured filters like manager, agency, state, period, keywords, and more to precisely target results.
Instructions
Recherche des opportunités commerciales 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 opportunités sans connaître son propre ID : perimeterDynamic: ["data"]. Pour "opportunités de X" : perimeterManagers: [<X_id>] (combiner avec perimeterManagersType: "main"|"hr").
• États / types : opportunityStates: [<id>] (dictionnaire setting.state.opportunity), opportunityTypes: [<id>] (setting.typeOf.project). IDs entiers issus du dictionnaire.
• Lié à une société/contact/candidat : utiliser keywords avec préfixes — "CSOC<id>" (société), "CCON<id>" (contact), "CAND<id>" (candidat), "COMP<id>" (ressource), "PROD<id>" (produit), "AO<id>" (opportunité).
• Périmètre orga : perimeterAgencies, perimeterPoles, perimeterBusinessUnits. narrowPerimeter: true pour ET.
• Métier : activityAreas, expertiseAreas, tools, places (zones), durations, origins.
• Positionnements : positioningStates: [<id>] ou ["none"] pour les opportunités sans positionnement.
• Période : period: "created"|"started"|"closingDate"|"updated"|"updatedPositioning"|"withActions"|... + startDate/endDate. Ex: clôtures 2026 → period: "closingDate", startDate: "2026-01-01", endDate: "2026-12-31".
Pagination : page, pageSize (max 500). Tri : sort: "creationDate"|"title"|"company.name"|"startDate"|"endDate"|"state"|"closingDate"|"answerDate"|"updateDate"|... + order.
Returns : liste paginée des opportunités. Utiliser boond_opportunities_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' (création), 'started', 'closingDate' (date de closing), 'updated', 'updatedPositioning', 'noAction'/'withActions'/'withoutActions'. À combiner avec `startDate` + `endDate`. | |
| places | No | IDs de zones (dictionnaire setting.mobilityArea). | |
| endDate | No | Date de fin (YYYY-MM-DD), à utiliser avec `period`. | |
| origins | No | IDs d'origines. | |
| shields | No | Niveau de complétude. | |
| keywords | No | Mots-clés. Pour cibler par ID préfixé : 'AOnnn' (opportunité), 'CSOCnnn' (société), 'CCONnnn' (contact), 'CANDnnn' (candidat), 'COMPnnn' (ressource), 'PRODnnn' (produit). Sinon recherche plein texte sur titre/société. | |
| pageSize | No | Nombre de résultats par page (max: 500, défaut: 30) | |
| durations | No | IDs de durées (dictionnaire setting.duration). | |
| startDate | No | Date de début (YYYY-MM-DD), à utiliser avec `period`. | |
| activityAreas | No | IDs de secteurs d'activité. | |
| expertiseAreas | No | IDs de domaines d'expertise. | |
| 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). | |
| opportunityTypes | No | IDs de types d'opportunité (dictionnaire setting.typeOf.project). | |
| 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. | |
| opportunityStates | No | IDs d'états d'opportunité (dictionnaire setting.state.opportunity). | |
| 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. | |
| positioningStates | No | IDs d'états de positionnement, ou 'none' pour les opportunités sans positionnement. | |
| perimeterManagersType | No | Type de responsable visé par `perimeterManagers` (main/hr). | |
| 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 |