En résumé : L’API Rodz propose 14 types de signaux d’affaires configurables. Ce guide vous accompagne de A à Z : choix du signal, paramétrage des filtres (secteur, taille, géographie), activation via requête POST, puis vérification. En 15 minutes, votre premier signal sera opérationnel et commencera à détecter des opportunités commerciales en temps réel.
Qu’est-ce qu’une configuration de signal d’affaires ?
Un signal d’affaires est un événement détectable qui indique qu’une entreprise traverse un moment propice à l’achat. Une levée de fonds, une vague de recrutements, un changement de direction : autant d’indicateurs que vous pouvez exploiter pour prospecter au bon moment.
Configurer un signal via l’API Rodz, c’est définir précisément quel type d’événement vous souhaitez surveiller, sur quel périmètre d’entreprises, et avec quels critères de déclenchement. Chaque configuration agit comme un filtre intelligent qui transforme un flux massif d’événements bruts en alertes ciblées et exploitables pour votre équipe commerciale.
Sans configuration, un signal comme “offre d’emploi publiée” génère des milliers de résultats quotidiens. Avec une configuration bien paramétrée, vous ne recevez que les événements pertinents pour votre ICP. Comme l’explique notre article sur les 222 configurations possibles pour un seul signal, la précision du paramétrage fait toute la différence entre du bruit et de l’intelligence commerciale.
Ce guide suppose que vous avez déjà obtenu vos identifiants API et réalisé votre première requête authentifiée. Si ce n’est pas le cas, commencez par le guide de démarrage et d’authentification.
Prérequis
Avant de configurer votre premier signal, assurez-vous d’avoir :
- Un compte Rodz actif avec un accès API activé sur votre espace.
- Votre clé API (
API_KEY) récupérée depuis le dashboard Rodz, comme décrit dans le guide d’authentification. - cURL installé sur votre machine (disponible par défaut sur macOS et Linux, téléchargeable sur Windows).
- Votre ICP défini : secteurs d’activité cibles, tailles d’entreprise, zones géographiques. Sans ICP clair, votre configuration sera trop large ou trop restrictive.
- Une connaissance du type de signal qui correspond à votre offre. La section suivante vous aide à choisir.
Les 14 types de signaux disponibles
L’API Rodz expose 14 types de signaux, chacun correspondant à une catégorie d’événement d’entreprise. Voici la liste complète avec leur identifiant technique et leur cas d’usage principal.
Signaux liés au recrutement
job-offers: Détecte les nouvelles offres d’emploi publiées par une entreprise. Signal classique pour identifier les entreprises en croissance ou en transformation.republished-job-offers: Repère les offres d’emploi republiées, signe que le poste est difficile à pourvoir. Pertinent pour les acteurs du recrutement et du staffing.recruitment-campaign: Identifie les campagnes de recrutement massives (plusieurs postes ouverts simultanément). Indicateur fort de croissance rapide.
Signaux financiers et stratégiques
fundraising: Détecte les levées de fonds annoncées. L’un des signaux les plus puissants car il indique un budget disponible et des projets d’investissement.mergers-acquisitions: Repère les fusions et acquisitions. Ces opérations entraînent des réorganisations, des besoins en intégration et des budgets débloqués.company-registration: Détecte les nouvelles immatriculations d’entreprise. Utile pour cibler les startups et les nouveaux entrants sur un marché.public-tenders: Surveille les appels d’offres publics. Indispensable pour les entreprises qui répondent aux marchés publics.
Signaux de mouvement de personnel
job-changes: Détecte les changements de poste de décideurs clés. Un nouveau directeur commercial ou un nouveau CTO apporte souvent de nouveaux projets et de nouveaux budgets.competitor-relationships: Identifie les relations entre entreprises cibles et vos concurrents (recrutement d’anciens employés, partenariats visibles).
Signaux d’engagement social
company-followers: Suit l’évolution du nombre d’abonnés d’une page entreprise. Une croissance rapide indique une montée en visibilité.social-mentions: Détecte les mentions d’une entreprise sur les réseaux sociaux et médias en ligne.social-reactions: Mesure l’engagement (likes, commentaires, partages) sur les publications d’une entreprise.influencer-engagement: Repère les interactions entre des influenceurs sectoriels et une entreprise cible.company-page-engagement: Analyse l’activité globale d’une page entreprise (fréquence de publication, taux d’engagement moyen).
Étape 1 : choisir votre type de signal
Le choix du signal dépend de votre offre et de votre cycle de vente. Posez-vous deux questions :
Quel problème résolvez-vous ? Si vous vendez un logiciel RH, les signaux job-offers, recruitment-campaign et job-changes sont vos meilleurs alliés. Si vous vendez du conseil en stratégie, fundraising et mergers-acquisitions seront plus pertinents.
Quel est votre timing idéal ? Certains signaux indiquent un besoin immédiat (public-tenders), d’autres un besoin à moyen terme (fundraising, company-registration). Alignez le signal sur votre cycle de vente.
Pour ce tutoriel, nous utiliserons le signal fundraising comme exemple. C’est un signal à forte valeur ajoutée, avec un volume maîtrisable et des résultats rapides.
Étape 2 : définir vos filtres
Les filtres transforment un signal générique en signal ciblé. L’API Rodz supporte trois catégories de filtres.
Filtre par secteur d’activité
Utilisez les codes NAF (Nomenclature d’Activités Française) pour cibler un ou plusieurs secteurs. Vous pouvez spécifier un code précis (62.01Z pour la programmation informatique) ou un code parent (62 pour toutes les activités informatiques).
Filtre par taille d’entreprise
Définissez une fourchette d’effectifs avec les paramètres company_size_min et company_size_max. Exemple : cibler les PME de 50 à 500 salariés.
Filtre géographique
Trois niveaux de granularité sont disponibles :
- Pays : code ISO (
FR,BE,CH) - Région : identifiant de région (
ile-de-france,auvergne-rhone-alpes) - Département : code département (
75,69,33)
Vous pouvez combiner plusieurs valeurs dans chaque filtre. Tous les filtres sont cumulatifs (logique AND entre catégories, logique OR au sein d’une catégorie).
Étape 3 : créer la configuration via l’API
Voici la requête POST pour créer une configuration de signal fundraising ciblant les entreprises tech de 50 à 500 salariés en France.
curl -X POST https://api.rodz.io/v1/signal-configs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"signal_type": "fundraising",
"name": "Levées de fonds - Tech FR 50-500",
"filters": {
"industries": ["62", "63"],
"company_size_min": 50,
"company_size_max": 500,
"countries": ["FR"]
},
"active": true
}'Détail des champs :
| Champ | Type | Description |
|---|---|---|
signal_type | string | Identifiant du signal parmi les 14 types disponibles |
name | string | Nom libre pour identifier votre configuration dans le dashboard |
filters.industries | array | Codes NAF ciblés (niveau 2 ou 5) |
filters.company_size_min | integer | Effectif minimum de l’entreprise |
filters.company_size_max | integer | Effectif maximum de l’entreprise |
filters.countries | array | Codes pays ISO 3166-1 alpha-2 |
filters.regions | array | Identifiants de région (optionnel) |
filters.departments | array | Codes département (optionnel) |
active | boolean | Active ou désactive la configuration immédiatement |
Réponse attendue (201 Created) :
{
"id": "sc_a1b2c3d4e5",
"signal_type": "fundraising",
"name": "Levées de fonds - Tech FR 50-500",
"filters": {
"industries": ["62", "63"],
"company_size_min": 50,
"company_size_max": 500,
"countries": ["FR"]
},
"active": true,
"created_at": "2026-03-05T10:30:00Z",
"updated_at": "2026-03-05T10:30:00Z"
}Conservez l’id retourné. Vous en aurez besoin pour modifier, désactiver ou supprimer cette configuration.
Étape 4 : vérifier vos configurations actives
Pour lister toutes vos configurations de signaux, utilisez la requête GET suivante :
curl -X GET https://api.rodz.io/v1/signal-configs \
-H "Authorization: Bearer YOUR_API_KEY"Réponse attendue (200 OK) :
{
"data": [
{
"id": "sc_a1b2c3d4e5",
"signal_type": "fundraising",
"name": "Levées de fonds - Tech FR 50-500",
"active": true,
"created_at": "2026-03-05T10:30:00Z",
"signals_detected": 0
}
],
"total": 1,
"page": 1,
"per_page": 20
}Le champ signals_detected indique le nombre de signaux captés depuis la création de la configuration. Il passera à zéro au démarrage, puis augmentera au fil des détections.
Vous pouvez aussi récupérer une configuration spécifique par son identifiant :
curl -X GET https://api.rodz.io/v1/signal-configs/sc_a1b2c3d4e5 \
-H "Authorization: Bearer YOUR_API_KEY"Étape 5 : tester et valider votre configuration
Une configuration créée ne produit pas de résultats instantanément. Les signaux sont détectés au fil de l’eau, selon la fréquence de collecte de chaque source. Voici comment valider que tout fonctionne.
Vérifier le statut de la configuration
Assurez-vous que le champ active est bien à true. Une configuration inactive ne génère aucun signal.
Consulter les premiers signaux détectés
Après quelques heures (ou quelques jours selon le type de signal), interrogez l’endpoint des signaux :
curl -X GET "https://api.rodz.io/v1/signals?config_id=sc_a1b2c3d4e5&limit=5" \
-H "Authorization: Bearer YOUR_API_KEY"Cette requête retourne les 5 derniers signaux détectés par votre configuration. Si la liste est vide après 48h, vérifiez que vos filtres ne sont pas trop restrictifs.
Ajuster les filtres si nécessaire
Si vous recevez trop de signaux, resserrez vos filtres (zone géographique plus restreinte, fourchette d’effectifs plus étroite). Si vous n’en recevez pas assez, élargissez-les. Utilisez une requête PATCH pour modifier une configuration existante :
curl -X PATCH https://api.rodz.io/v1/signal-configs/sc_a1b2c3d4e5 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filters": {
"company_size_min": 20,
"company_size_max": 1000
}
}'Seuls les champs envoyés sont modifiés. Les autres filtres restent inchangés.
Étape 6 : passer en production
Une fois votre configuration validée, deux options s’offrent à vous pour exploiter les signaux en continu.
Option A : polling régulier
Interrogez l’endpoint /v1/signals à intervalles réguliers (toutes les heures, par exemple) pour récupérer les nouveaux signaux. Simple à mettre en place, mais moins réactif.
Option B : webhooks (recommandé)
Configurez un webhook pour recevoir chaque signal en temps réel, dès sa détection. C’est l’approche la plus efficace pour alimenter un CRM ou déclencher un workflow automatisé. Consultez notre guide dédié sur la configuration des webhooks Rodz pour la mise en place.
Bonnes pratiques de configuration
Commencez simple. Créez une seule configuration avec des filtres modérés. Analysez les résultats pendant une semaine avant d’ajouter d’autres signaux ou d’affiner les critères.
Nommez vos configurations clairement. Le champ name est libre. Utilisez un format descriptif : [Type de signal] - [Cible] [Zone]. Exemple : Fundraising - SaaS FR 50-500. Quand vous aurez 10 configurations actives, vous apprécierez la lisibilité.
Combinez plusieurs signaux. Un seul type de signal ne suffit pas à couvrir tout votre périmètre d’opportunités. Créez des configurations complémentaires : fundraising pour détecter les budgets, job-offers pour repérer les croissances, job-changes pour identifier les nouveaux décideurs.
Surveillez le volume. Si une configuration génère plus de 100 signaux par jour, vos filtres sont probablement trop larges. Si elle en génère moins de 5 par semaine, ils sont trop restrictifs. Visez un volume que votre équipe peut traiter.
Utilisez les tags. Associez des tags à vos configurations pour les organiser par campagne, par commercial ou par segment de marché. Cela facilite le reporting et le suivi.
Questions fréquentes
Combien de configurations de signaux puis-je créer ?
Le nombre de configurations dépend de votre plan Rodz. Les plans standard permettent jusqu’à 20 configurations actives simultanément. Les plans entreprise offrent un nombre illimité de configurations. Consultez votre espace client ou contactez l’équipe Rodz pour connaître votre quota.
Puis-je combiner plusieurs types de signaux dans une seule configuration ?
Non. Chaque configuration est associée à un seul type de signal. Pour surveiller plusieurs types d’événements, créez une configuration par type. Cette approche vous donne un contrôle granulaire sur les filtres de chaque signal et facilite l’analyse des résultats.
Les filtres sont-ils obligatoires ?
Techniquement, non. Vous pouvez créer une configuration sans filtre, mais c’est déconseillé. Une configuration sans filtre sur le signal job-offers générerait des milliers de résultats quotidiens. Les filtres sont ce qui transforme un flux d’événements en intelligence commerciale exploitable.
Quel délai entre la création d’une configuration et la réception du premier signal ?
Cela dépend du type de signal et de vos filtres. Les signaux à volume élevé comme job-offers produisent des résultats en quelques heures. Les signaux plus rares comme mergers-acquisitions ou fundraising peuvent nécessiter plusieurs jours avant la première détection. Ne modifiez pas vos filtres trop vite, laissez au moins 48 heures avant d’ajuster.
Comment désactiver temporairement une configuration sans la supprimer ?
Envoyez une requête PATCH avec "active": false :
curl -X PATCH https://api.rodz.io/v1/signal-configs/sc_a1b2c3d4e5 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"active": false}'La configuration est conservée avec tous ses paramètres. Réactivez-la à tout moment en passant active à true.
Puis-je dupliquer une configuration existante ?
L’API ne propose pas de duplication native. Récupérez la configuration existante via GET, modifiez les champs souhaités, puis créez une nouvelle configuration via POST avec les paramètres ajustés. C’est la méthode la plus fiable.
Les signaux détectés avant la création d’une configuration sont-ils disponibles rétroactivement ?
Non. Une configuration ne détecte que les événements survenus après son activation. Si vous avez besoin de données historiques, consultez l’endpoint /v1/signals/history qui permet de rechercher des signaux passés selon des critères similaires. Consultez la référence API complète pour les détails de cet endpoint.
Quelle est la différence entre job-offers et recruitment-campaign ?
Le signal job-offers se déclenche pour chaque offre d’emploi individuelle publiée. Le signal recruitment-campaign se déclenche lorsqu’une entreprise publie plusieurs offres simultanément (le seuil est configurable). Si vous cherchez à identifier les entreprises en forte croissance, recruitment-campaign est plus pertinent car il filtre le bruit des recrutements isolés.
Pour aller plus loin
Votre premier signal est configuré. Voici les prochaines étapes pour tirer le maximum de l’API Rodz :
- Recevez vos signaux en temps réel en configurant des webhooks. Plus besoin de polling, les signaux arrivent directement dans votre système.
- Maîtrisez tous les endpoints avec la référence API complète : limites de débit, gestion des erreurs, pagination.
- Explorez la documentation interactive sur api.rodz.io/docs pour tester vos requêtes directement depuis le navigateur.
Vous avez des questions sur la configuration de vos signaux ? Contactez l’équipe Rodz pour un accompagnement personnalisé.