# Obtenir par e-mail

L'opération Obtenir une Personne par E-mail localise un enregistrement de personne dans votre base de contacts en utilisant une adresse e-mail comme critère de recherche.

Cette action est cruciale pour les intégrations avec des plateformes où l'e-mail est l'identifiant principal, comme les outils d'automatisation marketing, les systèmes d'e-commerce, les formulaires de site et les plateformes de support par e-mail.

Si un contact avec l'e-mail exact est trouvé, l'opération renvoie l'objet complet de la personne, vous permettant d'utiliser ses données dans les étapes suivantes du flux.

#### 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 E-mail".
3. Dans le champ "E-mail" (`email`), saisissez l'adresse e-mail que vous souhaitez utiliser pour la recherche. Cette valeur peut être un texte fixe ou, plus couramment, une variable provenant d'un déclencheur.

***

### Paramètres

| Champ            | Type  | Obligatoire ? | Description                                         |
| ---------------- | ----- | ------------- | --------------------------------------------------- |
| E-mail (`email`) | Texte | ✅ Oui         | L'adresse e-mail exacte de la personne à localiser. |

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

Si une personne est trouvée, le résultat sera un objet JSON complet, identique à celui renvoyé par les autres opérations de recherche.

JSON

```
{
  "id": "person_ghijkl789012",
  "name": "Ana Clara Costa",
  "customer_status": "customer",
  "is_blocked": false,
  "created_at": "2023-09-20T09:15:00Z",
  "phones": [
    {
      "type": "personal",
      "phone": "+5521988887777",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "ana.costa@example.com"
    }
  ]
}
```

***

### 🚀 Exemple de cas d'utilisation

Objectif : Lorsqu'un client ouvre un ticket de support via un formulaire sur le site, rechercher son enregistrement dans Hablla pour vérifier s'il est client du plan "Premium" et, le cas échéant, prioriser son assistance.

1. Créez un flux qui commence par un déclencheur Webhook, recevant les données du formulaire de support (y compris l'e-mail du client).
2. Ajoutez le bloc "Personnes" avec l'opération "Obtenir par E-mail".
3. Dans le champ "E-mail", insérez la variable de l'e-mail provenant du déclencheur (`{{trigger.body.email}}`).
4. Ajoutez un bloc de Condition (If) pour vérifier la valeur du champ personnalisé `plan` dans le résultat de la recherche : `{{steps.2.result.custom_fields.plano}}` est égal à `Premium`.
   * Si Oui : Ajoutez une étape pour créer le ticket dans la plateforme de support avec la priorité "Urgent".
   * Si Non : Créez le ticket avec la priorité "Normal".

Avec cette automatisation, vous utilisez les données que vous possédez déjà sur vos clients pour offrir un service différencié et plus efficace, sans aucun effort manuel.


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.