# Connecteur Pipedrive — Dataroia

Enrichit vos **organisations** avec la vérité publique INSEE/INPI/BODACC + alerte
dirigeants, via l'automatisation native Pipedrive. Modèle « le client appelle, le
client écrit » : aucun token ni donnée CRM stockés côté Dataroia.

## Pré-requis
- Pipedrive **Professional ou Enterprise** (HTTP request dans Workflow Automation).
- Un **token API Pipedrive** (Paramètres personnels → API) pour créer les champs.
- Une **clé API Dataroia** (`droia_xxx`).
- Un champ organisation contenant le **SIREN** (ou SIRET).

## Étape 1 — Créer les champs personnalisés (une fois)
Pour chaque entrée de `fields_pipedrive.json`, créez un champ organisation :
```bash
curl -X POST "https://api.pipedrive.com/v1/organizationFields?api_token=VOTRE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Dataroia — Niveau d'\''alerte","field_type":"enum",
       "options":[{"label":"OK"},{"label":"Suspect"},{"label":"Alerte"},{"label":"Invalide"}]}'
```
Notez la **`key`** (hash 40 caractères) renvoyée pour chaque champ : c'est elle
qu'on utilise dans le mapping de l'automatisation.

## Étape 2 — Automatisation d'enrichissement
1. **Paramètres → Automatisations → Nouvelle automatisation.**
2. Déclencheur : *Organisation créée* (ou *mise à jour*, filtre « SIREN renseigné »).
3. Action **HTTP request** :
   - Méthode `POST`, URL `https://api.dataroia.com/api/v1/enrich`
   - En-têtes : `Content-Type: application/json`, `X-API-Key: droia_xxx`
   - Corps : `{ "ids": ["{{organization.siren}}"] }`
4. Action **Update organization** : mappez `{{step2.results.1.<champ>}}` vers la
   `key` du champ correspondant (cf. colonne `map_to` de `fields_pipedrive.json`).
   Ex. `results.1.niveau_alerte` → champ « Dataroia — Niveau d'alerte ».

> Pipedrive indexe les tableaux à partir de 1 : `results.1` = premier (et unique) résultat.

## Vérification décès des personnes (service décès)
L'enrichissement ci-dessus porte sur les **organisations** (SIREN). Pour vérifier le
**statut vital des personnes**, ajoutez une seconde automatisation qui appelle
`POST /api/v1/deces` :
1. Créez les champs **personne** depuis `fields_deces_pipedrive.json` (POST `/v1/personFields`),
   notez chaque `key`.
2. Automatisation **Personne créée/MAJ** → action **HTTP request** :
   `POST https://api.dataroia.com/api/v1/deces`, en-tête `X-API-Key`, corps :
   `{ "personnes": [{ "nom": "{{person.last_name}}", "prenom": "{{person.first_name}}" }] }`
   (ajoutez `date_naissance` / `code_postal` si disponibles pour fiabiliser).
3. Action **Update person** : mappez `{{step2.results.1.statut_vital}}`,
   `…action`, `…date_deces`, `…score_confiance` vers les `key` correspondantes.

> `statut_vital = a_verifier_homonyme` = homonyme possible au registre INSEE, jamais un décès certain.

## Souveraineté / RGPD
- Pipedrive héberge en UE (datacenter Francfort) — vérifiez votre région de compte.
- `Dataroia — Dirigeants à vérifier` = homonyme possible, pas un décès certain.
- Vous restez seul responsable de traitement sur les champs écrits.