> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Introduction aux moniteurs
> Détection de signaux automatisée avec enrichissement — livrée à votre webhook ou par e-mail en temps réel.
## Pourquoi les moniteurs ?
Les API traditionnelles vous obligent à construire et maintenir votre propre pipeline de signaux — interroger des points de terminaison en boucle, suivre un état, gérer la pagination et enchaîner plusieurs appels pour l'enrichissement. Les moniteurs remplacent tout cela par une simple configuration.
Les signaux sont détectés et livrés dès leur apparition — aucune boucle de polling ni tâche cron requise.
Combinez les filtres de signaux avec des filtres d'entreprises globaux en une seule requête. « Entreprises de 500+ employés recrutant pour des postes en IA » — une configuration, pas plusieurs appels API.
Les fiches d'entreprises et les contacts des personnes sont enrichis automatiquement à chaque déclenchement. Aucun appel API séparé n'est nécessaire.
Logique de nouvelle tentative, gestion des échecs, déduplication et suivi de livraison — tout est géré pour vous.
***
## Fonctionnement des moniteurs
Choisissez les signaux à suivre (offres d'emploi, actualités, publicités, expansions) et définissez des filtres au niveau du signal. Vous pouvez éventuellement superposer des **filtres d'entreprises globaux** pour affiner les résultats — par exemple, ne faire remonter que les signaux d'entreprises de 500+ employés basées aux États-Unis.
Avec `frequency_minute` réglé sur `0` (valeur par défaut), votre moniteur fonctionne en temps réel — détectant et livrant les signaux dès leur apparition.
Les signaux correspondants sont enrichis avec des fiches d'entreprises complètes et, en option, des contacts de personnes — le tout en un seul déclenchement. Aucun appel supplémentaire n'est nécessaire.
Les résultats arrivent à votre point de terminaison webhook ou dans votre boîte e-mail. Vous disposez aussi de statistiques complètes et d'un historique de journal via les points de terminaison du dashboard.
***
## Modes de détection
Chaque moniteur fonctionne selon l'un des deux modes de détection suivants :
**Les signaux pilotent la découverte.** Vous définissez les signaux à rechercher — le système trouve les signaux correspondants à travers toutes les entreprises, puis enrichit les résultats.
Utilisez les **filtres d'entreprises globaux** (`company_filters`) comme second niveau pour restreindre les entreprises éligibles. Par exemple : « Trouver toutes les offres d'emploi IA, mais uniquement des entreprises de 1 000+ employés. »
Idéal pour :
* Le balayage large du marché et la découverte de tendances
* Trouver de nouvelles entreprises que vous n'avez jamais suivies
* La prospection pilotée par signaux à grande échelle
```
Signal Filters → Matching Signals → Global Company Filters (optional) → Enrichment → Delivery
```
**Des entreprises spécifiques pilotent la découverte.** Vous fournissez une liste d'entreprises cibles via `companies`, `domains` ou `linkedin_urls`, et le système les surveille à la recherche de signaux correspondants.
Les **filtres d'entreprises globaux** (`company_filters`) s'appliquent toujours ici comme second niveau — utile pour combiner une liste de surveillance avec des critères plus larges.
Idéal pour :
* Le suivi de comptes nommés (« alertez-moi quand OpenAI publie de nouvelles offres »)
* Le renseignement concurrentiel sur des entreprises spécifiques
* Les pipelines de surveillance orientés compte
```
Target Companies (companies / domains / linkedin_urls) → Signal Filters → Global Company Filters (optional) → Enrichment → Delivery
```
***
## Types de signaux
Les moniteurs prennent actuellement en charge quatre types de signaux, avec d'autres ajoutés régulièrement :
Nouvelles offres d'emploi — filtrez par intitulé, localisation, date de publication, et plus encore.
Actualités d'entreprises — lancements, partenariats, levées de fonds, changements de direction, et plus encore.
Campagnes publicitaires actives — filtrez par localisation cible, plage de dates et mots-clés.
Preuves d'expansion de marché — une entreprise entrant ou se développant sur un nouveau marché, filtrée par corridor, étape et force du signal.
### Ce que révèle chaque signal
| Type de signal | Ce qu'il révèle | Exemples de cas d'usage |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Offres d'emploi** | Une entreprise recrute activement — signe de croissance, de nouvelles initiatives ou d'allocation budgétaire dans des départements spécifiques. | Une hausse des recrutements en ingénierie signale souvent la construction d'un nouveau produit. Le recrutement commercial suggère une expansion du chiffre d'affaires. |
| **Actualités** | Jalons d'entreprise — levées de fonds, lancements de produits, partenariats, changements de direction ou difficultés. | Une annonce de levée de fonds est un moment idéal pour prendre contact. Les changements de direction créent de nouvelles opportunités auprès des décideurs. |
| **Publicités** | Où et comment une entreprise dépense en marketing — révélant des plans d'expansion, des marchés cibles et un positionnement concurrentiel. | Une forte dépense publicitaire sur une nouvelle zone géographique signale une entrée sur le marché. Des concurrents menant des campagnes similaires indiquent une activité de marché. |
| **Expansions** | Une entreprise entre ou se développe sur un marché spécifique — appuyée par des preuves datées et sourcées telles que du recrutement local, un bureau ou un enregistrement. | Une entreprise atteignant l'étape `expanding` sur votre territoire est une fenêtre d'opportunité datée. Les signaux de contraction signalent des comptes à mettre en pause. |
### Cadence de livraison
Vous contrôlez la fréquence à laquelle votre moniteur scanne les nouveaux signaux via `frequency_minute` :
| Réglage | Comportement | Idéal pour |
| -------------------- | --------------------------------------------------------------- | ------------------------------------------------------- |
| **`0` (par défaut)** | **Temps réel** — signaux détectés et livrés dès leur apparition | Alertes sensibles au temps, renseignement concurrentiel |
| `15` | Toutes les 15 minutes | Surveillance prioritaire avec livraison prévisible |
| `60` | Toutes les heures | Fréquence équilibrée pour les moniteurs à volume modéré |
| `1440` | Quotidienne | Résumés type digest, suivi de priorité moindre |
La bibliothèque de signaux s'enrichit en continu. De nouveaux types de signaux sont ajoutés au fur et à mesure de leur disponibilité — vos moniteurs existants ne sont pas affectés par le lancement de nouveaux types.
***
## Filtres d'entreprises globaux
L'une des fonctionnalités les plus puissantes des moniteurs est la possibilité de combiner des filtres de signaux avec des **filtres d'entreprises globaux**. Cela vous permet de définir des critères comme :
* « Entreprises de **500+ employés** qui **recrutent pour des postes en IA** »
* « **Entreprises SaaS basées aux États-Unis** apparues dans des **actualités de lancement de produit** »
* « Entreprises utilisant des **technologies spécifiques** qui mènent des **campagnes publicitaires** en Europe »
Les filtres d'entreprises globaux (`company_filters`) acceptent les mêmes paramètres que le point de terminaison [Company Search](/fr/api-reference/endpoint/companies/search) — localisations, taille d'effectif, secteurs, technologies, verticales, et plus encore.
En mode `company_first`, utilisez `companies` (domain\_search\_ids), `domains` ou `linkedin_urls` pour spécifier votre liste d'entreprises cibles — un seul est requis. `company_filters` ajoute des critères de filtrage supplémentaires dans les deux modes.
***
## Enrichissement des personnes
Lorsque vous activez l'enrichissement des personnes, chaque déclenchement trouve automatiquement les contacts pertinents dans les entreprises correspondantes. Configurez `people_enrichment_configs` avec :
* **Filtres** — niveaux de management, départements, intitulés, localisations — mêmes paramètres que le point de terminaison [People Search](/fr/api-reference/endpoint/people/search)
* **Types de contact** — `email-work`, `email-personal`, `phone` — se réfère aux types de contact du point de terminaison [Redeem](/fr/api-reference/endpoint/redeem/people)
* **Nombre maximal de personnes à renvoyer** — de 1 à 25 par niveau de configuration
Vous pouvez définir **plusieurs niveaux d'enrichissement**, chacun avec des filtres différents. Par exemple, un niveau pour les cadres dirigeants et un autre pour les directeurs d'ingénierie. Chaque niveau exécute une recherche de personnes indépendante.
Chaque niveau d'enrichissement consomme des crédits de recherche de personnes par déclenchement, quel que soit le nombre de personnes renvoyées. Planifiez vos niveaux en fonction des audiences distinctes dont vous avez besoin.
***
## Comprendre les crédits
Chaque déclenchement de moniteur consomme des crédits selon ce qu'il traite. Consultez la page [Pricing](/fr/get-started/pricing) pour les taux de crédits les plus récents.
| Type de crédit | Mode de consommation |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Crédit de déclenchement** | 10 crédits par déclenchement |
| **Crédit d'entreprise** | Par entreprise enrichie dans les résultats |
| **Crédit de recherche de personnes** | Par niveau d'enrichissement dans `people_enrichment_configs` — chaque niveau exécute une recherche de personnes (même coût en crédits que le point de terminaison People Search) |
| **Crédit de rachat (redeem)** | Par personne rachetée — facturé uniquement en cas de récupération réussie, quel que soit le nombre d'e-mails ou de numéros de téléphone renvoyés par personne |
### Exemple
Un moniteur configuré avec `is_company_enrichment: true`, un niveau d'enrichissement des personnes avec rachat d'e-mails, et `max_records_per_trigger: 5`, se déclenche et trouve 3 entreprises avec 2 personnes chacune :
| Composant | Calcul | Crédits |
| ---------------------- | ---------------------------------------------------------------------- | ---------------------------------------- |
| Déclenchement | 1 déclenchement | 10 |
| Entreprises | 3 entreprises enrichies | 3 |
| Recherche de personnes | 1 niveau d'enrichissement | crédits de recherche de personnes |
| Rachat de personnes | 6 personnes rachetées (3 × 2, facturées par personne en cas de succès) | 6 × tarif de rachat |
| **Total** | | **13 + recherche de personnes + rachat** |
Les taux de crédits peuvent évoluer — consultez toujours la page [Pricing](/fr/get-started/pricing) pour les informations les plus récentes. N'activez l'enrichissement des personnes que si vous avez besoin de données de contact.
***
## Types de destination
Recevez les résultats sous forme de charge utile JSON sur votre point de terminaison HTTP. Incluez des en-têtes et des champs de corps personnalisés pour l'authentification. Vérifiez l'authenticité de la livraison à l'aide de la signature du moniteur.
C'est la destination recommandée pour les développeurs. Voir [Configurer les webhooks](/fr/developer-guides/setting-up-webhooks) pour un tutoriel complet.
Recevez les résultats formatés par e-mail. Prend en charge le marque blanche pour les agences et les équipes.
Intéressé par la livraison e-mail en marque blanche ? [Contactez-nous](https://pubrio.com/en/get-in-touch) pour en savoir plus.
Inscrivez automatiquement les contacts correspondants dans une séquence de prospection. Nécessite `sequence_identifier` et `record_type` dans `destination_config`.
Voir la référence du point de terminaison [Create Monitor](/fr/api-reference/endpoint/monitors/create) pour les détails de configuration.
***
## Référence de configuration
Tous les paramètres de configuration ont des valeurs par défaut sensées. Dans la plupart des cas, vous n'avez qu'à définir les filtres et la destination — tout le reste est optionnel.
| Paramètre | Plage | Défaut | Description |
| ------------------------- | --------- | ------ | ---------------------------------------------------------- |
| `frequency_minute` | 0 - 10080 | 0 | Minutes entre les scans. **`0` = temps réel.** |
| `max_records_per_trigger` | 1 - 100 | 25 | Nombre maximal d'enregistrements livrés par déclenchement. |
| `max_daily_trigger` | 0 - 86400 | 500 | Plafond quotidien de déclenchements. `0` = illimité. |
| `max_retry_per_trigger` | 0 - 3 | 1 | Tentatives de nouvelle livraison en cas d'échec. |
| `retry_delay_second` | 1 - 5 | 1 | Secondes entre les tentatives. |
| `max_failure_trigger` | 1 - 10 | 5 | Échecs consécutifs avant mise en pause automatique. |
***
## Référence des filtres
Les filtres de signal et d'entreprise réutilisent les mêmes schémas que les points de terminaison de recherche :
Mêmes filtres que Job Search — intitulés, localisations, dates de publication, et plus encore.
Mêmes filtres que News Search — catégories, galeries, mots-clés et dates.
Mêmes filtres que Advertisements Search — localisations cibles, plages de dates et mots-clés.
Mêmes filtres que Company Search — localisations, taille, secteurs, technologies, verticales, et plus encore.
Mêmes filtres que Expansion Search — `froms` / `tos`, étapes, portées, dynamique, fraîcheur et types de signaux.
Les filtres d'enrichissement des personnes (niveaux de management, départements, intitulés) suivent la même structure que le point de terminaison [People Search](/fr/api-reference/endpoint/people/search).
***
## Étapes suivantes
Connectez vos systèmes pour recevoir des données en temps réel.
Fréquence, fiabilité de livraison et gestion des échecs.
Tutoriels complets company\_first et signal\_first avec code copiable.
Accédez à la référence du point de terminaison Create Monitor.