watch_company
Mise sous surveillance d'une société : l'ajoute à une liste de veille de l'utilisateur, visible dans l'app Insourcia (page /lists).
Utiliser cet outil quand l'utilisateur veut SUIVRE une société dans le temps (cible d'acquisition, concurrent, client, fournisseur à risque) - pas pour une simple consultation (utiliser get_company).
Fonctionnement :
list_name désigne la liste cible ; la liste "Surveillance" est utilisée par défaut et créée automatiquement si besoin (idem pour toute liste nommée qui n'existe pas encore).
Idempotent : si la société est déjà dans la liste, l'appel renvoie already_watched=true sans créer de doublon.
Alerte quotidienne ACTIVE PAR DÉFAUT quand la liste est créée par cet appel (enable_alert=false pour s'en passer ; sur une liste existante, enable_alert=true l'active) : l'utilisateur est notifié des événements FUTURS touchant les sociétés de la liste (annonces BODACC : procédures collectives, cessions... et changements de dirigeants). Pas de replay de l'historique.
Réponse : { siren, company_name (null si non renseignée), list_id, list_name, url (page /lists), already_watched, alert_enabled }.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| siren | Yes | SIREN a 9 chiffres de la société à surveiller | |
| list_name | No | Nom de la liste cible (1-100 caractères). Par défaut : "Surveillance". La liste est créée automatiquement si elle n'existe pas. | |
| enable_alert | No | Alerte quotidienne sur les événements futurs (BODACC, dirigeants...) des sociétés de la liste. Par défaut : true si la liste est créée par cet appel, inchangé sinon. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| siren | Yes | ||
| list_id | Yes | ||
| list_name | Yes | ||
| company_name | Yes | ||
| alert_enabled | Yes | ||
| already_watched | Yes |