Comment mettre en place une surveillance d’entreprise par Email ou par API/Webhook étape par étape ?

publié le

9/1/2023

 Comment mettre en place une surveillance d’entreprise par Email ou par API/Webhook étape par étape ?

Ne manquez aucune mise à jour de vos fiches clients ou prospects grâce aux notifications par email de la surveillance des entreprises. Suivez notre guide étape par étape pour configurer ces notifications via l'interface d'API Swagger de manière simple et rapide.

Societeinfo propose un service de détection des changements des entreprises françaises. Ce service se nomme Sentinelle et est accessible actuellement via l’interface d’API Swagger.

La surveillance se base sur le numéro SIREN, identifiant unique des entreprises françaises. Vous devez donc connaître le numéro SIREN des entreprises que vous souhaitez surveiller. Cette information est disponible facilement sur Societeinfo.com, vous pouvez également nous contacter si vous avez besoin d’aide.

Pour utiliser la surveillance d’entreprise, vous devez avoir un compte avec suffisamment de crédits.

Suivez ce guide pour savoir comment activer la surveillance ! 👇

Comment se connecter à Swagger ?


Pour créer une Sentinelle, il faut tout d’abord se connecter à Societeinfo.com puis récupérer sa clé d’API.

Une fois sa clé d’API obtenue, il faut se rendre sur Swagger qui est l’interface de l’API de surveillance Societeinfo. Chaque endpoint correspond à une fonctionnalité.

Cliquer sur Authorize pour se connecter.


Renseigner la clé d’API, puis cliquer sur Authorize.

Si le cadenas du bouton Authorize est fermé, c'est bon, vous êtes bien connecté ! 👌

Comment créer une surveillance ?


Une Sentinelle est un service qui surveille les changements au sein d’une liste d’entreprise (à définir à l’étape suivante).

Une fois connecté à Swagger, il faut utiliser le service suivant


Pour ouvrir la configuration, il faut cliquer sur Try it out.


Ensuite, renseigner un nom de Sentinelle. Par exemple “demo_adrien” et cliquer sur Execute. La Sentinelle demo_adrien est créée.


Comment ajouter un fichier de SIREN à votre surveillance ?

Créez un fichier avec la liste de SIREN que vous souhaitez surveiller et importer le en suivant ces étapes.

Il faut se rendre sur le service suivant

Ensuite, cliquer sur Try it out pour accéder à la configuration, remplir le nom de la Sentinelle et choisir le fichier à importer.

Remplir le nom de la Sentinelle dans laquelle ajouter les SIREN, ici, "demo_adrien"

Cliquer sur Choose file pour sélectionner votre fichier de SIREN

Enfin, cliquer sur Execute pour importer la liste d’entreprises à surveiller.


[Optionel] Comment ajouter un SIREN unique à votre surveillance ?

Il faut se rendre sur le service suivant


Ensuite cliquer sur Try it out pour accéder à la configuration.

Remplir le nom de la Sentinelle dans laquelle ajouter les SIREN, ici, "demo_adrien", ainsi que les SIREN à ajouter. Pour ajouter plusieurs SIREN, les séparer d’une virgule “,”.

Enfin, cliquer sur Execute pour ajouter les SIREN à la liste de surveillance.

[Optionnel] Quelles sont les propriétés disponibles à la surveillance ?


Societeinfo détecte des changements sur plus de 50 propriétés d’entreprise à travers quatre grandes catégories :

LEGAL : les informations légales de l’entreprise. Exemples : le nom commercial, le codeNAF,l’adresse, le capital social…

RISK : les informations liées au risque de l’entreprise, risque de défaut de paiement.

FINANCIAL : les données financières. Exemple : chiffre d’affaires déclaré, effectifs de l’entreprise déclarés.

PUBLICATIONS : des publications dans la presse (prise de participation, Nomination dans l'équipe de direction…), dans le BODACC (jugements et procédures collectives…) et des Actes et statuts (augmentation de capital…).

Pour consulter toutes les propriétés, utilisez le service suivant

[Optionnel] Comment configurer les propriétés à surveiller ?


Par défaut, toutes les propriétés de surveillance sont activées, mais vous pouvez définir vous-même vos propres propriétés d’entreprise à surveiller.

Pour définir vos propriétés, utilisez le service suivant

Cliquer sur Try it out, remplir le nom de la Sentinelle à configurer puis les catégories de changement à surveiller.

Par exemple, si vous souhaitez uniquement recevoir des notifications en cas de changement d'adresse ou changements de chiffre d'affaires, copier-coller cette chaîne de caractères :

LEGAL/LEGAL_ADRESSE/LEGAL_ADRESSE_SIEGE,FINANCIAL/FINANCIAL_SALES

Comment recevoir des notifications de surveillance par email ?


Il faut se rendre sur le service suivant


Cliquer sur Try it out, remplir le nom de la Sentinelle puis ajouter la où les adresses email sur lesquelles vous voulez recevoir les notifications et cliquer sur Execute pour valider

Comment activer la surveillance ?


Une fois les étapes précédentes réalisées (création de la Sentinelle, ajout des SIREN et paramétrage des notifications) vous pouvez activer la Sentinelle.

Pour activer la Sentinelle, il faut se rendre sur le service suivant


Cliquer sur Try it out, remplir le nom de la Sentinel et Execute pour l’activer.


Et voilà ! Vous avez réussi à configurer les notifications de surveillance par email.


Voici un exemple d’email que vous allez recevoir : 👇

Si vous souhaitez arrêter la surveillance, vous pouvez vous rendre sur le service suivant

Rentrer le nom de votre Sentinelle et cliquer sur Execute. La surveillance ne sera plus active.


Vous avez des questions ? N'hésitez pas à contacter notre équipe commerciale. Nous sommes là pour vous aider !