# Connecteur HubSpot — Dataroia

Enrichit vos fiches **société** avec la vérité publique INSEE/INPI/BODACC + alerte
dirigeants. Modèle « le client appelle, le client écrit » : **votre** portail appelle
l'API Dataroia et écrit dans **vos** propriétés. Dataroia ne stocke aucun token ni
aucune donnée de votre CRM.

## Pré-requis
- Un compte **Operations Hub Pro** (action « code personnalisé » dans les workflows).
- Une **private app** HubSpot avec le scope `crm.schemas.companies.write` (création des propriétés).
- Une **clé API Dataroia** (`droia_xxx`) fournie par Dataroia.
- Une propriété société contenant le **SIREN** (ou SIRET). À créer si absente.

## Étape 1 — Créer les propriétés Dataroia (une fois)
```bash
export HUBSPOT_TOKEN=pat-eu1-xxxxxxxx   # token de la private app
python create_properties_hubspot.py     # lit properties_hubspot.json
```
Crée les 13 propriétés `dataroia_*` dans le groupe « Informations sur l'entreprise ».
Idempotent : relançable sans risque (les existantes sont ignorées).

## Étape 2 — Workflow d'enrichissement
1. **Workflows → Créer → Basé sur les sociétés.**
2. Déclencheur : `SIREN est connu` (ou « Date de création de la société est connue »).
3. Action **Code personnalisé** :
   - Langage **Node.js 18+**.
   - Secret `DATAROIA_API_KEY` = votre clé `droia_xxx`.
   - Propriété à inclure : `siren`.
   - Collez le contenu de **`hubspot_workflow_action.js`**.
   - Déclarez les 13 *données de sortie* `dataroia_*` (types : chaîne, sauf
     `dataroia_nb_dirigeants` / `dataroia_score_confiance` = nombre).
4. Action **Définir une valeur de propriété** (×13) : mappez chaque donnée de sortie
   vers la propriété `dataroia_*` correspondante.

## Étape 3 — Réenrichissement périodique (optionnel)
Dupliquez le workflow en mode « réinscription » avec un déclencheur planifié
(ex. `Dataroia — Date de vérification` antérieure à 90 jours) pour rafraîchir
les fiches dormantes — utile pour capter une procédure collective récente.

## Vérification décès des contacts (service décès)
L'enrichissement ci-dessus porte sur les **sociétés** (SIREN). Pour vérifier le
**statut vital des personnes** (contacts), ajoutez un second flux qui appelle
`POST /api/v1/deces` :
1. Créez les propriétés contact : `python create_properties_hubspot.py properties_deces_hubspot.json`
   (scope `crm.schemas.contacts.write`) → `dataroia_statut_vital`,
   `dataroia_deces_action`, `dataroia_deces_date`…
2. **Workflow basé sur les contacts** → action **Code personnalisé** : collez
   `hubspot_deces_action.js`, secret `DATAROIA_API_KEY`, mappez les entrées
   `nom ← lastname`, `prenom ← firstname`, `date_naissance ← date_of_birth`
   (optionnel), `code_postal ← zip` (optionnel).
3. Mappez les sorties `dataroia_*` vers les propriétés contact correspondantes.

> `dataroia_statut_vital = a_verifier_homonyme` = homonyme possible au registre
> INSEE, **jamais** un décès certain — à confirmer avant toute action.

## Souveraineté / RGPD
- Choisissez un portail HubSpot **hébergé UE** (token `pat-eu1-...`).
- `dataroia_dirigeants_a_verifier` = **homonyme possible** au registre décès, jamais
  un décès certain : à confirmer avant toute action commerciale.
- Vous restez seul responsable de traitement sur les champs écrits dans votre CRM.