> 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/creer.md).

# Créer

L'opération Créer une Personne permet d'enregistrer un nouvel individu (comme un lead, un client ou un contact) dans votre base Hablla. Cette action est essentielle pour centraliser les informations de contact et démarrer la gestion de la relation via des automatisations.

Lors de la création d'une personne, vous pouvez spécifier toutes ses données principales, telles que le nom, le statut client, les informations de contact et les champs personnalisés, garantissant que l'enregistrement naisse déjà complet et prêt à être utilisé dans d'autres 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 "Créer".
3. Choisissez comment vous souhaitez fournir les données : "Utiliser les champs" pour l'interface visuelle ou "Utiliser JSON" pour plus de flexibilité.

***

### Paramètres (En utilisant des Champs)

Ci-dessous se trouvent tous les champs disponibles lors de la configuration de la création d'une nouvelle personne.

| Champ                     | Type                   | Obligatoire ? | Description                                                                                                                                                                              |
| ------------------------- | ---------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nom                       | Texte                  | ✅ Oui         | Le nom complet de la personne.                                                                                                                                                           |
| À propos                  | Texte Long             | ❌ Non         | Un champ ouvert pour des notes ou une biographie sur la personne.                                                                                                                        |
| URL de la Photo de Profil | Texte                  | ❌ Non         | Le lien vers l'image de profil de la personne.                                                                                                                                           |
| Confidentialité           | Liste d'Options        | ✅ Oui         | Définit la base légale du contact. Options : `inconnu`, `granted`, `interest`, `pré-existant`, `juridique`, `protection`, `public`.                                                      |
| Statut du client          | Liste d'Options        | ✅ Oui         | Classe la personne dans l'entonnoir de vente. Options : `visitor`, `lead`, `lead_qualifié_marketing`, `lead_qualifié_commercial`, `opportunité`, `customer`, `évangeliste`, `ex_client`. |
| Responsable (Owner)       | Liste des Utilisateurs | ❌ Non         | Permet d'associer un ou plusieurs utilisateurs de la plateforme comme responsables de cette personne.                                                                                    |
| Téléphones                | Collection de Champs   | ❌ Non         | Une liste d'un ou plusieurs téléphones associés. Chaque téléphone doit contenir : `Type` (Personnel ou Professionnel), `Téléphone` (le numéro) et `Est-ce WhatsApp ?` (oui/non).         |
| E-mails                   | Collection de Champs   | ❌ Non         | Une liste d'une ou plusieurs adresses e-mail.                                                                                                                                            |
| Adresses                  | Collection de Champs   | ❌ Non         | Une liste d'adresses. Chaque adresse peut contenir : `Code postal`, `Pays`, `Rue`, `Numéro`, `Complément`, `Quartier`, `Ville` et `État/province`.                                       |
| Champs Personnalisés      | Clé-Valeur             | ❌ Non         | Permet de remplir les champs personnalisés qui ont été créés sur la plateforme pour l'entité "Personne".                                                                                 |

Exporter vers les Feuilles

***

### Structure (Utilisation de JSON)

Pour les utilisateurs avancés, il est possible de fournir toutes les données dans un seul objet JSON. Voici la structure de base :

JSON

```
{
  "name": "João da Silva",
  "about": "Lead intéressé par le produit X. Venu de la campagne marketing d'août.",
  "photo_url": "https://example.com/photo.jpg",
  "privacy": "granted",
  "customer_status": "lead",
  "users": [
    "user_id_1",
    "user_id_2"
  ],
  "phones": [
    {
      "type": "personal",
      "phone": "+5511999998888",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "joao.silva@example.com"
    }
  ],
  "addresses": [
    {
      "zip_code": "01001-000",
      "country": "Brésil",
      "street": "Praça da Sé",
      "number": "100",
      "complement": "Côté A",
      "neighborhood": "Sé",
      "city": "São Paulo",
      "state": "SP"
    }
  ],
  "custom_fields": {
    "origem_do_lead": "Site web",
    "score": 50
  }
}
```

***

### 🚀 Exemple de cas d'utilisation

Objectif : Enregistrer un nouveau lead dans Hablla chaque fois qu'un formulaire "Demander une démonstration" est rempli sur le site.

1. Créez un déclencheur dans votre flux qui reçoit les données du formulaire via Webhook.
2. Ajoutez le bloc "Personnes" et sélectionnez l'opération "Créer".
3. Mappez les champs reçus du formulaire aux paramètres de l'action "Créer une Personne" :
   * `Nom` ← `dados.webhook.nome`
   * `E-mails` ← `dados.webhook.email`
   * `Téléphones` ← `dados.webhook.telefone`
4. Définissez une valeur fixe pour le champ Statut du Client comme `"lead"`.
5. Associez un utilisateur spécifique dans le champ Responsable afin qu'il reçoive la notification du nouveau lead.

Ainsi, à chaque nouvel envoi du formulaire, une nouvelle personne sera créée automatiquement sur la plateforme, avec le statut et le responsable déjà définis, prête pour que l'équipe commerciale agisse.


---

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