# Obtenir par ID

L'opération Obtenir Personne par ID récupère toutes les informations d'un enregistrement de personne spécifique, en utilisant son identifiant unique (`personId`).

Cette action est l'une des plus utilisées dans les automatisations, car elle permet de charger les données d'un contact connu pour les utiliser dans les étapes suivantes, comme personnaliser un message, prendre des décisions basées sur ses données (ex : statut du client) ou simplement vérifier ses informations.

Le résultat de cette opération est un objet complet contenant tous les champs de la personne, y compris les champs personnalisés.

#### Comment configurer

1. Dans Hablla Studio, ajoutez le bloc "Personnes" à votre flux d'automatisation.
2. Dans le champ "Opération", sélectionnez l'option "Obtenir par ID".
3. Dans le champ « ID de la Personne » (`personId`), saisissez l'identifiant unique de la personne que vous souhaitez consulter. Cette valeur est généralement obtenue à partir d'un déclencheur ou d'une étape précédente du flux.

***

### Paramètres

| Champ                              | Type              | Obligatoire ? | Description                                                                                                                                                                             |
| ---------------------------------- | ----------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID de la Personne                  | Texte             | ✅ Oui         | L'ID unique de la personne à consulter.                                                                                                                                                 |
| Remplir les données de la personne | Booléen (Oui/Non) | ❌ Non         | S'il est défini sur `true`, la recherche peut renvoyer des données liées supplémentaires, comme des informations détaillées sur des organisations ou d'autres enregistrements associés. |

Exporter vers les Feuilles

***

### Structure de la sortie (Exemple de résultat)

Après l'exécution, le résultat de ce bloc sera un objet JSON avec la structure ci-dessous, qui peut être accessible dans des étapes suivantes (ex : `{{steps.1.result}}`):

JSON

```
{
  "id": "person_abcdef123456",
  "name": "Juliana Souza",
  "about": "Responsable Marketing chez Entreprise Exemple.",
  "photo_url": "https://example.com/juliana.jpg",
  "privacy": "granted",
  "customer_status": "customer",
  "is_blocked": false,
  "created_at": "2023-10-26T10:00:00Z",
  "updated_at": "2024-08-16T15:30:00Z",
  "users": [
    {
      "id": "user_xyz789",
      "name": "Carlos Andrade"
    }
  ],
  "phones": [
    {
      "type": "business",
      "phone": "+5511977775555",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "juliana.souza@example.com"
    }
  ],
  "custom_fields": {
    "data_ultima_reuniao": "2024-08-10",
    "nivel_satisfacao": "Très satisfaite"
  }
}
```

***

### 🚀 Exemple de cas d'utilisation

Objectif : Envoyer un e-mail de bienvenue personnalisé à un nouveau client dès qu'une affaire est marquée comme "Gagnée".

1. Créez un flux avec le déclencheur "Carte déplacée", configuré pour l'étape "Gagnée" de votre pipeline de vente. Le déclencheur fournira le `cardId` et le `personId` associé.
2. Ajoutez le bloc "Personnes" avec l'opération "Obtenir par ID".
3. Dans le champ "ID de la Personne", insérez la variable correspondante du déclencheur (ex : `{{trigger.person.id}}`).
4. Ajoutez un bloc d'envoi d'e-mail à l'étape suivante.
5. Dans le corps de l'e-mail, personnalisez la salutation en utilisant les données obtenues à l'étape précédente. Par exemple : "Bonjour, `{{steps.2.result.name}}`! Bienvenu(e) dans notre entreprise."

De cette manière, vous utilisez les données en temps réel de la personne pour créer une communication beaucoup plus personnelle et efficace, de façon entièrement automatisée.