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