> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/hablla/personnes/obtenir-par-id.md).

# 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/hablla/personnes/obtenir-par-id.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.