> ## Documentation Index
> Fetch the complete documentation index at: https://support.lumicoda.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer des contacts via des liens personnalisés

> Automatisez la saisie de vos membres en générant des URLs pré-remplies pour faciliter les intégrations avec vos outils externes.

La page de **Création par URL** est une fonctionnalité avancée de Tiiva qui permet de pré-remplir automatiquement le formulaire de nouveau contact en utilisant des paramètres passés dans l'adresse web. Cet outil est particulièrement utile pour créer des liens de saisie rapide depuis un e-mail, un site partenaire ou un outil de gestion externe.

## 1. Comment construire une URL de création ?

Le principe consiste à ajouter des paires "clé=valeur" à la fin de l'adresse de la page de création.

### L'adresse de base

L'URL de base se présente sous cette forme :
`https://tiiva.ch/ORGANISATION/admin/contacts/create-by-url`

### Ajouter des paramètres

Pour pré-remplir les champs, ajoutez un point d'interrogation `?` suivi des champs souhaités.
**Exemple** : `.../create-by-url?first_name=Marc&last_name=Dupont&email=m.dupont@exemple.com`

***

## 2. Champs supportés

Vous pouvez pré-remplir quasiment l'intégralité de la fiche contact. Voici les paramètres les plus courants :

* **Identité** : `first_name`, `last_name`, `gender` (m/f/x), `birthday` (format AAAA-MM-JJ).
* **Contact** : `email`, `phone`.
* **Adresse** : `address`, `postal_code`, `locality`, `country_code` (ex: CH, FR).
* **Technique** : `licence_id`, `iban`, `note`.

***

## 3. Sécurité et protection contre les doublons

Même en utilisant une URL automatique, Tiiva protège l'intégrité de votre base de données grâce à deux mécanismes de sécurité intégrés.

### Détection de similarité en temps réel

Dès que les champs Nom et Prénom sont détectés dans l'URL, la page effectue une recherche de doublons en arrière-plan.

* Si des contacts similaires existent déjà, une alerte s'affiche avec un lien direct vers leurs fiches d'édition.
* **Action recommandée** : Ne validez pas la création si le membre est déjà présent ; cliquez simplement sur le lien du contact existant pour le mettre à jour.

### Annulation de création (Undo)

Après avoir cliqué sur le bouton "Créer", une notification de succès apparaît avec un bouton **Annuler**.

* Si vous réalisez que vous avez fait une erreur de saisie ou créé un doublon par inadvertance, cliquez immédiatement sur "Annuler".
* Tiiva supprimera instantanément la fiche que vous venez de générer.

***

## 4. Cas d'usage types

<CardGroup cols={2}>
  <Card title="Lien de parrainage" icon="link">
    Créez un lien sur votre site web "Devenir membre" qui pré-remplit déjà le groupe "Candidats" pour faciliter le tri administratif.
  </Card>

  <Card title="Migration manuelle" icon="file-import">
    Utilisez des formules Excel pour générer des listes de liens cliquables à partir d'un vieux fichier, permettant une vérification humaine rapide avant chaque création.
  </Card>
</CardGroup>

<Info>
  **Note technique** : Les paramètres d'URL doivent être "encodés". Si une valeur contient des espaces ou des caractères spéciaux (ex: "Rue de l'Église"), assurez-vous que votre outil générateur remplace les espaces par `%20` pour garantir la lecture par le navigateur.
</Info>