snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -0,0 +1,30 @@
---
title: Agents IA
description: Intégrez des capacités d'IA directement dans vos flux de travail d'automatisation.
---
## Vue d'ensemble
Intégrez des capacités d'IA directement dans vos flux de travail d'automatisation pour un traitement des données intelligent et une prise de décision intelligente.
## Capacités
| Fonctionnalité | Description |
| ------------------------------ | ----------------------------------------------------------------------- |
| **Actions d'IA** | Ajoutez des étapes alimentées par l'IA à n'importe quel flux de travail |
| **Enrichissement des données** | Améliorez automatiquement les enregistrements avec des données externes |
| **Classification** | Catégorisez les enregistrements en fonction de l'analyse du contenu |
| **Synthèse** | Générez des résumés à partir de champs de texte |
| **Prompts personnalisés** | Définissez précisément comment l'IA traite vos données |
## Cas d'utilisation
* **Scoring des prospects** : Attribuez automatiquement un score et hiérarchisez les prospects entrants
* **Nettoyage des données** : Normalisez les noms d'entreprise et les coordonnées
* **Brouillons d'e-mails** : Générez des e-mails de suivi à partir de notes de réunion
* **Routage des enregistrements** : Assignez les enregistrements au bon membre de l'équipe en fonction du contenu
## Articles connexes
* [Vue d'ensemble des flux de travail](/l/fr/user-guide/workflows/overview) — les bases de l'automatisation
* [Autorisations de l'IA](/l/fr/user-guide/ai/capabilities/permissions-access-control) — contrôle d'accès pour les agents IA

View File

@@ -0,0 +1,37 @@
---
title: Chatbot IA
description: Un assistant intelligent qui vous aide à interagir avec vos données CRM en langage naturel.
---
## Vue d'ensemble
Posez des questions en langage naturel et l'assistant récupère et explique vos données CRM pour vous.
## Capacités
| Fonctionnalité | Description |
| ------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Requêtes en langage naturel** | Posez des questions en anglais simple plutôt que de créer des filtres |
| **Accès complet aux données** | Interrogez des enregistrements, des relations et des indicateurs dans tout votre espace de travail |
| **Contexte de la page** | Faites référence à "cette entreprise" ou "cette opportunité" en fonction de votre vue actuelle |
| **Conversationnel** | Les questions de suivi conservent le contexte des requêtes précédentes |
## Exemples d'interactions
### Recherche d'enregistrements
* "Montrez-moi toutes les opportunités supérieures à 50 000 $"
* "Trouvez les contacts à qui je n'ai pas envoyé d'e-mail depuis 2 semaines"
* "Répertoriez les entreprises du secteur de la santé"
### Obtenir des informations
* "Quelle est la valeur totale de mon pipeline ?"
* "Combien d'affaires ont été conclues le mois dernier ?"
* "Quelle étape compte le plus d'opportunités bloquées ?"
### Utiliser le contexte de la page
* "Résumez mes interactions avec cette personne" (sur une page de contact)
* "Quelles opportunités sont liées à cette entreprise ?" (sur une page d'entreprise)
* "Quand cette affaire a-t-elle été mise à jour pour la dernière fois ?" (sur une page d'opportunité)

View File

@@ -0,0 +1,137 @@
---
title: Serveur MCP
description: Connectez des assistants IA à votre espace de travail Twenty à l'aide du Model Context Protocol.
---
Twenty expose un serveur [MCP](https://modelcontextprotocol.io/) afin que les assistants IA — Claude Desktop, Claude Code, Cursor, ChatGPT et autres — puissent lire et écrire vos données CRM en langage naturel.
Utilisez l'**URL de votre espace de travail** (l'URL que vous utilisez pour accéder à Twenty) comme point de terminaison MCP. Sur Twenty Cloud, l'URL de votre espace de travail peut être `https://{mycompany}.twenty.com` ou un domaine personnalisé. Le serveur est disponible à l'adresse :
| Environnement | Point de terminaison MCP |
| ---------------- | ----------------------------------------------------------------------------------- |
| **Cloud** | `https://{your-workspace-url}/mcp` (par exemple `https://mycompany.twenty.com/mcp`) |
| **Auto-hébergé** | `https://{your-domain}/mcp` |
## Méthodes d'authentification
Vous disposez de deux moyens d'authentifier votre client MCP : **OAuth** (recommandé) ou **clé API**.
### Option A — OAuth (recommandé)
Avec OAuth, votre client MCP ouvre une fenêtre de navigateur pour que vous puissiez vous connecter. Aucun secret n'est stocké dans les fichiers de configuration et les jetons se renouvellent automatiquement.
<Note>
OAuth nécessite un client MCP qui prend en charge la [spécification MCP Authorization](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). Claude Desktop, Claude Code, Cursor et ChatGPT la prennent en charge.
</Note>
Ajoutez ceci à la configuration de votre client MCP, en remplaçant `{your-workspace-url}` par l'hôte de votre espace de travail (par exemple `mycompany.twenty.com`) :
```json
{
"mcpServers": {
"twenty": {
"type": "streamable-http",
"url": "https://{your-workspace-url}/mcp"
}
}
}
```
Et voilà — aucune clé API n'est nécessaire. Lorsque le client se connecte pour la première fois, il va :
1. Découvrir les métadonnées OAuth de Twenty via `/.well-known/oauth-protected-resource` et `/.well-known/oauth-authorization-server`
2. S'enregistrer comme client OAuth via l'enregistrement dynamique de client (RFC 7591)
3. Ouvrir votre navigateur pour autoriser l'accès
4. Recevoir des jetons et se connecter au serveur MCP
Les connexions suivantes réutilisent les jetons stockés et les actualisent automatiquement.
### Option B — Clé API
Si votre client MCP ne prend pas en charge OAuth, ou si vous préférez des identifiants statiques, transmettez une clé API dans l'en-tête `Authorization` :
```json
{
"mcpServers": {
"twenty": {
"type": "streamable-http",
"url": "https://{your-workspace-url}/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
<Warning>
Votre clé API donne accès aux données de votre espace de travail. Ne l'ajoutez pas au contrôle de version et évitez de la placer dans des fichiers de configuration partagés.
</Warning>
Pour créer une clé API, allez dans **Paramètres → MCP & APIs → API → + Créer une clé**. Voir [APIs](/l/fr/developers/extend/api#create-an-api-key) pour plus de détails.
## Démarrage rapide
### 1. Copiez la configuration
Allez dans **Paramètres → MCP & APIs → MCP** dans Twenty. Choisissez votre méthode d'authentification (OAuth ou clé API), copiez l'extrait JSON (il utilisera déjà l'URL de votre espace de travail) et collez-le dans le fichier de configuration de votre client MCP.
| Client | Emplacement du fichier de configuration |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%APPDATA%\Claude\claude_desktop_config.json` (Windows) |
| **Claude Code** | `~/.claude.json` (utilisateur) ou `.mcp.json` (projet) |
| **Cursor** | `.cursor/mcp.json` dans votre projet, ou `~/.cursor/mcp.json` globalement |
| **ChatGPT** | Activez le mode Développeur dans **Paramètres → Applications et connecteurs → Paramètres avancés**, puis utilisez **Créer** dans **Paramètres → Applications et connecteurs** pour ajouter le serveur MCP |
### 2. Se connecter
Redémarrez votre client MCP (ou rechargez la configuration). Si vous utilisez OAuth, vous serez redirigé vers Twenty pour autoriser l'accès. Si vous utilisez une clé API, la connexion est immédiate.
### 3. Commencez à l'utiliser
Demandez à votre assistant IA d'interagir avec votre CRM :
* *"Montre-moi les 5 entreprises créées le plus récemment"*
* *"Crée une nouvelle personne nommée Jane Doe chez Acme Corp"*
* *"Trouve toutes les opportunités ouvertes d'une valeur supérieure à 10 000 $"*
## Outils disponibles
Une fois connecté, le serveur MCP expose des outils qui reflètent l'API de Twenty. Le flux de travail recommandé est :
1. **`learn_tools`** — obtenir le schéma d'entrée pour des outils spécifiques
2. **`execute_tool`** — exécuter un outil
Vous n'avez pas besoin de mémoriser les noms des outils. Demandez à votre assistant IA ce qu'il peut faire et il appellera `learn_tools` automatiquement.
## Autorisations
Les connexions MCP héritent des autorisations de l'utilisateur authentifié (OAuth) ou du rôle attribué à la clé API. Pour restreindre ce que le serveur MCP peut faire :
* **OAuth** : Le rôle de l'utilisateur dans l'espace de travail s'applique.
* **Clé API** : Attribuez un rôle à la clé API dans **Paramètres → Membres → Rôles**. Voir [Autorisations](/l/fr/user-guide/permissions-access/capabilities/permissions).
## Configuration auto-hébergée
Pour les instances auto-hébergées, remplacez `{your-workspace-url}` par l'URL de votre serveur. Assurez-vous que `SERVER_URL` dans votre environnement correspond à l'URL publique de votre instance Twenty — cela est utilisé pour générer les métadonnées de découverte OAuth.
```bash
SERVER_URL=https://twenty.yourcompany.com
```
Le point de terminaison MCP, les points de terminaison OAuth et les métadonnées de découverte dérivent tous de cette valeur.
## Résolution des problèmes
**Erreurs "Unauthorized" ou 401**
* OAuth : réautorisez en supprimant les jetons stockés dans votre client MCP puis reconnectez-vous.
* Clé API : vérifiez que la clé est valide et n'a pas expiré. Régénérez-la si nécessaire.
**Le flux OAuth n'ouvre pas de navigateur**
* Assurez-vous que votre client MCP prend en charge MCP Authorization. Si ce n'est pas le cas, revenez à la méthode par clé API.
**Délai d'attente de connexion**
* Confirmez que l'URL du point de terminaison MCP est accessible depuis votre machine. Pour les instances auto-hébergées, vérifiez que le serveur est en cours d'exécution et que `SERVER_URL` est correctement défini.

View File

@@ -0,0 +1,35 @@
---
title: Autorisations et contrôle d’accès
description: Contrôlez ce à quoi les agents IA peuvent accéder et ce qu’ils peuvent modifier dans votre espace de travail.
---
## Vue d'ensemble
Les agents IA respectent votre structure d’autorisations existante. C’est particulièrement important pour les équipes qui veulent contrôler précisément à quoi les processus d’IA automatisés peuvent accéder ou ce qu’ils peuvent modifier dans leur espace de travail.
## Attribuer un Rôle à un Agent IA
1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle que vous souhaitez attribuer
3. Ouvrez l'onglet **Attribution**
4. Sous **Agents IA**, cliquez sur **+ Attribuer à un agent IA**
5. Sélectionnez l’agent IA dans la liste
6. Confirmez l'attribution
## Pourquoi Attribuer des Rôles aux Agents IA ?
| Avantage | Description |
| ---------------- | --------------------------------------------------------------------------------------- |
| **Sécurité** | Limitez les données auxquelles les agents IA peuvent accéder ou qu’ils peuvent modifier |
| **Conformité** | Garantissez que l’IA ne traite que les données dont elle a besoin |
| **Contrôle** | Empêchez les actions involontaires des automatisations d’IA |
| **Auditabilité** | Suivez quelles actions ont été effectuées par chaque agent |
<Note>
Pour les agents IA s’exécutant au sein de flux de travail, l’attribution d’un rôle garantit que l’agent ne peut pas accéder ni modifier des données en dehors de sa portée prévue—même si le flux de travail dispose d’autorisations plus étendues.
</Note>
## Contenu connexe
* [Autorisations](/l/fr/user-guide/permissions-access/capabilities/permissions) — informations détaillées sur la création et la gestion des rôles
* [Agents IA](/l/fr/user-guide/ai/capabilities/ai-agents) — fonctionnalités d’IA dans les flux de travail

View File

@@ -0,0 +1,31 @@
---
title: FAQ sur l'IA
description: Foire aux questions sur les fonctionnalités d'IA dans Twenty.
---
<AccordionGroup>
<Accordion title="Quelles capacités d'IA sont disponibles ?">
Les deux principales capacités de l'IA sont :
1. **AI Chatbot** : Un assistant contextuel capable d'accéder à vos données Twenty et de vous aider avec vos requêtes
2. **Agents IA dans les flux de travail** : Une automatisation intelligente capable de traiter des données, de prendre des décisions et d'exécuter des tâches au sein de vos flux de travail
</Accordion>
<Accordion title="Les agents IA ont-ils accès à toutes mes données ?">
Les agents d’Amnesty International opèrent dans le cadre du système d’autorisation. Vous pouvez attribuer des rôles spécifiques aux agents IA dans **Paramètres → Membres → Rôles**, ce qui vous donne un contrôle total sur les données auxquelles ils peuvent accéder et les actions qu'ils peuvent effectuer.
</Accordion>
<Accordion title="Comment fonctionnent les crédits d'IA ?">
Les actions d'IA consomment des crédits de flux de travail en fonction de la complexité de la tâche et du modèle d'IA utilisé.
</Accordion>
<Accordion title="Puis-je utiliser mes propres modèles d'IA ?">
Sur le cloud, vous pouvez utiliser uniquement les modèles d'IA fournis par Twenty. Sur votre instance auto-hébergée, vous pouvez utiliser vos propres modèles d'IA après avoir obtenu une licence Organization.
</Accordion>
<Accordion title="Je ne vois pas un rôle que j'ai assigné à un agent IA, où est-il?">
Par défaut, la liste des rôles est filtrée pour n’afficher que les rôles attribuables aux membres de l’espace de travail. Si un rôle est assignable uniquement aux agents IA, vous devez modifier le filtre pour inclure les rôles AI-Agent.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,58 @@
---
title: IA
description: Des fonctionnalités alimentées par l'IA dans Twenty.
---
<Frame>
<img src="/images/user-guide/workflows/robot.png" alt="IA" />
</Frame>
## Fonctionnalités
Actuellement, Twenty propose :
### 1. Chatbot IA
Un assistant conversationnel qui comprend votre contexte et a accès à toutes vos données Twenty.
**Fonctionnalités clés :**
* **Accès complet aux données** : Interrogez n'importe quel enregistrement, relation ou indicateur dans votre espace de travail
* **Prise en compte du contexte de la page** : Faites référence à "cette entreprise" ou "cette opportunité" selon l'endroit où vous vous trouvez dans Twenty
* **Langage naturel** : Posez des questions et obtenez des réponses sans parcourir de menus
**Exemples de prompts :**
* "Quelles opportunités se clôturent ce mois-ci ?"
* "Quelles affaires sont en phase de Négociation depuis plus de 30 jours ?"
* "Résume mes interactions avec cette personne"
### 2. Agents IA dans les flux de travail
Étendez vos flux de travail avec des actions alimentées par l'IA et des agents autonomes.
**Fonctionnalités clés :**
* **Actions IA** : Utilisez l'IA pour enrichir les données, classer des enregistrements, générer des résumés, et plus encore
* **Agents autonomes** : Laissez les agents exécuter des tâches en plusieurs étapes au sein d'un flux de travail
* **Prompts personnalisés** : Définissez exactement comment l'IA doit traiter vos données
**Cas d'utilisation :**
* Catégorisez automatiquement les prospects entrants
* Enrichissez les données d'entreprise à partir de sources publiques
* Générez des brouillons d'e-mails de suivi à partir de notes de réunion
* Attribuez un score aux opportunités en fonction des schémas d'engagement
## Autorisations et contrôle d'accès
Les agents IA sont gérés via le système d'autorisations existant :
1. Allez dans **Paramètres → Membres → Rôles**
2. Configurez les données auxquelles chaque agent IA peut accéder
3. Définissez les autorisations de lecture/écriture par objet
Cela garantit que les agents IA respectent vos politiques de gouvernance des données et n'accèdent qu'à ce dont ils ont besoin.
* Suivez notre [GitHub](https://github.com/twentyhq/twenty) pour les mises à jour de développement
* Rejoignez notre [Discord](https://discord.gg/UfGNZJfAG6) pour partager vos retours et vos demandes de fonctionnalités

View File

@@ -0,0 +1,74 @@
---
title: Crédits
description: Un solde unique simple qui alimente vos workflows, vos agents IA et votre chat IA — ce que vaut un crédit, jusqu’où il va, et comment le gérer.
---
## Que sont les crédits ?
Les crédits sont un solde unique qui alimente tout ce que nous faisons fonctionner en votre nom et qui a un coût réel : **automatisations de workflow**, **agents IA** et **chat IA**. Au lieu de jongler avec des quotas distincts pour les "exécutions d’automatisation" et les "jetons IA", vous disposez d’un solde unique simple à surveiller.
**1 crédit = 1 $ d’utilisation.** Un crédit est simplement un dollar de travail, donc votre solde est facile à comprendre — aucune unité abstraite à convertir.
## Jusqu'où va un crédit ?
Le coût augmente avec le volume de travail. Les automatisations quotidiennes et les messages IA rapides coûtent une infime fraction d’un crédit ; les tâches importantes d’agent IA en plusieurs étapes coûtent davantage. Voici l’ordre de grandeur approximatif :
| Ce que vous faites | Coût approximatif | Ce que cela signifie |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- | -------------------------------------- |
| Exécuter une étape standard de workflow (recherche, création, mise à jour d'enregistrements) ou déclencher la fonction logique d'une application | $0.0001 | **10 000 exécutions par crédit** |
| Appeler une API externe ou exécuter un nœud de code | Une petite fraction d’un crédit | Des milliers par crédit |
| Envoyer un message de chat IA rapide ou une étape IA simple | Une fraction de centime | Des centaines par crédit |
| Exécuter une grande tâche d’agent IA (par ex. « configurer 10 objets d’espace de travail ») | Peut atteindre **~$1 ou plus** | Quelques-uns par crédit |
| Lancer une recherche web IA | Un coût fixe par recherche | Des centaines de recherches par crédit |
<Note>
Pour la plupart des équipes, les automatisations standard sont pratiquement gratuites — vous ne verrez une différence notable dans votre solde que lorsque vous vous appuierez sur les fonctionnalités IA ou exécuterez des nœuds de code lourds. C’est voulu : les crédits inclus sont conçus pour vous permettre de construire sans surveiller un compteur.
</Note>
<Note>
Certaines applications ne facturent pas leurs exécutions. Appeler Enregistreur et Dernier Contact réagissent à tous les emails et événements de calendrier importés dans votre espace de travail, de sorte que leur fonction logique s'exécute gratuitement. Vous êtes tout de même facturé pour le travail mesuré qu’elles effectuent, comme les minutes d’appel enregistrées.
</Note>
## Comment l’utilisation de l’IA est mesurée
Lorsqu’une action appelle un modèle IA, nous mesurons exactement les jetons utilisés et les facturons aux **tarifs publiés par le fournisseur du modèle**, puis nous convertissons ce montant en dollars directement en crédits — ainsi, ce que vous dépensez reflète le coût réel du travail, et non un tarif interne majoré. Un court message de chat coûte une fraction de centime. Une tâche d'agent de grande taille — par exemple, la configuration de 10 objets d'espace de travail — fait de nombreux appels de modèles dans un contexte croissant, pour qu'elle puisse s'ajouter à un dollar ou plus. Vous êtes facturé sur ce que vous utilisez réellement, jusqu’au jeton près.
Le coût varie selon le modèle : un modèle léger est nettement moins cher par message qu’un modèle de raisonnement haut de gamme. Vous pouvez voir la répartition par action — y compris le modèle utilisé — dans **Paramètres → Facturation**.
## Ce qui est inclus
Chaque abonnement inclut des crédits, et leur nombre dépend de votre **cycle de facturation**, pas de votre offre :
| Cycle de facturation | Crédits inclus | Utilisation équivalente |
| -------------------- | -------------- | -------------------------- |
| Mensuel | 5/mois | ~$5 d’utilisation par mois |
| Annuel | 50/an | ~$50 d’utilisation par an |
Ces crédits sont conçus pour couvrir confortablement les automatisations quotidiennes. Cinq crédits couvrent des dizaines de milliers d'étapes d'automatisation standard ou des centaines de messages AI rapides, bien qu'une poignée de messages soient nombreux, les tâches d'agents multi-étapes peuvent les utiliser plus rapidement. Vous pouvez recharger à tout moment (voir ci-dessous).
## Report de crédits
Les crédits inutilisés sont automatiquement reportés à la prochaine période de facturation.
* **Capuchon** : Le renouvellement est plafonné à une période d'allocation complète, donc vous ne transmettrez jamais plus que ce que votre cycle de facturation prévoit par période.
* **Visibilité**: Lorsque des crédits reportés sont disponibles, ils apparaissent comme une ligne **Crédits reportés** distincte dans **Paramètres → Facturation**, aux côtés d’un solde **Total disponible**.
## Surveillance de l'utilisation
Suivez votre solde et la façon dont il est utilisé :
1. Allez dans **Paramètres → Facturation**
2. Consultez vos **crédits restants** et **l’utilisation de la période en cours**
3. Examinez la répartition pour voir quels workflows et quelles actions IA consomment des crédits — et quels modèles les actions IA ont utilisés
Les examiner régulièrement permet de repérer tôt et facilement un workflow consommateur de ressources et de décider s’il faut l’optimiser ou recharger.
## Besoin de plus de crédits ?
Si vous n’avez plus de crédits — ou si vous voulez une marge avant une grosse phase d’automatisation — vous pouvez acheter des packs de crédits supplémentaires à tout moment :
1. Allez dans **Paramètres → Facturation**
2. Cliquez sur le bouton **Augmenter**
3. Sélectionnez le montant dont vous avez besoin et acceptez les modifications
Les crédits achetés sont ajoutés immédiatement à votre solde disponible.

View File

@@ -0,0 +1,100 @@
---
title: Formules tarifaires
description: En savoir plus sur les formules tarifaires de Twenty et comment passer de l’une à l’autre.
---
## Vue d'ensemble
Twenty propose une tarification flexible adaptée aux équipes de toute taille, que vous préfériez l’hébergement cloud ou l’auto-hébergement.
## Formules Cloud
### Pro (Cloud)
Pour les équipes prêtes à passer à l’échelle :
* Toutes les fonctionnalités CRM essentielles
* Synchronisation des e-mails et du calendrier
* Workflows et automatisations
* Support standard
<Note>
Les fonctionnalités Premium (SSO, autorisations au niveau des lignes, données d’utilisation de l’IA et plus) ne sont pas incluses dans le plan Pro.
</Note>
### Organisation (Cloud)
Pour les équipes plus importantes ayant des besoins avancés :
* Tout ce qui est inclus dans Pro
* **Fonctionnalités Premium** : intégration SSO, autorisations au niveau des lignes, données d’utilisation de l’IA et plus
* Support prioritaire
## Formules auto-hébergées
### Gratuit (Auto-hébergé)
Hébergez Twenty sur votre propre infrastructure, sans frais :
* Toutes les fonctionnalités Pro incluses
* Support communautaire via Discord
* Contrôle total sur vos données
### Organisation (Auto-hébergé)
Pour les équipes qui ont besoin de fonctionnalités premium tout en s’auto-hébergeant :
* Toutes les fonctionnalités Pro
* **Fonctionnalités Premium** : intégration SSO, autorisations au niveau des lignes, données d’utilisation de l’IA et plus
* Assistance de l’équipe Twenty
* Aucune obligation de publier le code personnalisé en open source avant de le distribuer
## Fonctionnalités premium
Les fonctionnalités premium ne sont disponibles que sur les formules Organisation (Cloud ou auto-hébergé) :
* **Intégration SSO** : authentification unique avec votre fournisseur d’identité
* **Autorisations au niveau des lignes** : contrôle d’accès granulaire au niveau de l’enregistrement
* **Données d'utilisation de l'IA** : Suivez la consommation d'IA dans votre espace de travail
* **Journaux d’audit** : vérifiez ce que chaque membre de l’espace de travail a fait
* **Campagnes d’e-mails** : planifiez quels e-mails doivent être envoyés (bientôt disponible)
* **Espaces de travail illimités** : créez autant d'espaces de travail que vous le souhaitez (auto‑hébergé uniquement)
* **Code source privé** : aucune obligation de publier les modifications dans un dépôt public (auto-hébergé uniquement)
## Changer de formule
### Passer à l’Organisation
1. Allez dans **Paramètres → Facturation → Offres**
2. Cliquez sur **Passer à l’Organisation**
3. Confirmez la mise à niveau
### Rétrograder vers Pro
1. Allez dans **Paramètres → Facturation → Offres**
2. Cliquez sur **Passer à Pro**
3. Confirmez votre rétrogradation
### Passer à la facturation annuelle
1. Allez dans **Paramètres → Facturation**
2. Cliquez sur **Passer à la facturation annuelle**
3. Économisez avec la facturation annuelle
### Passer à la facturation mensuelle
1. Allez dans **Paramètres → Facturation**
2. Cliquez sur **Passer à la facturation mensuelle**
3. Économisez avec la facturation mensuelle
## Obtenir une clé Enterprise pour Organization (Self-Hosted)
Pour utiliser le plan Organization (Self-Hosted), vous devez obtenir une clé Enterprise :
1. Allez dans **Paramètres → Panneau d’administration → Enterprise**
<img src="/images/user-guide/billing/enterprise-key.png" alt="Clé Enterprise" />
2. Cliquez sur **Obtenir une clé Enterprise**
3. Lorsque vous êtes redirigé vers Stripe, saisissez vos informations de paiement et confirmez
4. Lorsque votre clé Enterprise s’affiche, collez-la dans la page des paramètres Enterprise et activez la licence de l’organisation

View File

@@ -0,0 +1,105 @@
---
title: FAQ sur la facturation
description: Foire aux questions sur les tarifs et la facturation de Twenty.
---
## Tarifs
<AccordionGroup>
<Accordion title="Puis-je utiliser Twenty gratuitement tout en l'hébergeant moi-même ?">
Oui, vous pouvez utiliser Twenty gratuitement tout en l'hébergeant vous-même. Vous aurez accès à tout ce qui est inclus dans le plan Pro (Cloud), à l'exception du support de notre équipe principale. Le support est accessible via notre communauté Discord.
Si vous souhaitez vous auto-héberger et que vous avez besoin des fonctionnalités Premium (SSO, autorisations au niveau des lignes et plus encore), vous pouvez choisir la licence Organization (Self-Hosted) payante. Cela inclut également l'assistance de l'équipe Twenty et supprime l'obligation de publier le code personnalisé en open source avant de le distribuer.
</Accordion>
<Accordion title="Quelles sont les fonctionnalités Premium ?">
Les fonctionnalités Premium ne sont disponibles que sur les plans Organization (Cloud ou Self-Hosted) :
* **Intégration SSO** : Authentification unique avec votre fournisseur d'identité
* **Autorisations au niveau des lignes** : Contrôle d'accès granulaire au niveau des enregistrements
* **Données d'utilisation de l'IA** : Suivez la consommation d'IA dans votre espace de travail
* **Journaux d’audit** : vérifiez ce que chaque membre de l’espace de travail a fait
* **Campagnes d’e-mails** : planifiez quels e-mails doivent être envoyés (bientôt disponible)
* **Espaces de travail illimités** : créez autant d'espaces de travail que vous le souhaitez (auto-hébergé uniquement)
* **Code source privé** : Aucune obligation de publier des modifications dans un dépôt disponible publiquement (auto-hébergé seulement)
</Accordion>
<Accordion title="Le Cloud et l'organisation auto-hébergée sont-elles les mêmes plans ?">
Elles offrent les mêmes fonctionnalités Premium. Cependant, un abonnement cloud ne peut pas être utilisé pour des déploiements auto-hébergés. L'auto-hébergement nécessite une clé Enterprise.
</Accordion>
<Accordion title="Proposez-vous des sièges gratuits pour les utilisateurs en mode consultation uniquement ?">
Nous n'offrons pas de sièges gratuits. Les prix sont par utilisateur et chaque utilisateur a besoin d'une licence pour accéder à Vingt personnes.
</Accordion>
<Accordion title="Où puis-je passer à l'abonnement Organisation ?">
Vous pouvez le faire dans `Settings → Billing → Plans`. Puis cliquez sur `Passer à Organisation`.
</Accordion>
<Accordion title="Où puis-je passer à l'abonnement Pro ?">
Vous pouvez le faire dans `Settings → Billing → Plans`. Puis cliquez sur `Switch to Pro`.
</Accordion>
<Accordion title="Où puis-je passer à l'abonnement annuel ?">
Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Upgrade to yearly`.
</Accordion>
<Accordion title="Où puis-je passer à l'abonnement mensuel ?">
Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Downgrade to monthly`.
</Accordion>
<Accordion title="Où puis-je voir ma consommation de crédits ?">
Vous trouverez cela sous `Paramètres → Facturation`.
</Accordion>
<Accordion title="Combien de crédits de flux de travail avons-nous ?">
Le nombre de crédits dépend de votre cycle de facturation, et non de votre plan :
* **Abonnements mensuels** : 5 crédits par mois
* **Abonnements annuels** : 50 crédits par an
</Accordion>
<Accordion title="Comment fonctionne la consommation de crédits de workflow ?">
Chaque action du flux de travail consomme des crédits en fonction de sa complexité :
* Les **opérations internes de base** (comme la recherche, la mise à jour ou la création d'enregistrements) consomment très peu de crédits
* **Les opérations plus complexes** comme les nœuds de code et les requêtes vers des services externes consomment plus de crédits
* Les **prompts IA** consomment également plus de crédits en fonction de l'utilisation
* Les **applications** consomment également plus de crédits de la même manière que les nœuds de code
Les crédits sont déduits en temps réel lorsque les flux de travail ou les apps s'exécutent. Vous pouvez suivre votre utilisation dans **Paramètres → Facturation** pour suivre la consommation et les crédits restants.
</Accordion>
<Accordion title="Puis-je acheter plus de crédits de workflow ?">
Vous pouvez acheter des crédits supplémentaires dans `Paramètres → Facturation`.
</Accordion>
<Accordion title="Puis-je acheter plus de crédits de flux de travail uniquement pour 1 mois ?">
Oui, allez dans `Paramètres → Billing`, cliquez sur le bouton `Augmenter`, choisissez combien de crédits vous voulez, et confirmez. Ils seront appliqués pour la période de facturation en cours. Puis cliquez à nouveau sur le bouton `Augmenter`, remettez la valeur à l'original, et confirmez — la rétrogradation sera appliquée à partir de la prochaine période de facturation.
</Accordion>
</AccordionGroup>
## Facturation
<AccordionGroup>
<Accordion title="Où puis-je gérer les détails de la facturation ?">
Vous pouvez le faire dans `Paramètres → Facturation`.
</Accordion>
<Accordion title="Où puis-je mettre à jour ma méthode de paiement ?">
Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Voir les détails de facturation`. Vous pourrez y ajouter une nouvelle méthode de paiement.
</Accordion>
<Accordion title="Où puis-je mettre à jour mes informations de facturation ?">
Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Voir les détails de facturation`. Vous pourrez y éditer les informations de facturation.
</Accordion>
<Accordion title="Où puis-je accéder à mes factures ?">
Vous pouvez le faire dans `Paramètres → Facturation`. Puis cliquez sur `Voir les détails de facturation`. Vous verrez toutes vos factures en bas de l'écran.
</Accordion>
<Accordion title="Pourquoi mon nombre de sièges est-il différent du nombre d'utilisateurs dans mon espace de travail ?">
Le nombre de sièges de l'espace de travail est synchronisé avec le système de paiement toutes les 6 heures ; les factures sont ajustées en fonction de la différence.
</Accordion>
<Accordion title="Pourquoi ai-je reçu une facture pour un nouveau membre de l'espace de travail ?">
Lorsqu'un nouveau membre de l'espace de travail est ajouté à l'espace de travail, une facture est envoyée pour couvrir la différence. Lorsqu'un membre de l'espace de travail est supprimé, la modification est appliquée sur la prochaine facture mensuelle/annuelle standard.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,39 @@
---
title: Facturation
description: Comprenez la tarification de Twenty et gérez votre abonnement.
---
Twenty propose des formules tarifaires flexibles adaptées aux besoins de votre équipe. Gérez votre abonnement, suivez vos crédits de workflows et accédez à vos factures directement depuis **Paramètres → Facturation**.
## Dans cette section
<CardGroup cols={2}>
<Card title="Formules tarifaires" icon="tags" href="/fr/user-guide/billing/capabilities/pricing-plans">
Découvrez les formules tarifaires de Twenty et ce qu'elles incluent.
</Card>
<Card title="FAQ" icon="circle-question" href="/fr/user-guide/billing/how-tos/billing-faq">
Questions fréquentes sur les tarifs et la facturation.
</Card>
</CardGroup>
## En un coup d’œil
| Plan | Fonctionnalités clés |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Gratuit (auto-hébergé)** | Toutes les fonctionnalités Pro, support communautaire |
| **Pro (Cloud)** | Tout, à l’exception des fonctionnalités Premium (SSO, autorisations au niveau des lignes et plus encore), assistance standard |
| **Organisation (Cloud)** | Tout ce qui est inclus dans Pro + les fonctionnalités Premium (SSO, autorisations au niveau des lignes et plus encore), assistance prioritaire |
| **Organisation (auto-hébergé)** | Tout ce qui est inclus dans Pro + les fonctionnalités Premium (SSO, autorisations au niveau des lignes et plus encore), assistance de l’équipe Twenty, sans obligation de publier votre code personnalisé en open source avant la distribution |
## Réponses rapides
**Où puis-je gérer la facturation ?**
Accédez à **Paramètres → Facturation** pour consulter votre offre, mettre à jour les moyens de paiement et accéder aux factures.
**Puis-je utiliser Twenty gratuitement ?**
Oui ! Auto-hébergez Twenty et bénéficiez de toutes les fonctionnalités Pro sans frais.
**Comment effectuer une mise à niveau ?**
Accédez à **Paramètres → Facturation** et cliquez sur **Passer à Organisation** ou **Passer à Annuel**.
Pour d’autres questions, consultez la [FAQ sur la facturation](/l/fr/user-guide/billing/how-tos/billing-faq).

View File

@@ -0,0 +1,43 @@
---
title: Calendrier
description: Comprendre les fonctionnalités d'intégration du calendrier dans Twenty.
---
**Remarque** : Pour connecter votre calendrier et configurer les paramètres de synchronisation, rendez-vous sur [Configuration des e-mails et calendriers](/l/fr/user-guide/calendar-emails/overview).
## Comment fonctionne l'intégration du calendrier
Twenty synchronise automatiquement vos événements de calendrier et les associe aux enregistrements CRM pertinents, vous offrant une vue complète de votre historique de réunions avec les contacts et les entreprises.
## Onglet Calendrier
À côté de l'onglet Emails dans les enregistrements, vous trouverez un onglet `Calendrier` contenant l'historique des réunions prévues avec l'enregistrement.
### Disponible pour
* **Personnes** : Voir toutes les réunions prévues avec un contact spécifique
* **Entreprises** : Voir toutes les réunions liées à une entreprise et à ses employés
* **Opportunités** : Accéder à l'historique des réunions liées à l'entreprise liée à cette opportunité
### Consulter l'Historique des Réunions
1. **Naviguer jusqu'à un enregistrement** : Allez sur n'importe quel enregistrement de Personne, Entreprise ou Opportunité
2. **Sélectionner l'onglet Calendrier** : Cliquez sur l'onglet `Calendrier` à côté de l'onglet Emails
3. **Parcourir l'Historique des Réunions** : Voir toutes les réunions prévues et leurs détails
4. **Accéder au Contexte des Réunions** : Voir les participants aux réunions, les horaires et les informations connexes
## Paramètres de visibilité
Les données de calendrier suivent les mêmes paramètres de visibilité que les e-mails, assurant des contrôles de confidentialité cohérents sur les deux canaux de communication.
## Ce qui est synchronisé
* **Réunions externes** : Toutes les réunions avec des contacts en dehors de votre organisation
* **Liaison automatique** : Les réunions sont liées aux enregistrements existants de Personnes et d'Entreprises en fonction des adresses e-mail des participants
* **Détails de la réunion** : Objet, heure, durée et participants
* **Mises à jour** : Les nouveaux événements de calendrier se synchronisent automatiquement
## Ce qui n'est pas synchronisé
* **Réunions internes** : Les réunions avec uniquement des collègues (même domaine) restent privées
* **Événements privés** : Événements marqués comme privés dans votre calendrier

View File

@@ -0,0 +1,102 @@
---
title: Boîte de réception
description: Comprendre les fonctionnalités d'intégration des e-mails dans Twenty.
---
**Remarque** : Pour connecter vos comptes e-mail et configurer les paramètres de synchronisation, rendez-vous sur [Configuration des e-mails et calendriers](/l/fr/user-guide/calendar-emails/overview).
## Comment fonctionne l'intégration des emails
Twenty lie automatiquement les emails de vos boîtes aux lettres connectées aux enregistrements CRM pertinents, gardant tout l'historique de communication en un seul endroit.
### Objets où l'on peut trouver des e-mails
Les conversations par email apparaissent dans trois objets principaux :
* **Personnes** : Afficher tous les emails échangés avec un contact spécifique
* **Entreprises** : Voir tous les emails relatifs à une entreprise et à ses employés
* **Opportunités** : Accédez aux messages électroniques liés à la société liée à l'opportunité. Les discussions par email des individus de l'opportunité ne sont pas encore affichées.
### Consulter les discussions email
1. **Naviguer jusqu'à un enregistrement** : Allez sur n'importe quel enregistrement de Personne, Entreprise ou Opportunité
2. **Sélectionner l'onglet Emails** : Cliquez sur l'onglet `Emails` pour voir les e-mails synchronisés
3. **Ouvrir une discussion email** : Cliquez sur n'importe quel email pour ouvrir et lire la conversation complète
4. **Parcourir l'historique** : Faites défiler tout l'historique email avec ce contact
<img src="/images/user-guide/emails/show-inbox.png" style={{width:'100%'}} />
## Ce que vous verrez
### Vue de la discussion email
Lorsque vous ouvrez une discussion par email, vous pouvez :
* **Lire les Conversations Complètes** : Voir l'échange email complet
* **Voir les Participants** : Voir toutes les personnes impliquées dans la discussion par email
* **Vérifier les Horodatages** : Savoir exactement quand chaque email a été envoyé
* **Accéder au Contexte** : Comprendre l'historique complet de la communication
### Visibilité des emails
En fonction de vos paramètres de boîte aux lettres, vous pourriez voir :
* **Contenu Complet** : Texte et détails email complets
* **Sujet + Métadonnées** : Ligne d'objet, expéditeur, destinataire et horodatage
* **Métadonnées Seulement** : Informations de base sans contenu email
## Comportement de synchronisation des emails
### Débit de synchronisation
Twenty importe des emails à environ **400 messages par minute**. Ce rythme est actuellement limité par la limitation de débit de l'API Gmail (et s'applique de manière similaire aux autres fournisseurs).
À titre de référence :
* 1,000 emails → ~2.5 minutes
* 10,000 emails → ~25 minutes
* 50,000 emails → ~2 heures
### Ce qui est synchronisé
* **Emails Externes** : Tous les e-mails avec des contacts en dehors de votre organisation
* **Lien Automatique** : Les emails connectent aux enregistrements existants de Personnes et d'Entreprises
* **Adresses Multiples** : Les emails de n'importe quelle adresse se lient au même enregistrement de contact
* **Mises à jour** : Les nouveaux e-mails apparaissent immédiatement
### Ce qui n'est pas synchronisé
* **E-mails internes** : Par défaut, les e-mails entre collègues (même domaine) restent privés (à configurer dans Paramètres → Général → Sécurité)
* **Emails de Groupe** : Les listes de distribution et les e-mails de groupe sont exclus
* **Dossiers Exclus** : Les dossiers que vous avez choisi de ne pas synchroniser (configurés sous Paramètres → Comptes → Email)
### E-mails internes
Choisissez si les e-mails internes sont synchronisés dans Twenty :
1. Allez dans **Paramètres → Général → Sécurité**
2. Activez ou désactivez **Synchroniser les e-mails internes**
### Synchronisation sélective des dossiers
Contrôlez quels dossiers e-mail sont synchronisés avec Twenty :
1. Accédez à **Paramètres → Comptes** et sélectionnez votre compte de messagerie connecté
2. Configurez les dossiers dans la section Email
3. Choisissez des dossiers spécifiques à inclure ou exclure (Boîte de réception, Envoyés, Archive, dossiers personnalisés)
## Dépannage de la synchronisation des e-mails
### Problèmes Courants de Synchronisation
* **Retards de synchronisation** : Les e-mails apparaissent immédiatement, mais les importations initiales prennent plus de temps
* **Emails Manquants** : Vérifiez si :
* Les dossiers sont exclus dans les paramètres de Message Folder
* La création automatique de contacts est désactivée (les e-mails nécessitent des enregistrements existants dans Twenty)
* L'e-mail provient des collègues (même domaine) ou des listes de groupe
* La boîte aux lettres termine toujours la synchronisation initiale
### Limitations des e-mails
* **Dossiers Systèmes** : Certains dossiers d'e-mail peuvent ne pas être disponibles pour la synchronisation
* **Alias** : Seules les véritables boîtes aux lettres peuvent être connectées (non pas des alias d'email)

View File

@@ -0,0 +1,25 @@
---
title: Puis-je planifier des réunions depuis Twenty ?
description: Informations sur la planification de réunions directement depuis Twenty.
---
## État actuel
L'intégration du calendrier de Twenty est conçue pour **synchroniser et afficher** vos événements de calendrier existants.
## Planification de réunions via les workflows
Bien qu'il ne soit pas possible de planifier des réunions manuellement, vous pouvez les planifier en 20 à l'aide de workflows.
1. Créer un nouveau flux de travail
2. Sélectionnez n'importe quel déclencheur en fonction de vos besoins
3. Ajoutez le nœud **Create Calendar Event**
4. Configurez toutes les données nécessaires
5. Activez le flux de travail
## Ce que vous pouvez faire
* **Afficher l'historique des réunions** sur les fiches Personnes, Entreprises et Opportunités
* **Voir les réunions à venir** avec des contacts dans votre CRM
* **Suivre le contexte des réunions** aux côtés des communications par e-mail
* **Créer automatiquement des contacts** à partir des participants aux réunions

View File

@@ -0,0 +1,53 @@
---
title: Puis-je envoyer des e-mails depuis Twenty ?
description: Informations sur l'envoi d'e-mails directement depuis Twenty.
---
## État actuel
L'intégration d'e-mails de Twenty est conçue pour **synchroniser et afficher** votre historique d'e-mails ainsi que pour rédiger et envoyer des e-mails.
Lorsque vous consultez un fil de discussion d'e-mails sur une page d'enregistrement et cliquez sur **Répondre**, vous pouvez directement rédiger et envoyer un e-mail.
## Comment envoyer un message depuis Twenty
Pré-requis : un compte de messagerie connecté avec la possibilité d'envoyer des e-mails
1. Ouvrez le menu Commande avec le raccourci **Ctrl+K** ou **Cmd+K**
2. Cliquez sur l'option "Composer un e-mail"
3. Choisissez les destinataires, ajoutez le sujet, le corps et les pièces jointes à votre adresse e-mail
4. Cliquez sur le bouton "Envoyer" pour envoyer l'e-mail
## Ce que vous pouvez faire aujourd'hui
* **Afficher l'historique des e-mails** sur les fiches Personnes, Entreprises et Opportunités
* **Lire des fils d'e-mails complets** avec des contacts dans votre CRM
* **Suivre le contexte des communications** en parallèle des événements du calendrier
* **Créer automatiquement des contacts** à partir des interactions par e-mail
* **Répondre via redirection** — cliquez sur Répondre pour accéder à votre boîte de réception
## Envoi d'e-mails via les workflows
Vous **pouvez envoyer des e-mails automatiquement en utilisant des workflows**. C'est utile pour :
* Relances automatisées
* Notifications aux contacts
* Communications déclenchées en fonction des modifications des enregistrements
Les e-mails envoyés via les workflows transitent par votre compte de messagerie connecté.
→ En savoir plus sur l'[action Envoyer un e-mail](/l/fr/user-guide/workflows/capabilities/workflow-actions#send-email)
## Séquences d'e-mails et newsletters
Pour les séquences d'e-mails et les newsletters, nous recommandons d'utiliser des workflows pour connecter Twenty à un outil dédié de marketing par e-mail.
<Warning>
Les envois d'e-mails en masse ne doivent pas être effectués directement depuis votre boîte de réception afin de protéger la réputation de votre domaine. Utilisez un outil dédié pour les communications en masse.
</Warning>
→ Voir [Comment envoyer des e-mails depuis des workflows](/l/fr/user-guide/workflows/capabilities/send-emails-from-workflows) pour les instructions de configuration
## Plans à venir
La rédaction native d'e-mails depuis Twenty figure sur notre feuille de route. Rejoignez nos [discussions GitHub](https://github.com/twentyhq/twenty/discussions) pour partager votre cas d'utilisation et aider à prioriser cette fonctionnalité.

View File

@@ -0,0 +1,35 @@
---
title: Puis-je suivre l'activité des emails sur tous les objets ?
description: Comprendre le suivi de l'activité des emails sur différents objets.
---
## Objets pris en charge
L'activité des emails est actuellement disponible sur **trois objets standard** :
| Objet | Ce que vous verrez |
| ---------------- | ---------------------------------------------------------------------------------------- |
| **Personnes** | Tous les emails échangés avec ce contact spécifique |
| **Entreprises** | Tous les emails avec toute personne de cette entreprise (en fonction du domaine d'email) |
| **Opportunités** | Les emails liés à l'entreprise associée à l'opportunité |
## Pourquoi uniquement ces objets ?
Personnes, Entreprises et Opportunités sont les objets relationnels principaux où le contexte des emails apporte le plus de valeur. Les fils de discussion d'emails sont automatiquement liés en fonction de :
* **Adresse email** → mise en correspondance avec les enregistrements Personnes
* **Domaine d'email** → mis en correspondance avec les enregistrements Entreprises
* **Relation avec l'entreprise** → liée aux Opportunités
## Objets personnalisés
**Le suivi des emails n'est pas disponible sur les objets personnalisés** pour le moment.
Si vous avez besoin du contexte des emails sur un objet personnalisé, envisagez :
* Utiliser un champ de relation pour lier votre objet personnalisé à Personnes ou Entreprises
* Afficher l'historique des emails sur l'enregistrement lié de la personne ou de l'entreprise
## Plans à venir
L'extension de la visibilité des emails aux objets personnalisés est à l'étude. Partagez votre cas d'utilisation sur nos [discussions GitHub](https://github.com/twentyhq/twenty/discussions) pour aider à prioriser cette fonctionnalité.

View File

@@ -0,0 +1,42 @@
---
title: Connecter plusieurs boîtes aux lettres par utilisateur
description: Connectez plusieurs comptes e-mail pour un seul utilisateur.
---
## Vue d'ensemble
Twenty prend en charge **un nombre illimité de comptes e-mail par utilisateur**. C'est utile si vous gérez plusieurs boîtes de réception, par exemple :
* E-mail professionnel individuel + boîte de réception d'équipe partagée
* Plusieurs adresses e-mail destinées aux clients
* Différents comptes e-mail pour différents rôles
## Comment ajouter plusieurs boîtes aux lettres
1. Allez dans **Paramètres → Comptes**
2. Cliquez sur **Ajouter un compte**
3. Connectez un compte Google ou Microsoft supplémentaire ou tout autre fournisseur de messagerie prenant en charge les protocoles IMAP/SMTP
4. Configurez les paramètres de synchronisation pour cette boîte aux lettres
5. Répétez l'opération pour chaque boîte aux lettres que vous souhaitez connecter
## Gestion de plusieurs comptes
Chaque boîte aux lettres connectée possède ses propres paramètres :
* **Visibilité des e-mails** : Choisissez ce que les membres de l'équipe peuvent voir
* **Création automatique de contacts** : Activer/désactiver par boîte aux lettres
* **Sélection des dossiers** : Choisissez quels dossiers synchroniser
## Comment les e-mails apparaissent
Les e-mails de toutes vos boîtes aux lettres connectées sont synchronisés avec Twenty et apparaissent dans :
* **Fiches Personnes** : Selon l'adresse e-mail du contact
* **Fiches Entreprises** : Selon le domaine de l'e-mail
* **Opportunités** : Selon l'entreprise liée
<Note>Chaque e-mail indique depuis quelle boîte aux lettres il a été envoyé ou dans laquelle il a été reçu, afin que vous puissiez suivre quel compte a été utilisé pour chaque communication.</Note>
## Notes importantes
<Warning>Seules de véritables boîtes aux lettres peuvent être connectées. Les alias d'e-mail qui redirigent vers une autre boîte aux lettres ne peuvent pas être connectés séparément — ils se synchroniseront via la boîte aux lettres principale.</Warning>

View File

@@ -0,0 +1,53 @@
---
title: Je ne vois pas les emails sur les enregistrements.
description: Dépannage des emails manquants sur les enregistrements.
---
## Causes courantes
### 1. Synchronisation initiale toujours en cours
La synchronisation des emails prend du temps, surtout pour les boîtes aux lettres volumineuses. Twenty importe des emails à environ **400 messages par minute** (soumis aux limites de débit de l'API Gmail).
* **Synchronisation du calendrier** : se termine en quelques minutes
* **Synchronisation des emails** : dépend de la taille de la boîte aux lettres (par exemple, 10 000 emails ≈ 25 minutes, 50 000 emails ≈ 2 heures)
**Solution** : Attendez la fin de l'importation initiale. Vous pouvez estimer la durée en fonction de la taille de votre boîte aux lettres.
### 2. Le contact n'existe pas dans Twenty
Les emails n'apparaissent que sur les enregistrements de personnes existants. Si le contact n'a pas encore été créé :
* Activez la **création automatique de contacts** dans les paramètres de votre boîte aux lettres
* Ou créez d'abord manuellement l'enregistrement de la personne
**Solution** : Accédez à **Paramètres → Comptes**, sélectionnez votre boîte aux lettres et activez la création automatique de contacts.
### 3. Les emails internes sont exclus
Les emails entre collègues (même domaine de messagerie) ne sont jamais synchronisés afin de préserver la confidentialité.
**Solution** : Il s'agit du fonctionnement attendu. Seuls les emails externes sont synchronisés.
### 4. L'email provient d'un groupe ou d'une liste de distribution
Les emails de groupe et les listes de distribution sont exclus de la synchronisation.
**Solution** : Il s'agit du fonctionnement attendu.
### 5. Dossier non sélectionné pour la synchronisation
Si vous utilisez la fonctionnalité Dossier de messages, certains dossiers peuvent être exclus.
**Solution** : Accédez à **Paramètres → Comptes**, sélectionnez votre boîte aux lettres et vérifiez les paramètres de synchronisation des dossiers.
### 6. Mauvaise adresse email dans l'enregistrement
L'enregistrement de la personne peut avoir une adresse email différente de celle utilisée dans l'email.
**Solution** : Ajoutez la bonne adresse email à l'enregistrement de la personne.
## Ça ne fonctionne toujours pas ?
1. Essayez de déconnecter puis de reconnecter votre boîte aux lettres
2. Contactez l'assistance si le problème persiste

View File

@@ -0,0 +1,58 @@
---
title: Limiter les e-mails importés.
description: Contrôlez quels e-mails sont importés dans Twenty.
---
## Vue d'ensemble
Par défaut, Twenty synchronise tous les e-mails externes depuis votre boîte aux lettres connectée. Vous pouvez limiter ce qui est importé à l’aide de la **sélection de dossiers** et des **paramètres de visibilité**.
## Méthode 1 : Sélection de dossiers (recommandée)
Contrôlez quels dossiers e-mail sont synchronisés avec Twenty :
1. Allez dans **Paramètres → Comptes**
2. Sélectionnez votre compte e-mail connecté
3. Choisissez quels dossiers synchroniser :
| Dossier | Description |
| -------------------------- | -------------------------------------------- |
| **Boîte de réception** | E-mails entrants principaux |
| **Envoyé** | E-mails sortants que vous avez envoyés |
| **Archive** | Messages archivés |
| **Dossiers personnalisés** | Tous les dossiers spécifiques de votre choix |
4. Excluez les dossiers que vous ne voulez pas synchroniser (Spam, Corbeille, dossiers personnels)
<Note>Cela vous donne un contrôle précis sur les e-mails qui apparaissent dans votre CRM sans tout synchroniser.</Note>
## Méthode 2 : Paramètres de création automatique de contacts
Contrôlez à quel moment les contacts sont créés à partir des e-mails :
1. Allez dans **Paramètres → Comptes**
2. Sélectionnez votre boîte aux lettres connectée
3. Choisissez une option :
* **Désactivé** : Aucun contact n’est créé, mais les e-mails sont tout de même synchronisés avec les contacts existants.
* **Envoyés et reçus** : Créer des contacts à partir de tous les e-mails externes
* **Envoyés uniquement** : Créer des contacts uniquement à partir des e-mails que vous envoyez
## E-mails internes
Les messages entre collègues (même domaine) peuvent être synchronisés dans Twenty :
1. Allez dans **Paramètres → Général → Sécurité**
2. Activez ou désactivez **Synchroniser les e-mails internes**
<Note>Par défaut, cette option est désactivée.</Note>
## Ce qui est toujours exclu
Ces e-mails ne sont jamais synchronisés, quels que soient les paramètres :
* **E-mails de groupe** : Listes de distribution et messages de groupe
* **Spam/Corbeille** : Les dossiers système sont généralement exclus
## Note importante
<Note>Nous ne fournissons pas encore d'adresse e-mail en CC pour une synchronisation sélective. Utilisez la fonctionnalité de sélection de dossiers ci-dessus pour obtenir le même niveau de contrôle.</Note>

View File

@@ -0,0 +1,144 @@
---
title: Calendrier et e-mails
description: Connectez vos comptes de messagerie et de calendrier à Twenty.
---
## Options de connexion
### Compte Google (Gmail & Google Calendar)
1. Allez dans **Paramètres → Comptes**
2. Cliquez sur **Ajouter un compte**
3. Sélectionnez **Continuer avec Google**
4. Autorisez Twenty à accéder à votre Gmail et à votre Google Calendar
5. Configurez les paramètres de synchronisation des e-mails (visibilité, création automatique) → cliquez sur **Suivant**
6. Configurez les paramètres de synchronisation du calendrier (visibilité, création automatique) → cliquez sur **Ajouter un compte**
7. Vos e-mails et vos événements de calendrier commenceront à se synchroniser automatiquement
### Compte Microsoft (Outlook & Calendrier Microsoft)
1. Allez dans **Paramètres → Comptes**
2. Cliquez sur **Ajouter un compte**
3. Sélectionnez **Continuer avec Microsoft**
4. Autorisez Twenty à accéder à votre Outlook et à votre Calendrier Microsoft
5. Configurez les paramètres de synchronisation des e-mails (visibilité, création automatique) → cliquez sur **Suivant**
6. Configurez les paramètres de synchronisation du calendrier (visibilité, création automatique) → cliquez sur **Ajouter un compte**
7. Vos e-mails et vos événements de calendrier commenceront à se synchroniser automatiquement
### Configuration IMAP/SMTP/CalDAV (Autres fournisseurs)
Pour les autres fournisseurs de services de messagerie et de calendrier :
1. Allez dans **Paramètres → Comptes**
2. Configurez les paramètres IMAP pour synchroniser les e-mails entrants et les paramètres SMTP pour envoyer des e-mails
3. Configurez les paramètres CalDAV pour le calendrier
4. Tester la connexion
<Note>
**Auto-hébergement sur un réseau isolé (air-gapped) ou interne** : Par défaut, Twenty refuse les connexions sortantes vers des adresses IP privées/internes (protection SSRF). Si votre serveur de messagerie ou de calendrier fonctionne sur une IP locale/privée (par exemple un serveur sur site sur un LAN), les connexions vers celui-ci seront bloquées. Pour les autoriser, définissez la variable d’environnement suivante sur le serveur :
```
OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
```
Cela désactive le mode sécurisé pour **toutes** les requêtes sortantes (actions HTTP de flux de travail, webhooks et connexions IMAP/SMTP/CalDAV), donc ne l’activez que sur des réseaux de confiance et isolés où la protection SSRF n’est pas nécessaire.
</Note>
### Plusieurs boîtes aux lettres
* **Comptes illimités** : Connectez plusieurs comptes de messagerie par utilisateur
* **Gestion de Compte**: Basculez entre différentes boîtes aux lettres
* **Paramètres de Synchronisation**: Configurez différents paramètres par boîte aux lettres
<Warning>
Seules les vraies boîtes aux lettres peuvent être connectées (par exemple, support@domain.com avec sa propre boîte de réception). Les alias email qui redirigent vers une autre boîte aux lettres ne peuvent pas être connectés à Twenty.
</Warning>
## Configuration des Emails
### Visibilité des Messages
Choisissez différents niveaux de visibilité pour vos e-mails :
* **Métadonnées uniquement** : Partagez uniquement les informations de base (expéditeur, destinataire, date, heure)
* **Objet et métadonnées** : Partagez la ligne d'objet ainsi que les métadonnées
* **Tout le contenu des e-mails** : Partagez l'intégralité du contenu des e-mails, y compris les pièces jointes
### Création Automatique de Contacts
* **Désactivée**: Pas de création automatique de contacts
* **Pour les messages envoyés et reçus**: Créer des contacts pour toutes les interactions e-mail externes
* **Pour les messages envoyés uniquement** : Créez des contacts uniquement pour les e-mails que vous envoyez
* **Remarque** : Par défaut, les e-mails internes (où tous les participants partagent votre domaine) ne sont pas synchronisés afin de protéger la confidentialité.
<Note>Lorsque cette option est activée, les contacts sont automatiquement liés à leurs enregistrements Entreprise en fonction de leur domaine de messagerie. Si l'entreprise n'existe pas encore, Twenty la crée pour vous.</Note>
<Note>
**Synchronisation des e-mails internes** : Le comportement « e-mails internes non synchronisés » est celui utilisé par défaut, mais il peut être désactivé. Le bouton bascule se trouve dans les paramètres avancés :
1. Ouvrez **Paramètres** et activez le bouton **Avancé** en bas de la page des paramètres
2. Allez dans **Général → Sécurité**
3. Activez le bouton **Synchroniser les e-mails internes** pour inclure les e-mails où tous les participants partagent le même domaine.
Il s’agit d’un paramètre à l’échelle de l’espace de travail (utile pour les universités ou les organisations partageant un même domaine).
</Note>
### Contrôlez quels emails sont synchronisés avec Sélection des dossiers de messages
Contrôlez quels dossiers e-mail sont synchronisés avec Twenty :
1. Accédez à **Paramètres → Comptes** et sélectionnez votre compte de messagerie connecté
2. Choisissez quels dossiers synchroniser :
* **Boîte de réception** : Emails entrants principaux
* **Envoyés** : Les e-mails sortants que vous avez envoyés
* **Dossiers Personnalisés** : Tous les dossiers spécifiques que vous souhaitez inclure
* **Exclure les Dossiers** : Ignorer les dossiers tels que Spam, Corbeille ou dossiers personnels
Cela vous donne un contrôle précis sur les e-mails qui apparaissent dans votre CRM sans tout synchroniser.
**Ce qui est Synchronisé :**
* **E-mails externes** : Tous les e-mails avec des contacts externes provenant des dossiers sélectionnés
* **E-mails internes** : Non synchronisés par défaut (les e-mails du même domaine restent privés). Activez le bouton **Avancé** en bas de la page **Paramètres**, puis activez **Synchroniser les e-mails internes** dans **Général → Sécurité** pour les inclure à l’échelle de l’espace de travail.
* **Pièces jointes** : Disponible au H1 2026
**Remarque** : Nous ne fournissons pas d'adresse email CC pour une synchronisation sélective. Utilisez plutôt la fonctionnalité Message Folder ci-dessus pour obtenir le même niveau de contrôle sur les e-mails qui se synchronisent avec Twenty.
## Configuration des Calendriers
### Visibilité des Événements
Choisissez ce qui sera visible pour les autres utilisateurs dans votre espace de travail :
* **Tout** : Les détails de l'événement seront partagés avec votre équipe
* **Métadonnées** : Seules la date et les participants seront partagés avec votre équipe
### Création Automatique de Contacts pour les Réunions
* **Oui** : Créez automatiquement des contacts pour les participants aux réunions qui ne sont pas dans votre CRM
* **Non** : Liez uniquement les réunions à des contacts existants
<Note>Lorsque cette option est activée, les contacts sont automatiquement liés à leurs enregistrements Entreprise en fonction de leur domaine de messagerie. Si l'entreprise n'existe pas encore, Twenty la crée pour vous.</Note>
### Contrôler quels événements sont synchronisés
* **Importation de Réunions** : Importez automatiquement les événements de calendrier
* **Lien de Contacts** : Associez des réunions aux enregistrements de personnes et d'entreprises
**Ce qui est Synchronisé :**
* **Réunions** : Événements de calendrier avec des participants externes
* **Lien de Contacts** : Événements automatiquement liés aux enregistrements CRM
* **Événements d'Équipe** : Visibilité partagée du calendrier
## Fréquence de Synchronisation
**Mises à jour toutes les 5 minutes** : Les données de messagerie et de calendrier sont synchronisées automatiquement toutes les 5 minutes après l'importation initiale.
<Note>
**Durée de la synchronisation initiale**: La synchronisation du calendrier se termine rapidement (généralement en quelques minutes), tandis que la synchronisation des emails prend plus de temps pour les grandes boîtes aux lettres. Twenty importe des emails à environ **400 messages par minute** (soumis aux limites de débit de l'API Gmail), de sorte qu'une boîte aux lettres contenant 10,000 emails prend environ 25 minutes. Ne vous inquiétez pas si vous voyez des contacts provenant d'événements de calendrier apparaître avant vos contacts e-mail ; c'est un comportement normal.
</Note>
## Prochaines étapes
* [Fonctionnalités de la boîte aux lettres](/l/fr/user-guide/calendar-emails/capabilities/mailbox)
* [Résoudre les problèmes d'e-mails manquants](/l/fr/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records)

View File

@@ -0,0 +1,275 @@
---
title: Paramètres du graphique
description: Configurez vos graphiques pour afficher les données exactement selon vos besoins.
---
import { ChartIcon } from '/snippets/chart-icon.mdx';
## Accéder aux paramètres du graphique
1. Cliquez sur le bouton **Edit** situé dans l'angle supérieur droit de votre tableau de bord
<img src="/images/user-guide/dashboard/dashboard-edit.png" alt="Mode édition" />
2. Le tableau de bord passe en mode édition
3. Cliquez sur n'importe quel widget pour le sélectionner
4. Le panneau des paramètres s'ouvre à droite
Les paramètres sont organisés en sections :
* **Données** : Quelles données récupérer et comment les filtrer
* **Axe X** : Comment regrouper et trier les catégories (graphiques à barres/lignes)
* **Axe Y** : Que mesurer et comment l'afficher (graphiques à barres/lignes)
* **Style** : Couleurs, libellés et options visuelles
<Note>
Certains paramètres n'apparaissent que lorsque d'autres paramètres sont configurés. Par exemple, **Granularité de date** n'apparaît que lorsque vous sélectionnez un champ de date.
</Note>
---
## Paramètres des données
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="database" />Source </span>
Choisissez à partir de quel objet récupérer les données.
1. Cliquez sur **Source**
2. Sélectionnez un objet (Opportunités, Personnes, Entreprises, etc.)
Tous vos objets standard et personnalisés sont disponibles. Modifier la source réinitialise d'autres paramètres, car les options de champ dépendent de l'objet sélectionné.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-source.png" alt="Source" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filter" />Filtre </span>
Limitez les enregistrements inclus dans le graphique.
1. Cliquez sur **Filtre**
2. Le générateur de filtres s'ouvre
3. Cliquez sur **+ Add filter**
4. Sélectionnez un champ, une condition et une valeur
5. Ajoutez d'autres filtres selon vos besoins
Les filtres fonctionnent de la même manière que dans les vues en tableau. Utilisez-les pour vous concentrer sur des segments spécifiques de vos données.
**Exemple** : Filtrez les opportunités où Stage est égal à "Won" pour n'afficher que les affaires clôturées.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-filters.png" alt="Filtre" />
<Tip>
Pour les champs de date, essayez **Is relative** pour créer des filtres dynamiques comme "Past 7 days" ou "This month" qui se mettent à jour automatiquement.
</Tip>
<Tip>
Les filtres avancés sont pris en charge — ajoutez plusieurs règles de filtre et combinez-les avec la logique **And** ou **Or**.
</Tip>
---
## Paramètres de l'axe X
Ces paramètres contrôlent l'axe horizontal des graphiques à barres et à lignes — généralement la manière dont vos données sont regroupées en catégories.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-x" />Données affichées </span>
Sélectionnez le champ par lequel regrouper vos données. Cela détermine les catégories affichées sur l'axe X.
**Exemple** : Sélectionnez "Stage" pour voir les données regroupées par étape du pipeline, ou "Created date" pour voir les données dans le temps.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-data-on-display.png" alt="Données affichées" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />Granularité de date </span>
Lors d'un regroupement par un champ de date, choisissez la période de regroupement.
| Option | Regroupe les données par | Exemple de résultat |
| ------------------------ | --------------------------- | ------------------------------------------------------- |
| **Jour** | Chaque jour du calendrier | 1 janv., 2 janv., 3 janv.... |
| **Semaine** | Semaines calendaires | Semaine 1, Semaine 2, Semaine 3... |
| **Mois** | Mois calendaires | janvier, février, mars... |
| **Trimestre** | Trimestres fiscaux | Q1, Q2, Q3, Q4 |
| **Année** | Années civiles | 2023, 2024, 2025 |
| **Jour de la semaine** | Jour de la semaine (agrégé) | lundi, mardi... (tous les lundis combinés) |
| **Mois de l'année** | Mois (agrégé) | janvier, février... (tous les mois de janvier combinés) |
| **Trimestre de l'année** | Trimestre (agrégé) | Q1, Q2, Q3, Q4 (tous les Q1 combinés) |
Les options "de la semaine/de l'année" agrègent sur l'ensemble des périodes. Utilisez **Jour de la semaine** pour voir quel jour reçoit généralement le plus d'affaires. Utilisez **Mois** pour voir les tendances mois par mois.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />Trier par </span>
Contrôlez l'ordre des catégories sur l'axe X.
* **Position** – Utilise l'ordre défini dans les paramètres de votre champ Select
* **Alphabétique** – A à Z (ou chronologique pour les dates)
* **Par valeur** – Ordonné selon la métrique (du plus élevé au plus faible ou l'inverse)
* **Manuel** – Faites glisser pour définir votre propre ordre
<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-sort.png" alt="Trier par" />
**Astuce** : Pour les étapes du pipeline, utilisez **Position** pour afficher les étapes dans l'ordre de votre processus commercial (Lead → Qualified → Proposal → Won).
<Note>
Les options affichées dépendent du type de votre champ. Les champs Select disposent de toutes les options ; les champs de date et de texte en affichent moins.
</Note>
<Tip>
Avec le tri **Manuel**, faites glisser les catégories pour créer un ordre personnalisé — idéal pour mettre en avant des segments spécifiques ou raconter une histoire avec vos données.
</Tip>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="eye-off" />Omettre les valeurs nulles </span>
Masquez les catégories qui ont une valeur nulle ou aucune donnée.
* **Activé** : Les catégories sans enregistrements sont masquées
* **Désactivé** : Toutes les catégories sont affichées, même si elles sont vides
Utilisez ceci pour épurer les graphiques avec des données clairsemées.
---
## Paramètres de l'axe Y
Ces paramètres déterminent ce que vous mesurez et comment c'est affiché.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-y" />Données affichées </span>
Sélectionnez le champ et l'opération pour calculer votre métrique.
* **Comptages** – Compter tout, Compter les vides, Compter les non vides, Compter les valeurs uniques
* **Math** – Somme, Moyenne, Min, Max (champs numériques)
* **Pourcentages** – Pourcentage vide, Pourcentage non vide
Les champs booléens ajoutent Compter true/false. Les graphiques agrégés avec des champs de date affichent Earliest/Latest.
**Exemple** : Sélectionnez "Amount" avec Sum pour voir la valeur totale des affaires par catégorie, ou Count all pour voir le nombre d'affaires.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-data-on-display.png" alt="Données affichées" />
<Note>
Les options affichées dépendent de votre champ et du type de graphique. Si vous ne voyez pas une opération attendue, vérifiez le type de votre champ.
</Note>
### Ratio
Pour les champs Select, Multi-select ou booléens, vous pouvez calculer le pourcentage d'une valeur spécifique.
1. Sélectionnez un champ Select, Multi-select ou booléen
2. Activez **Ratio**
3. Choisissez l'option à mesurer
**Exemple** : Affichez les affaires "Won" en pourcentage de toutes les opportunités. Si vous avez 10 Won sur 50 au total, le graphique affiche 20 %.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filters" />Regrouper par </span>
Ajoutez une deuxième dimension pour créer plusieurs séries (plusieurs barres ou lignes).
1. Définissez d'abord le champ de l'axe X
2. Cliquez sur **Regrouper par**
3. Sélectionnez un deuxième champ
**Exemple** : Regroupez les affaires par Stage (axe X) ET par Owner (Regrouper par) pour voir, côte à côte, la répartition du pipeline de chaque personne.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-group-by.png" alt="Grouper par" />
Lorsque Regrouper par est activé, vous verrez plusieurs couleurs dans votre graphique et une légende apparaît.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />Granularité de date </span>
Lorsque Regrouper par est un champ de date, choisissez la période (mêmes options que pour l'axe X).
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />Trier par </span>
Lorsque **Regrouper par** est défini, contrôlez l'ordre des séries regroupées (p. ex., quelle barre du propriétaire apparaît en premier dans chaque catégorie).
Mêmes options que le tri de l'axe X — Position, Alphabétique et Manuel — sauf que **le tri basé sur la valeur n'est pas disponible** pour le regroupement secondaire.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="chart-bar-popular" />Cumulatif </span>
Affichez des totaux cumulés au lieu de valeurs individuelles.
* **Désactivé** : Chaque barre/point affiche sa propre valeur
* **Activé** : Chaque barre/point affiche la somme de toutes les valeurs précédentes plus la sienne
**Exemple** : janvier = 10, février = 15
* Cumulatif désactivé : Affiche 10 et 15
* Cumulatif activé : Affiche 10 et 25 (10 + 15)
Utilisez le cumulatif pour suivre la progression vers un objectif dans le temps.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-cumulative.png" alt="Cumulé" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="math-min" />Plage minimale / <ChartIcon icon="math-max" />Plage maximale </span>
Définissez des valeurs minimales et maximales fixes pour l'axe Y.
* Laissez vide pour un ajustement automatique
* Saisissez un nombre pour fixer la limite
**Quand l'utiliser :**
* Définissez Min à 0 pour des comparaisons visuelles précises
* Définissez les deux pour des échelles cohérentes entre plusieurs graphiques
* Concentrez-vous sur une plage de valeurs spécifique en définissant les deux
---
## Paramètres de style
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="color-swatch" />Couleurs </span>
Définissez le jeu de couleurs de votre graphique. Choisissez parmi une variété de palettes de couleurs.
<Note>
Lors d'un regroupement par un champ Select, le graphique utilise automatiquement les couleurs définies pour chaque option dans les paramètres de votre champ.
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="gizmo" />Nom de l'axe </span>
Choisissez quels libellés d'axe afficher : **Aucun**, **Axe X**, **Axe Y** ou **Les deux** (graphiques à barres et à lignes uniquement).
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="stack-2" />Barres empilées / Lignes empilées </span>
Lorsque Regrouper par est défini, choisissez comment plusieurs séries sont affichées.
* **Désactivé (Groupé)** : Les séries apparaissent côte à côte. À utiliser pour comparer des valeurs exactes entre des groupes.
* **Activé (Empilé)** : Les séries s'empilent les unes sur les autres. À utiliser pour montrer la composition — comment les parties constituent un tout.
**Exemple** : Affaires par étape, regroupées par propriétaire
* Groupé : Voir côte à côte les chiffres exacts de chaque propriétaire
* Empilé : Voir le total des affaires par étape, avec la contribution de chaque propriétaire empilée
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="badge-2k" />Libellés de données </span>
Affichez les valeurs directement sur les éléments du graphique (barres, points, secteurs).
* **Activé** : Les valeurs apparaissent sur le graphique
* **Désactivé** : Aucune valeur affichée (apparence plus sobre)
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="text-caption" />Légende </span>
Afficher ou masquer la légende (apparaît uniquement lorsque Regrouper par est défini).
* **Activé** : La légende indique ce que représente chaque couleur
* **Désactivé** : Aucune légende affichée
<Tip>
**Survolez** un élément de la légende pour mettre ce groupe en évidence. **Cliquez** pour le masquer temporairement du graphique.
</Tip>
---
## Notes spécifiques au graphique
### Diagrammes en secteurs
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="chart-pie" size={16} /></span> **Chaque secteur représente** – Définissez la façon dont les secteurs sont regroupés
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="eye-off" size={16} /></span> **Masquer la catégorie vide** – Supprimer les secteurs à valeur zéro
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="number-123" size={16} /></span> **Afficher la valeur au centre** – Afficher la valeur agrégée (somme, moyenne, comptage, etc.)
### Graphiques agrégés
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-left" size={16} /></span> **Préfixe** – Ajoutez du texte avant le nombre (p. ex., `$`)
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-right" size={16} /></span> **Suffixe** – Ajoutez du texte après le nombre (p. ex., `%`)

View File

@@ -0,0 +1,92 @@
---
title: Tableaux de bord
description: Créez et organisez des tableaux de bord avec des onglets pour visualiser vos données CRM.
---
## Vue d'ensemble
Dans Twenty, les tableaux de bord sont organisés selon une hiérarchie: **Tableaux de bord → Onglets → Widgets**. Chaque tableau de bord peut contenir plusieurs onglets, et chaque onglet contient des widgets (graphiques, nombres, iFrames).
## Création d'un tableau de bord
1. Accédez à **Tableaux de bord** dans la navigation
2. Cliquez sur **+ New Record**
<img src="/images/user-guide/dashboard/dashboard-create-new.png" alt="Créer un nouveau tableau de bord" />
3. Donnez un nom à votre tableau de bord
4. Commencez à ajouter des onglets et des widgets
## Utiliser les onglets
Les onglets vous aident à organiser votre tableau de bord en sections logiques.
### Création d'onglets
1. En mode édition, cliquez sur **+** dans la barre d'onglets et un panneau latéral s'ouvrira sur la droite
2. Nommez votre onglet (p. ex., "Aperçu du pipeline", "Performance de l'équipe")
3. Ajoutez des widgets à l'onglet
### Réorganisation des onglets
1. En mode édition, cliquez et maintenez enfoncé sur l'onglet que vous souhaitez déplacer
2. Glissez-déposez jusqu'à la nouvelle position
3. Vous pouvez également cliquer sur l'onglet et utiliser le menu de commande pour déplacer l'onglet vers la gauche ou la droite
### Suppression des onglets
1. En mode édition, cliquez sur l'onglet que vous souhaitez supprimer
2. Cliquez sur le bouton **Supprimer** dans le menu des commandes
### Duplication d'onglets
1. Cliquez sur l'onglet que vous souhaitez dupliquer
2. Cliquez sur le bouton **Duplicate** dans le panneau latéral
<img src="/images/user-guide/dashboard/dashboard-tabs.png" alt="Onglet du tableau de bord" />
## Disposition du tableau de bord
### Agencement des widgets
* Glissez-déposez pour positionner
* Redimensionnez pour mettre en valeur
* Regroupez les graphiques associés
### Duplication d'un tableau de bord
1. Sélectionnez le tableau de bord que vous souhaitez dupliquer
2. Ouvrez la barre de commande avec **Cmd + K** (ou **Ctrl + K** sous Windows)
3. Sélectionnez **Duplicate dashboard**
<img src="/images/user-guide/dashboard/dashboard-duplicate.png" alt="Dupliquer un tableau de bord" />
### Meilleures pratiques
* **Enchaînement logique**: Organisez du général au détail
* **Hiérarchie visuelle**: Des graphiques plus grands pour les indicateurs clés
* **Style cohérent**: Utilisez des couleurs et des polices assorties
## Visibilité et accès
### Visibilité du tableau de bord
Les tableaux de bord sont visibles par toute personne ayant accès à votre espace de travail Twenty. Il n'existe pas d'option de tableau de bord privé pour le moment.
### Favoris
Vous pouvez ajouter des tableaux de bord à vos favoris pour un accès rapide. Il s'agit d'un paramètre personnel—vos favoris ne sont pas visibles par les autres utilisateurs.
Pour ajouter un tableau de bord aux favoris, ouvrez le tableau de bord et cliquez sur l'icône d'étoile.
### Comportement du fuseau horaire
Les tableaux de bord affichent actuellement les données en fonction du fuseau horaire de l'utilisateur qui les consulte. Cela signifie qu'un même tableau de bord peut afficher des indicateurs différents pour des membres de l'équipe situés dans des régions différentes (p. ex., APAC vs US).
<Note>
**Bientôt disponible**: Nous ajouterons la possibilité de définir un fuseau horaire spécifique pour un tableau de bord, afin que tous les utilisateurs voient des données cohérentes, quel que soit leur emplacement.
</Note>
<Note>
**Bientôt disponible**: Des filtres au niveau du tableau de bord vous permettront d'appliquer des filtres à tous les widgets en une seule fois, ce qui accélérera l'exploration de vos données.
</Note>

View File

@@ -0,0 +1,169 @@
---
title: Widgets
description: Explorez les types de widgets et les options de visualisation dans Twenty.
---
import { ChartIcon } from '/snippets/chart-icon.mdx';
## Widgets disponibles
Twenty propose différents types de widgets pour visualiser vos données CRM.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-bar-popular" />Diagrammes en barres</span>
Affichez les données sous forme de barres horizontales ou verticales.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="Diagramme en barres" />
</Frame>
**Idéal pour :**
* Comparer des valeurs entre catégories
* Afficher des classements
* Suivre des indicateurs par période
**Exemples d'utilisation :**
* Opportunités par étape
* Revenus par commercial
* Contacts ajoutés par mois
<Note>
**Limites d'affichage** : Les diagrammes en barres peuvent afficher au maximum 100 barres, et 50 groupes par barre lors de l'utilisation de Group By. Si vous voyez l'avertissement "Données non affichées : X barres max par graphique", ajoutez des filtres pour restreindre vos données ou modifiez le regroupement (par ex., regroupez par semaine plutôt que par jours).
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-pie" />Diagrammes en secteurs</span>
Affichez les proportions d'un ensemble.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="Diagramme en secteurs" />
</Frame>
**Idéal pour :**
* Afficher la composition ou la répartition
* Comparer les parties au tout
* Mettre en évidence les principaux segments
**Exemples d'utilisation :**
* Répartition des opportunités par source
* Répartition des contacts par secteur
* Composition du pipeline par propriétaire
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-line" />Graphiques linéaires</span>
Affichez les tendances au fil du temps.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="Graphique linéaire" />
</Frame>
**Idéal pour :**
* Suivre les évolutions au fil du temps
* Identifier les tendances
* Comparer plusieurs indicateurs
**Exemples d'utilisation :**
* Tendance du nombre d'opportunités par mois
* Croissance des revenus par trimestre
* Niveaux d'activité au fil du temps
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="sum" />Graphiques agrégés</span>
Affichez clairement des valeurs clés uniques.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="Graphique agrégé" />
</Frame>
**Idéal pour :**
* Mettre en évidence des indicateurs clés de performance (KPI)
* Afficher des totaux ou des moyennes
* Vérifications rapides de l'état
**Exemples d'utilisation :**
* Valeur totale du pipeline
* Nombre d'opportunités ouvertes
* Taux de conversion
**Options avancées :**
* **Ratio** : Pour les champs de type Sélection, calculez des ratios entre les valeurs. Accédez à **Données affichées** → sélectionnez votre champ → activez l'option **Ratio**.
* **Préfixe et suffixe** : Ajoutez du texte personnalisé avant ou après le nombre (par ex., préfixe "$" ou suffixe "%") pour une meilleure lisibilité.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="frame" />iFrames</span>
Intégrez des outils et du contenu externes directement dans votre tableau de bord.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-table.png" alt="Tableau de table" />
</Frame>
**Idéal pour :**
* Recherche d’éléments individuels
* Vérification des valeurs exactes
* Audit ou référence
**Exemples d'utilisation :**
* Opportunités qui se clôturent ce mois-ci
* Nouveaux leads cette semaine
* Factures en retard
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="table" />Table</span>
Voir les enregistrements filtrés directement dans votre tableau de bord.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
</Frame>
**Idéal pour :**
* Afficher des rapports ou tableaux de bord externes
* Intégrer des outils de vente tiers
* Afficher du contenu en direct provenant d'autres systèmes
**Exemples d'utilisation :**
* Indicateurs de votre outil d'assistance
* Indicateurs de votre composeur d'appels
* Contenu en direct de votre outil de séquences de vente
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="align-box-left-top" />Texte enrichi</span>
Ajoutez du texte et du contenu mis en forme directement dans votre tableau de bord.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="Texte enrichi" />
</Frame>
**Idéal pour :**
* Ajout de contexte ou d'instructions
* Descriptions du tableau de bord
* Notes et annotations
**Fonctionnalités:**
* Mise en forme de texte enrichi (gras, italique, listes, etc.)
* Importation d'images et de fichiers
* Édition de type Markdown
<Note>
**Bientôt disponible** : Les jauges ne sont pas encore disponibles, mais figurent sur notre feuille de route.
</Note>
### Duplication de widgets
1. Cliquez sur le widget
2. Ouvrez **Options**
3. Cliquez sur **Dupliquer le widget**

View File

@@ -0,0 +1,54 @@
---
title: FAQ sur les tableaux de bord
description: Questions fréquemment posées sur les tableaux de bord dans Twenty.
---
<AccordionGroup>
<Accordion title="Puis-je créer des tableaux de bord privés ?">
Non, les tableaux de bord sont actuellement visibles par toute personne ayant accès à votre espace de travail Twenty. Les tableaux de bord privés ne sont pas encore disponibles.
</Accordion>
<Accordion title="Pourquoi mes indicateurs semblent-ils différents de ceux de mon collègue ?">
Actuellement, les tableaux de bord affichent les données en fonction du fuseau horaire de la personne qui les consulte. Si vous êtes dans des régions différentes (p. ex., APAC vs. États-Unis), vous pouvez voir des chiffres légèrement différents pour un même tableau de bord. Nous travaillons à ajouter un paramètre de fuseau horaire par tableau de bord afin de garantir des données cohérentes entre les équipes.
</Accordion>
<Accordion title="Puis-je exporter mon tableau de bord ?">
L'export des tableaux de bord n'est pas disponible pour le moment. Cette fonctionnalité figure sur notre feuille de route.
</Accordion>
<Accordion title="Puis-je partager des tableaux de bord avec des utilisateurs externes ?">
Non, le partage de tableaux de bord avec des utilisateurs en dehors de votre espace de travail Twenty (utilisateurs non Twenty) n'est pas pris en charge pour le moment.
</Accordion>
<Accordion title="Comment ajouter un tableau de bord à mes favoris ?">
Ouvrez le tableau de bord que vous souhaitez ajouter aux favoris, puis cliquez sur l'icône en forme d'étoile. Les favoris sont personnels — ils n'affectent pas les autres utilisateurs.
</Accordion>
<Accordion title="Quelle est la différence entre les onglets et les widgets ?">
* **Onglets** organisent votre tableau de bord en sections (comme des pages au sein du tableau de bord)
* **Widgets** sont les visualisations individuelles (graphiques, nombres, iFrames) dans chaque onglet
Structure : Tableau de bord → Onglets → Widgets
</Accordion>
<Accordion title="Puis-je filtrer un tableau de bord entier en une seule fois ?">
Les filtres au niveau du tableau de bord ne sont pas encore disponibles, mais cette fonctionnalité figure sur notre feuille de route. Actuellement, vous devez appliquer des filtres à chaque widget individuellement.
</Accordion>
<Accordion title="Les graphiques de jauge sont-ils disponibles?">
Pas encore. Les graphiques de jauge figurent sur notre feuille de route et seront ajoutés dans une prochaine version.
</Accordion>
<Accordion title="Comment dupliquer un tableau de bord ?">
1. Assurez-vous d'être en mode consultation (pas en mode édition)
2. Ouvrez la barre de commande avec **Cmd + K** (ou **Ctrl + K** sous Windows)
3. Sélectionnez **Dupliquer le tableau de bord**
</Accordion>
<Accordion title="À quelle fréquence les données du tableau de bord sont-elles actualisées ?">
Les widgets se mettent à jour automatiquement au fur et à mesure que vos données CRM changent :
* Mises à jour en temps réel pour la plupart des indicateurs
* Utilisez le bouton d'actualisation pour une mise à jour manuelle si nécessaire
* Les données historiques sont conservées pour l'analyse des tendances
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,67 @@
---
title: FAQ sur les widgets
description: Questions fréquentes et messages d'erreur expliqués.
---
<AccordionGroup>
<Accordion title="Comment afficher des pourcentages au lieu des décomptes ?">
Trois options :
* **Pourcentage vide/non vide** : Dans Données affichées, sélectionnez Pourcentage vide ou Pourcentage non vide
* **Ratio** : Pour les champs Sélection ou Case à cocher, activez Ratio pour afficher une option spécifique en pourcentage de tous les enregistrements
* **Suffixe** : Pour les graphiques agrégés, ajoutez `%` comme suffixe dans les paramètres Style
</Accordion>
<Accordion title="Quelle est la différence entre des barres groupées et empilées ?">
Lorsque vous utilisez **Regrouper par**, vous pouvez afficher les séries de deux façons :
* **Groupé** : Barres côte à côte—idéal pour comparer des valeurs exactes
* **Empilé** : Barres l'une sur l'autre—idéal pour montrer la composition
Activez l'option **Empilé** dans les paramètres Style pour basculer.
</Accordion>
<Accordion title="Pourquoi ne vois-je pas les options Somme ou Moyenne ?">
Les opérations disponibles dépendent du **type de champ** :
* **Champs Nombre** : Somme, Moyenne, Min, Max
* **Champs Date** : Le plus ancien, Le plus récent (graphiques agrégés uniquement)
* **Champs Case à cocher** : Compter vrai, Compter faux
Si vous ne voyez pas une option, vérifiez que vous avez sélectionné un type de champ compatible.
</Accordion>
<Accordion title="Pourquoi certains paramètres sont-ils grisés ou manquants ?">
De nombreux paramètres n'apparaissent que lorsque les prérequis sont remplis :
* **Granularité de date** : Sélectionnez d'abord un champ de date
* **Regrouper par, Légende, Empilé** : Définissez d'abord Source
* **Boutons de bascule Légende et Empilé** : Définissez d'abord Regrouper par
Si un paramètre est manquant, configurez d'abord son prérequis.
</Accordion>
<Accordion title="Que signifie 'Aucune donnée' ?">
Le graphique n'a trouvé aucun enregistrement correspondant à votre configuration.
**Pour corriger :** Supprimez ou ajustez les filtres, vérifiez que vous avez sélectionné le bon objet Source, ou assurez-vous que des enregistrements existent pour votre plage de dates.
</Accordion>
<Accordion title="Que signifie 'Configuration non valide' ?">
Un paramètre requis est manquant ou incompatible.
**Pour corriger :** Assurez-vous que Source est défini, que Données affichées est configuré, et que tous les champs de regroupement requis sont sélectionnés.
</Accordion>
<Accordion title="Que signifie 'Données non affichées' ?">
Vos données dépassent les limites d'affichage (100 barres, 100 points de données ou 100 segments).
**Pour corriger :** Ajoutez des filtres pour restreindre vos données, ou changez la granularité de date de Jour à Semaine ou Mois.
</Accordion>
<Accordion title="Pourquoi un axe n'affiche-t-il aucune donnée ?">
Le champ sélectionné n'a aucune valeur pour les enregistrements de votre filtre, ou le type de champ ne correspond pas aux données attendues.
**Pour corriger :** Essayez un autre champ, ou vérifiez que les enregistrements ont des valeurs pour le champ sélectionné.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,75 @@
---
title: Tableaux de bord
description: Apprenez les bases des rapports et des tableaux de bord dans Twenty.
---
## Comprendre les tableaux de bord
Les tableaux de bord dans Twenty offrent un moyen visuel de suivre vos indicateurs clés de performance et d'obtenir des informations à partir de vos données CRM.
<img src="/images/user-guide/dashboard/dashboards_v2.png" alt="Tableaux de bord" />
## Concepts clés
### Tableaux de bord
Un tableau de bord est un ensemble d'onglets qui affichent vos données CRM en un coup d’œil. Vous pouvez créer plusieurs tableaux de bord à des fins différentes :
* Performance des ventes
* Activité de l'équipe
* Santé du pipeline
* Indicateurs personnalisés
### Onglets
Les onglets vous permettent d'organiser votre tableau de bord en sections. Chaque onglet contient un ou plusieurs widgets.
### Widgets
Les widgets sont des visualisations individuelles qui affichent des données spécifiques. Types disponibles :
* Diagrammes en barres
* Diagrammes en secteurs
* Graphiques linéaires
* Graphiques d'agrégation
* iFrames
* Texte enrichi
<Note>
**Limitations actuelles** :
* L'export des tableaux de bord et le partage avec des utilisateurs externes (utilisateurs non Twenty) ne sont pas disponibles pour le moment.
* Les graphiques en jauge ne sont pas encore disponibles.
</Note>
## Prise en main
### Créer votre premier tableau de bord
1. Accédez à la section **Dashboards**
2. Cliquez sur **+ New Dashboard**
3. Donnez un nom à votre tableau de bord
4. Ajoutez des onglets pour organiser votre contenu
5. Ajoutez des widgets pour afficher vos données
6. Enregistrer
### Ajout de widgets
1. Ouvrez un onglet de votre tableau de bord
2. Cliquez sur **+ Add Widget**
3. Sélectionnez le type de widget
4. Choisissez la source de données (objet)
5. Configurez les paramètres du widget
6. Enregistrez et affichez votre widget
## Meilleures pratiques
* **Commencez simplement** : Débutez avec quelques indicateurs clés et ajoutez-en au fil du temps
* **Concentrez-vous sur des données exploitables** : Affichez des indicateurs qui orientent les décisions
* **Examen régulier** : Consultez vos tableaux de bord régulièrement pour détecter les tendances
* **Partagez avec l'équipe** : Rendez les tableaux de bord visibles pour les membres de l'équipe concernés
## Prochaines étapes
* [Widgets et visualisations](/l/fr/user-guide/dashboards/capabilities/widgets)
* [Référence des paramètres du graphique](/l/fr/user-guide/dashboards/capabilities/chart-settings)
* [FAQ sur les tableaux de bord](/l/fr/user-guide/dashboards/how-tos/dashboards-faq)

View File

@@ -0,0 +1,76 @@
---
title: Gestion des erreurs et validation
description: Examinez et corrigez les erreurs d'importation directement dans l'interface avant de confirmer.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Validation préalable à l'importation
Après avoir téléversé votre fichier et fait la correspondance des champs, Twenty valide vos données **avant** l'importation. Cela vous permet de détecter et de corriger les erreurs sans affecter vos données existantes.
## Comment ça marche
1. **Téléversez** votre fichier CSV
2. **Faites correspondre** vos colonnes aux champs de Twenty
3. **Passez en revue** les erreurs potentielles mises en évidence en jaune
4. **Corrigez les erreurs** directement dans l'interface
5. **Confirmez** l'importation
<VimeoEmbed videoId="1145273857" title="Démonstration vidéo" />
## Affichage des erreurs
Les lignes présentant des problèmes sont mises en évidence en **jaune**. Vous pouvez :
* **Modifiez la cellule directement** pour corriger l'erreur
* **Supprimez la ligne** pour l'ignorer complètement
Cette modification en ligne vous fait gagner du temps — inutile de revenir à votre feuille de calcul, de corriger les erreurs et de téléverser à nouveau.
## Types d'erreurs courants
### Valeurs en double
**Cause** : Un champ unique (email, domaine) existe déjà dans Twenty ou apparaît deux fois dans votre fichier.
**Correctif** :
* Modifiez la valeur en double dans l'interface d'importation
* Supprimez l'une des lignes en double
Voir [Contraintes d'unicité](/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints) pour plus de détails sur la façon dont l'unicité est appliquée.
### Format invalide
**Cause** : Les données ne correspondent pas au format attendu (p. ex., email invalide, format de date incorrect).
**Correctif** : Modifiez la cellule pour utiliser le format correct.
Voir [Correspondance des champs](/l/fr/user-guide/data-migration/capabilities/field-mapping) pour le format attendu de chaque type de champ.
### Champs obligatoires manquants
**Cause** : Un champ obligatoire est vide.
**Correctif** : Saisissez une valeur dans le champ obligatoire ou supprimez la ligne.
### Relation introuvable
**Cause** : L'enregistrement référencé n'existe pas (p. ex., un domaine d'entreprise qui n'a pas été importé).
**Correctif** :
* Importez d'abord les enregistrements parents
* Ou corrigez la valeur de référence
Voir [Importation des relations](/l/fr/user-guide/data-migration/capabilities/import-relations) pour l'ordre d'importation correct et la manière de lier les enregistrements.
## Conseils pour réduire les erreurs
1. **Téléchargez le modèle** pour voir le format attendu avant d'importer votre fichier
2. **Nettoyez vos données** d'abord dans votre feuille de calcul
3. **Importez les fichiers dans le bon ordre** pour importer les relations (Entreprises → Personnes → Opportunités)
4. **Testez avec de petits lots** avant l'importation complète
5. **Vérifiez les doublons** avant de téléverser
6. **Limiter chaque fichier à 10 000 enregistrements**

View File

@@ -0,0 +1,198 @@
---
title: Mappage des champs
description: Comment fonctionne la cartographie des champs pendant l'importation des données.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Comment fonctionne la cartographie des champs
Lorsque vous téléchargez un fichier, 20 analysent vos colonnes et tentent de les faire correspondre aux champs existants.
### Mappage automatique
Vingt tentatives de faire correspondre les colonnes basées sur:
* Noms d'en-tête de colonne (correspondances exactes ou similaires)
* Détection du type de données (dates, chiffres, emails)
* Modèles de champs communs
<Note>**Astuce rapide:** Exporter quelques lignes depuis l'objet que vous voulez importer. Le fichier exporté aura le nom exact des colonnes à 20 attendus, rendant le mappage automatique sans problème pendant l'importation.</Note>
### Options de mappage manuel
Pour chaque colonne, vous pouvez:
* **Mapper à un champ**: Sélectionnez le champ correspondant à 20 dans un menu déroulant
* **Ne pas mapper** : Ignorer entièrement la colonne (les données ne seront pas importées)
<Note>**Les champs doivent exister avant l'importation.** L'importation crée des enregistrements, pas des champs. Créez des champs personnalisés sous **Paramètres → Modèle de données** avant d'importer.</Note>
## Compatibilité du type de champ
Tous les types de champs disponibles dans le Modèle de Données sont pris en charge pour l'importation.
Vous pouvez également importer des valeurs `id` pour assigner un ID spécifique à de nouveaux enregistrements ou mettre à jour les valeurs existantes.
<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />
## Exigences du format de données
<Note>**Certains champs ont une syntaxe spéciale.** Nous vous recommandons de télécharger le fichier d'exemple avant de préparer votre importation afin de voir la syntaxe attendue pour chaque type de champ.</Note>
### Champs d'adresse
L'adresse est un champ imbriqué avec plusieurs colonnes. Certains peuvent être laissés vides.
* **Adresse / Adresse 1**: Rue ligne 1
* **Adresse / Adresse 2** : Rue ligne 2
* **Adresse / Ville** : Nom de la Ville
* **Adresse / État** : État ou province
* **Adresse / Pays** : Nom du pays
* **Adresse / Code postal**: Code postal
### Champs de tableau
Utilisez le format suivant :
```
["value1","value2"]
```
### Champs booléens
Utilisez `TRUE` ou `FALSE` (majuscule) - pas `true` ou `false`
### Champs de la devise
La devise est un champ imbriqué avec deux colonnes qui **doivent être remplies**:
* **Montant / Montant** : La valeur numérique (par exemple, `1234.56`)
* **Montant / Devise** : Le code de la devise (par exemple, `USD`, `EUR`)
### Champs de date
Formats pris en charge :
* `YYYY-MM-DD` (recommandé)
* `MM/DD/YYYYY`
* `JJ/MM/YYYY`
* ISO 8601 format
### Champs de domaine
* Il est recommandé d'utiliser le format `https://domain. om` pour éviter de créer des doublons, car c'est le format utilisé pour les entreprises créées par la boîte aux lettres et les synchronisations de calendrier
* Un `label de domaine` et `URL de domaine` peuvent être remplis : la meilleure pratique est de remplir `domain.com` dans l'étiquette et `https://domain.com` dans l'url
* Les domaines doivent être uniques au sein de l'objet Entreprises
* **Les domaines doivent être uniques dans le fichier à importer**
### Champs e-mail
* Doit être un format d'email valide
* Les e-mails doivent être uniques dans l'objet People
* **Les e-mails doivent être uniques dans le fichier à importer**
* Pour les e-mails supplémentaires: utilisez **Emails / Courriel Primaire** pour l'e-mail principal, et **Emails / E-mails Supplémentaires** avec ce format:
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### Champs ID
Spécifier un `id` pendant l'importation est optionnel. Vingt auto-génère une si elle n'est pas fournie.
Utiliser des cas pour mapper une colonne `id`:
* **Définit un ID spécifique** : Choisissez l'UUID pour les enregistrements nouvellement créés
* **Mettre à jour les enregistrements existants**: Faites correspondre avec les enregistrements existants pour les mettre à jour au lieu de créer des doublons. Dans ce cas, il est recommandé de ne pas cartographier les autres champs uniques: la cartographie d'un seul champ unique garantit une importation plus fluide.
<Note>Si vous fournissez un `id`, il doit être au format UUID (par exemple, `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
### Champs JSON
Utiliser un format JSON valide :
```
{"key":"value","key2":"value2"}
```
### Champs de liens
Semblable aux champs de domaine:
* Remplissez à la fois le libellé et les colonnes d'URL : **Liens / URL de liaison** et **Liens / Étiquette de lien**
* Utiliser le format complet de l'URL : `https://example.com`
* Pour les liens secondaires, utilisez la colonne **Liens / Liens secondaires** avec ce format :
```
[{"url":"https://twenty.com","label":"Twenty"}]
```
### Champs à sélection multiple
Utilisez les **noms de l'API** (pas les libellés d'affichage) dans le format suivant :
```
["VALUE1","VALUE2"]
```
Voir [here](#finding-api-names-for-select-fields) où trouver les noms de l'API.
<Note>Les nouvelles options de sélection ne seront pas créées automatiquement par l'importation. Ils doivent être ajoutés dans **Paramètres → Modèle de données** avant d'importer.</Note>
<Warning>
**Écraser l'import ; il ne l'ajoute pas.**
Si un enregistrement a déjà `VALUE2` et `VALUE3` sélectionnés, et que vous importez `["VALUE1"]`, l'enregistrement n'aura `VALUE1` qu'après l'importation. Les sélections précédentes sont remplacées, non fusionnées.
</Warning>
### Nombre de champs
* Numéros uniquement
* Les décimales utilisent la période: `1234.56`
* Pas de milliers de séparateurs
### Champs du téléphone
Le téléphone est un champ imbriqué avec plusieurs colonnes qui **doivent être remplies**
* **Téléphones / Numéro de téléphone principal**: le numéro de téléphone (par exemple, `4159095555`)
* **Téléphones / Code de pays de téléphone principal**: Code pays (par exemple, `US`)
* **Téléphones / Code d'appel téléphonique principal**: Code d'appel (par exemple, `+1`)
### Champs d'évaluation
Utilisez le format du nom de l'API: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4`, `RATING_5`
### Champs de relation
Veuillez consulter notre article dédié : [Importer des relations entre les objets](/l/fr/user-guide/data-migration/capabilities/import-relations)
### Champs de sélection
Utilisez le **nom de l'API** de l'option (pas l'étiquette d'affichage) :
```
VALUE1
```
Voir [ici](#finding-api-names-for-select-fields) où trouver les noms d'API.
<Note>Les nouvelles options de sélection ne seront pas créées automatiquement par l'importation. Elles doivent être ajoutées sous **Paramètres → Modèle de données** avant l'importation.</Note>
### Champs de texte
* Aucun formatage particulier requis
* Les espaces au début et à la fin sont supprimés
## Recherche des noms d'API
Pour les champs Select, Multi-Select et Array avec des options prédéfinies, vous devez utiliser les **noms d'API**, et non les libellés affichés.
### Comment trouver les noms d'API
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez l'objet et le champ
3. Activez le **mode avancé** (bouton à bascule en bas à droite de la page des paramètres)
4. Affichez le nom d'API pour chaque option
<VimeoEmbed videoId="1144910809" title="Démonstration vidéo" />

View File

@@ -0,0 +1,48 @@
---
title: Formats de fichiers pris en charge
description: Formats de fichiers pris en charge pour l’importation de données dans Twenty.
---
## Formats pris en charge
Twenty prend en charge trois formats de fichiers pour l’importation :
| Format | Extension | Notes |
| ------------------ | --------- | ------------------------------ |
| **CSV** | .csv | Recommandé, le plus compatible |
| **Excel** | .xlsx | Format Excel moderne |
| **Excel (hérité)** | .xls | Ancien format Excel |
## Exigences relatives aux fichiers
| Exigence | Valeur |
| ---------------------------- | -------------------------------------------------------- |
| **Encodage** | UTF-8 recommandé |
| **Limite d’enregistrements** | 10 000 enregistrements par fichier |
| **Structure** | La première ligne doit contenir les en-têtes de colonnes |
| **Contenu** | Un seul type d’objet par fichier |
## Meilleures pratiques pour les fichiers CSV
* **Délimiteur** : Utilisez une virgule (`,`) ou un point-virgule (`;`)
* **Délimiteur de texte** : Utilisez des guillemets doubles (`"`) pour le texte contenant des virgules
* **Fins de ligne** : Windows (CRLF) ou Unix (LF) sont tous deux pris en charge
* **Valeurs vides** : Laissez les cellules vides, n’utilisez pas "NULL" ni "N/A"
## Meilleures pratiques pour Excel
Lors de l’exportation depuis Excel :
* Supprimez les formules (exportez uniquement les valeurs)
* Supprimez les lignes vides à la fin
* Assurez-vous qu’aucune cellule n’est fusionnée
* Utilisez uniquement la première feuille
## Jeux de données volumineux
Pour les jeux de données de plus de 10 000 enregistrements :
* Divisez en plusieurs fichiers
* Ou utilisez l’[importation via l’API](/l/fr/user-guide/data-migration/how-tos/import-data-via-api) pour un nombre illimité d’enregistrements
<Note>Pour des migrations très volumineuses (plus de 100 000 enregistrements), l’API est nettement plus rapide et plus fiable que les importations CSV.</Note>

View File

@@ -0,0 +1,148 @@
---
title: Importer des relations entre objets
description: Importer des relations entre enregistrements via CSV.
---
## Vue d'ensemble
Twenty prend en charge l'importation de relations entre objets lors de l'importation CSV. Cela vous permet de lier des enregistrements (p. ex., associer des Personnes à des Entreprises) dans le cadre de votre migration de données.
<Note>**Actuellement pris en charge pour l'importation** : Relations un-à-plusieurs pointant vers un seul type d'objet de chaque côté (p. ex., Personnes → Entreprises). Les relations pointant vers plusieurs types d'objet ne sont pas encore prises en charge pour l'import/export.</Note>
## Fonctionnement des relations dans Twenty
### Un à plusieurs / Plusieurs à un
Twenty prend en charge des relations standard où un enregistrement est lié à plusieurs autres :
* **Une Entreprise → Plusieurs Personnes** : Une entreprise peut avoir plusieurs employés, mais chaque personne appartient à une seule entreprise
* **Une Entreprise → Plusieurs Opportunités** : Une entreprise peut avoir plusieurs affaires, mais chaque opportunité appartient à une seule entreprise
### Relations pouvant pointer vers plusieurs types d'objet
Certaines relations peuvent se connecter à différents types d'objets. Cela fonctionne de deux façons :
**Modèle 1 : De nombreux enregistrements liés chacun à un enregistrement provenant de différents types d'objets**
Plusieurs Notes ou Tâches peuvent chacune être attachées à plusieurs types d'objets à la fois :
* **Notes** peuvent être liées à une Personne, une Entreprise et une Opportunité simultanément
* **Tâches** peuvent être liées à une Personne, une Entreprise et une Opportunité simultanément
Ici, les Notes/Tâches sont du côté "plusieurs". Chacune est liée à un enregistrement par type d'objet.
<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
**Modèle 2 : Un enregistrement recevant des liens de nombreux enregistrements de différents types d'objets**
Un Projet peut recevoir des liens de plusieurs enregistrements provenant de différents types d'objets :
* **Un Projet** peut avoir de nombreuses Personnes qui lui sont liées, de nombreuses Entreprises qui lui sont liées, et de nombreuses Notes qui y sont rattachées
Ici, le Projet est du côté "un". Plusieurs enregistrements issus d'objets différents peuvent tous être liés au même Projet.
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
**Limitation d'import/export** : Les relations qui pointent vers plusieurs types d'objet (comme Notes → Personnes/Entreprises/Opportunités) ne sont **pas encore prises en charge** lors de l'import ou de l'export CSV.
* **Import** : Seules les relations un-à-plusieurs pointant vers un seul type d'objet de chaque côté peuvent être importées
* **Export** : Les colonnes pour les relations pointant vers plusieurs types d'objet sont actuellement laissées vides
C'est sur notre feuille de route.
</Warning>
### Ce qui n'est pas pris en charge aujourd'hui
**Les relations plusieurs à plusieurs** ne sont pas encore disponibles. Par exemple, vous ne pouvez pas actuellement créer une relation où :
* De nombreuses Personnes sont liées à de nombreux Projets
<Note>Beaucoup à de nombreuses relations sont prévues pour H2 2026.</Note>
## Lier des enregistrements lors de l'importation
<Note>**Rappel** : Seules les relations un-à-plusieurs pointant vers un seul type d'objet peuvent être importées (p. ex., Personnes → Entreprises). Les relations pointant vers plusieurs types d'objet (p. ex., Notes → Personnes/Entreprises/Opportunités) ne sont pas encore prises en charge.</Note>
### Étape 1 : Identifier les côtés "un" et "plusieurs"
Commencez par déterminer quel objet est du côté "un" et lequel est du côté "plusieurs" de la relation.
**Exemple**:
* **Entreprise** est le côté "un" (une entreprise a de nombreux employés)
* **Personnes** est le côté "plusieurs" (chaque personne appartient à une seule entreprise)
### Étape 2 : Assurez-vous que les enregistrements du côté "un" existent
Avant d'importer le côté "plusieurs", les enregistrements du côté "un" doivent déjà exister dans Twenty.
* Importez ou créez d'abord les enregistrements du côté "un" (p. ex., Entreprises)
* Validez leur identifiant unique. Cela peut être :
* L'`id` (UUID de Twenty)
* Un champ défini comme unique (p. ex., `domain` pour les Entreprises, ou un identifiant externe provenant de votre système précédent)
<Warning>L'importation échouera si une référence est faite à un enregistrement inexistant.</Warning>
### Étape 3 : Préparer votre fichier CSV
Ajoutez une colonne dans votre fichier CSV du côté "plusieurs" qui référence l'enregistrement du côté "un".
**Exemple** : Pour un fichier CSV Personnes lié aux Entreprises :
```
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
**Important** :
* La valeur doit **correspondre exactement** au champ unique de l'enregistrement de l'Entreprise
* Pour les domaines, utilisez l'**URL de domaine** (p. ex., `https://acme.com`), pas le libellé de domaine
* N'associez qu'**un seul** identifiant unique par relation : cela rendra l'importation plus fluide
### Étape 4 : Vérifier que le champ de relation existe
Avant de téléverser votre fichier, assurez-vous que le champ de relation existe entre vos objets.
S'il n'existe pas :
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez votre objet (p. ex., Personnes)
3. Créez un champ de relation pointant vers l'objet cible (p. ex., Entreprise)
### Étape 5 : Téléverser et associer la relation
1. Téléversez votre fichier CSV via l'interface d'importation
2. À l'étape de correspondance des champs, trouvez votre colonne de relation (p. ex., `companyDomain`)
3. Associez-la au champ de relation (p. ex., Entreprise)
4. Twenty liera automatiquement chaque enregistrement au parent correspondant
### Champs uniques disponibles pour les relations
| Objet | Champs uniques disponibles |
| ------------------------------------------- | ---------------------------------------------- |
| **Entreprises** | `id`, `domain`, tout champ unique personnalisé |
| **Personnes** | `id`, `email`, tout champ unique personnalisé |
| **Membres de l'espace de travail** | `id`, `email` (pas le nom) |
| **Autres objets standard et personnalisés** | `id`, tout champ marqué comme unique |
<Note>**Liaison vers les membres de l'espace de travail** : Lorsque la relation pointe vers des membres de l'espace de travail (votre équipe se connectant à Twenty), référencez-les par leur **adresse e-mail**, et non par leur nom.</Note>
<Note>Nous recommandons d'utiliser `domain` pour les Entreprises et `email` pour les Personnes, car ces valeurs sont lisibles par l'humain et faciles à maintenir dans les feuilles de calcul.</Note>
<Note>**Rappel** : Les enregistrements supprimés de manière logique (visibles sous Menu Commandes → Voir les enregistrements supprimés) comptent pour les critères d'unicité. Si vous importez un enregistrement avec la même valeur unique qu'un enregistrement supprimé, l'enregistrement supprimé sera restauré. Voir [Contraintes d'unicité](/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints) pour plus de détails.</Note>
## Règle d'ordre d'importation
<Warning>
**Importez toujours d'abord le côté "un" !**
1. **Entreprises** d'abord (aucune dépendance)
2. **Personnes** en second (liées aux Entreprises)
3. **Opportunités** en troisième (liées aux Entreprises/Personnes)
4. **Objets personnalisés** en suivant leurs dépendances
L'enregistrement parent doit exister avant que vous puissiez y faire référence.
</Warning>

View File

@@ -0,0 +1,72 @@
---
title: Contraintes d'unicité
description: Comment Twenty impose l'unicité des données lors de l'importation.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Vue d'ensemble
Twenty impose l'unicité sur certains champs afin d'éviter les doublons et d'assurer l'intégrité des données. Comprendre ces contraintes est essentiel pour des importations réussies.
## Champs uniques par défaut
| Objet | Champs uniques |
| ------------------------ | ---------------------------- |
| **Personnes** | `id`, `email` |
| **Entreprises** | `id`, `domain` |
| **Objets personnalisés** | `id` uniquement (par défaut) |
<Note>Le champ `id` est l'identifiant interne de Twenty, généré automatiquement pour chaque enregistrement. Il utilise le format UUID (par exemple, `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
## Champs uniques personnalisés
Vous pouvez définir des champs uniques supplémentaires sous **Paramètres → Modèle de données** :
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez l'objet
3. Cliquez sur un champ
4. Activez **Unique** dans les paramètres du champ
### Cas d'utilisation pour les champs uniques personnalisés
* **ID externes** : Stockez les ID provenant d'autres systèmes (Salesforce ID, HubSpot ID)
* **Identifiants métier** : Numéros d'employé, codes client
* **Coordonnées alternatives** : Profil LinkedIn, numéro de téléphone
<Note>Le nom de champ `id` est réservé à l'ID interne de Twenty. Utilisez un nom différent comme `externalId` ou `legacyId` pour les identifiants externes.</Note>
## Comportement de l'importation
### Création de nouveaux enregistrements
Si la valeur d'un champ unique n'existe pas, un nouvel enregistrement est créé.
### Mise à jour des enregistrements existants
Si la valeur d'un champ unique correspond à un enregistrement existant, cet enregistrement est **mis à jour** avec les nouvelles données.
<Warning>Pour **mettre à jour des enregistrements existants**, il est recommandé de **ne faire correspondre qu'un seul champ unique**.</Warning>
### Enregistrements supprimés de manière logique
<Warning>
**Les enregistrements supprimés de manière logique comptent pour l'unicité.**
Les enregistrements supprimés de manière logique (visibles sous Menu Commandes → Voir les enregistrements supprimés) sont inclus dans les vérifications d'unicité. Si vous importez un enregistrement avec la même valeur unique qu'un enregistrement supprimé, l'enregistrement supprimé sera **restauré** avec les nouvelles données.
</Warning>
## Détection des doublons lors de l'importation
Pendant la phase de validation :
* Les doublons dans votre fichier sont surlignés en jaune
* Vous pouvez modifier ou supprimer les lignes en double depuis l'interface avant de lancer l'importation
<VimeoEmbed videoId="1145246326" title="Démonstration vidéo" />
## Meilleures pratiques
1. **Supprimez les doublons** de votre fichier avant l'importation
2. **Vérifiez les enregistrements existants** dans Twenty avant l'importation
3. **Utilisez des ID externes** lors de la migration depuis d'autres systèmes
4. **Incluez des champs uniques** si vous souhaitez mettre à jour des enregistrements existants

View File

@@ -0,0 +1,32 @@
---
title: Exporter la FAQ
description: Foire aux questions sur l'exportation des données.
---
<AccordionGroup>
<Accordion title="Pouvons-nous exporter toutes les données de l'espace de travail avant d'annuler, y compris les objets personnalisés, les champs personnalisés, les relations, les notes, les tâches, les opportunités, les pièces jointes, les workflows, les autorisations et l'historique d'audit ?">
Les données de l'espace de travail peuvent être exportées avant l'annulation à certaines exceptions : les tableaux de bord, les workflows et les autorisations doivent être transférés manuellement; les journaux d'audit ne peuvent pas être transférés.
</Accordion>
<Accordion title="Quels éléments ne peuvent actuellement pas être exportés ou migrés ?">
La plupart des éléments peuvent être exportés ou migrés avec quelques exceptions :
* workflows, tableaux de bord et tous les paramètres (clés API, webhooks, journaux d'audit, paramètres de l'utilisateur, etc.) doit être migré manuellement
* les objets et les champs créés par des applications peuvent être migrés en installant cette application dans un autre espace de travail. Ils ne devraient pas être migrés manuellement
* certains enregistrements, comme les versions de workflow et les exécutions de workflow, ne sont pas transférables du tout et devraient être perdus
* certains objets comme les messages et les objets liés au calendrier ne doivent pas être exportés car ils sont créés lorsqu'un compte est connecté et synchronisé périodiquement. Ils seront à nouveau synchronisés une fois que vous aurez connecté votre compte (tant que vous aurez accès à ce compte, si c'est un compte d'un membre de l'équipe qui a quitté votre entreprise, alors ces messages doivent être exportés, sinon ils seront perdus)
</Accordion>
<Accordion title="Existe-t-il un nuage officiel à une procédure de migration autonome ou un service de migration assistée ?">
À l'heure actuelle, il n'existe pas de procédure officielle de migration du nuage à l'auto-hébergement. L'idée générale est de :
* tout d'abord, installez des applications pour introduire des objets et des champs appartenant à des applications
* répliquer les objets personnalisés et les champs ajoutés par les utilisateurs
* utiliser un script avec des clés API ou des outils AI pour migrer toutes les données d'un espace de travail vers un autre
* tous les objets non transférables doivent être migrés manuellement
Sachez quelques choses:
* vous pouvez envoyer jusqu'à 50 demandes par minute sur le plan Pro ou 100 demandes par minute sur le plan de l'organisation avant de toucher une limite de requête/min
* chaque requête API peut avoir jusqu'à 200 enregistrements
* certaines données dans les champs comme Créé par, Activités de la timeline et Mis à jour par seront perdues pendant l'importation et écrasées par le système
</Accordion>
<Accordion title="Les fichiers exportés sont-ils fournis dans des formats ouverts et documentés ?">
Les fichiers exportés dans l'interface utilisateur sont au format Excel, et toutes les requêtes API peuvent être enregistrées au format JSON.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,209 @@
---
title: Exportez vos données
description: Guide complet étape par étape pour exporter des données depuis Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Vue d'ensemble
Exportez les données de votre espace de travail en CSV pour des sauvegardes, des rapports ou des migrations.
**Cas d'utilisation :**
* **Sauvegardes régulières** — conservez des copies de vos données
* **Reporting externe** — analysez les données dans Excel, Google Sheets ou des outils de BI
* **Migration** — déplacez les données vers un autre système
* **Mises à jour en masse** — exportez, modifiez et réimportez pour mettre à jour les enregistrements
## Ce que vous devez savoir
### Limites d'exportation
* **20 000 enregistrements maximum** par export
* Seules les **colonnes visibles** sont exportées
* Seuls les **enregistrements filtrés** sont exportés (selon votre vue actuelle)
<Note>Pour des exports plus volumineux (plus de 20 000 enregistrements), utilisez des filtres pour exporter par lots ou utilisez l'[API](/l/fr/developers/extend/api).</Note>
### Autorisations
Vous avez besoin de l'autorisation **"Export CSV"** pour exporter des données. Contactez l'administrateur de votre espace de travail si vous n'avez pas cette option.
## Étape 1 : Accédez à l'objet
Accédez à l'objet que vous souhaitez exporter :
* **People** — pour les contacts
* **Companies** — pour les organisations
* **Opportunities** — pour les affaires
* **Objets personnalisés** — tout objet que vous avez créé
## Étape 2 : Configurez votre vue
**Important :** L'export n'inclut que ce qui est visible dans votre vue actuelle.
### Ajouter/Supprimer des colonnes
1. Cliquez sur **Options → Fields** (ou sur le **+** à la fin des colonnes)
2. Cochez les champs que vous souhaitez exporter
3. Décochez les champs dont vous n'avez pas besoin
### Filtrer les enregistrements (optionnel)
Si vous avez seulement besoin d'un sous-ensemble de données :
1. Cliquez sur **Filter**
2. Ajoutez des conditions de filtrage (p. ex. "Created date > January 1, 2024")
3. Seuls les enregistrements correspondants seront exportés
### Trier les enregistrements (optionnel)
1. Cliquez sur l'en-tête d'une colonne pour trier
2. L'export respectera votre ordre de tri
<Note>**Créez une vue dédiée à l'export.** Enregistrez une vue spécialement configurée pour les exports afin d'éviter de reconfigurer à chaque fois.</Note>
## Étape 3 : Exportez les données
1. Cliquez sur l'icône **⋮** en haut à droite du tableau
2. Sélectionnez **Export view**
3. Choisissez où enregistrer le fichier CSV
4. Attendez la fin du téléchargement
## Ce qui est exporté
| Inclus | Non inclus |
| ------------------------------------------------- | -------------------------------------- |
| Toutes les colonnes visibles | Colonnes masquées |
| Enregistrements correspondant aux filtres actuels | Enregistrements exclus par les filtres |
| Valeurs des champs personnalisés | Champs non présents dans la vue |
| ID des enregistrements | Fichiers joints |
| ID des relations | Images |
### Champs de relation
Les ID de relations ne sont exportés que du côté **"many"** d'une relation :
* **L'export People** inclut une colonne `companyId` (relation People → Company)
* **L'export Companies** n'inclut PAS `peopleIds` (Companies est le côté "one")
Cela signifie que vous pouvez utiliser l'export People pour réimporter et conserver le lien avec Company, mais vous devrez réimporter People après Companies pour recréer les relations.
## Exporter pour des besoins spécifiques
### Pour les sauvegardes
1. Créez une vue avec **tous les champs** visibles
2. Retirez tous les filtres pour inclure tous les enregistrements
3. Exportez chaque type d'objet séparément
4. Stockez les exports dans un emplacement sécurisé
5. Définissez un rappel récurrent (hebdomadaire/mensuel)
### Pour le reporting externe
1. N'incluez que les champs nécessaires à l'analyse
2. Appliquez des filtres pour vous concentrer sur les données pertinentes
3. Envisagez de trier selon le champ que vous analyserez
### Pour les mises à jour en masse
1. Exportez les enregistrements que vous souhaitez mettre à jour
2. Incluez l'identifiant unique (`email`, `domain` ou `id`)
3. Modifiez le fichier exporté
4. Réimportez pour mettre à jour les enregistrements
Voir : [Comment mettre à jour des enregistrements existants](/l/fr/user-guide/data-migration/how-tos/update-existing-records-via-import)
### Pour la migration
Si vous exportez pour migrer vers un autre système :
1. **Exportez chaque objet séparément** — People, Companies, Opportunities, etc.
2. **Incluez les champs d'ID** — ils aident à maintenir les relations
3. **Documentez les correspondances de champs** — notez comment les champs Twenty sont mis en correspondance avec votre système cible
## Gestion de grands jeux de données (plus de 20 000 enregistrements)
La limite d'export est de 20 000 enregistrements. Pour des jeux de données plus volumineux :
### Option 1 : Exporter par lots
1. Ajoutez un filtre (p. ex. des plages de "Created date")
2. Exportez le premier lot
3. Modifiez le filtre
4. Exportez le lot suivant
5. Combinez les fichiers dans votre feuille de calcul
**Exemples de filtres pour le traitement par lots :**
* Par plage de dates (janvier, février, mars...)
* Par propriétaire (membre de l'équipe A, membre de l'équipe B...)
* Par statut (Actif, Inactif...)
### Option 2 : Utiliser l'API
L'API n'a pas de limite d'enregistrements :
1. Récupérez votre clé API depuis **Settings → Developers**
2. Utilisez l'API GraphQL pour interroger les enregistrements
3. Traitez les résultats dans votre application
Voir : [Documentation de l'API](/l/fr/developers/extend/api)
## Conseils et bonnes pratiques
### Créez des vues d'export
Enregistrez des vues configurées spécifiquement pour les exports :
1. Configurez les colonnes et les filtres
2. Cliquez sur **View options** → **Save as new view**
3. Nommez-la "Export - [Purpose]"
### Sécurisez vos exports
Les fichiers exportés peuvent contenir des données sensibles :
* Stockez-les dans des emplacements sécurisés
* Supprimez les anciens exports lorsqu'ils ne sont plus nécessaires
* Soyez prudent lors du partage des fichiers d'export
### À vérifier avant l'export
<Check>Les colonnes appropriées sont visibles</Check>
<Check>Les filtres sont correctement définis (ou supprimés pour un export complet)</Check>
<Check>Vous disposez de l'autorisation d'export</Check>
## FAQ
<AccordionGroup>
<Accordion title="Pourquoi certaines colonnes manquent-elles dans mon export ?">
Seules les colonnes visibles sont exportées. Ajoutez les colonnes nécessaires via **Options → Fields** avant d'exporter.
</Accordion>
<Accordion title="Pourquoi mon export ne contient-il pas tous les enregistrements ?">
Vérifiez vos filtres. L'export n'inclut que les enregistrements correspondant aux filtres de votre vue actuelle. Supprimez les filtres pour exporter tous les enregistrements.
</Accordion>
<Accordion title="Puis-je exporter plus de 20 000 enregistrements ?">
Pas en un seul export. Utilisez des filtres pour exporter par lots, ou utilisez l'API pour des jeux de données plus volumineux.
</Accordion>
<Accordion title="Quel est le format du fichier d'export ?">
CSV (valeurs séparées par des virgules). S'ouvre dans Excel, Google Sheets ou toute application de feuille de calcul.
</Accordion>
<Accordion title="Les ID de relations sont-ils inclus ?">
Oui, mais seulement du côté "many" des relations. Par exemple, un export People inclut `companyId`, mais un export Companies n'inclut pas les ID des personnes.
</Accordion>
<Accordion title="Puis-je automatiser les exports ?">
Pas directement via l'interface utilisateur. Utilisez l'API pour créer des workflows d'export automatisés.
</Accordion>
</AccordionGroup>
## Prochaines étapes
* [Comment mettre à jour des enregistrements existants](/l/fr/user-guide/data-migration/how-tos/update-existing-records-via-import) — modifiez et réimportez votre export
* [Comment importer des données via l'API](/l/fr/user-guide/data-migration/how-tos/import-data-via-api) — pour de grands jeux de données
* [Documentation de l'API](/l/fr/developers/extend/api) — créez des flux de travail d'exportation personnalisés

View File

@@ -0,0 +1,430 @@
---
title: Corriger les erreurs d'importation
description: Guide de dépannage complet pour résoudre les erreurs d'importation CSV.
---
## Vue d'ensemble
L'importation ne fonctionne pas ? Ce guide vous aide, étape par étape, à identifier et à corriger les erreurs d'importation courantes.
## Comment fonctionne la validation de l'importation
Après avoir téléversé votre fichier et fait la correspondance des colonnes, Twenty valide vos données :
1. **Exécution de la validation** — Twenty vérifie chaque ligne pour détecter des erreurs
2. **Les erreurs sont mises en évidence** — les lignes problématiques apparaissent en **jaune**
3. **Vous pouvez corriger sur place** — modifiez les cellules directement dans l'interface d'importation
4. **Ou supprimer des lignes** — ignorez complètement les enregistrements problématiques
<Note>**Corrigez les erreurs dans l'interface.** Vous n'avez pas besoin de revenir à votre feuille de calcul. Modifiez les cellules directement pendant l'importation pour gagner du temps.</Note>
## Dépannage étape par étape
### Étape 1 : Identifier le type d'erreur
Cliquez sur une ligne surlignée pour voir le message d'erreur spécifique. Types d'erreurs courants :
| Message d'erreur | Ce que cela signifie |
| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Valeurs en double surlignées en jaune | La valeur existe déjà dans Twenty ou apparaît deux fois dans votre fichier |
| `{field} is not a valid {type}` (survolez la cellule jaune) | Les données ne correspondent pas au format attendu |
| Champ obligatoire surligné | Un champ obligatoire est vide |
| `Can't connect to {object}. No unique record found...` (l'importation échoue) | L'enregistrement référencé n'existe pas |
| `Too many records. Up to 10000 allowed` (téléversement bloqué) | Le fichier contient plus de 10 000 enregistrements |
### Étape 2 : Corriger l'erreur
Suivez les instructions spécifiques ci-dessous pour chaque type d'erreur.
---
## Erreur : Valeur en double
### Ce que vous verrez
Les lignes avec des valeurs en double sont **surlignées en jaune** dans l'interface d'importation avant le début de l'importation.
### Ce que cela signifie
Un champ unique (e-mail, domaine) :
* Existe déjà dans Twenty
* Apparaît deux fois dans votre fichier
### Comment corriger
**Option 1 : Modifier la valeur en double**
1. Cliquez sur la cellule contenant l'erreur
2. Remplacez par une valeur unique
3. Continuer l'importation
**Option 2 : Supprimer la ligne en double**
1. Cliquez sur le X à côté de la ligne
2. La ligne sera ignorée pendant l'importation
**Option 3 : Laisser Twenty mettre à jour l'enregistrement existant**
1. Assurez-vous que votre fichier inclut un identifiant unique (`email`, `domain` ou `id`)
2. Faites correspondre le champ d'identifiant unique
3. Twenty mettra à jour l'enregistrement existant au lieu de créer un doublon
<Note>
**Vous pouvez aussi mettre à jour les champs uniques.**
* Si vous conservez l'`id` mais changez l'`email` → l'adresse e-mail sera mise à jour
* Si vous conservez l'`email` mais changez l'`id` → l'id sera mis à jour
Tant qu'un identifiant unique correspond, Twenty met à jour l'enregistrement.
</Note>
### Comment éviter cette erreur
Avant l'importation :
1. Triez votre feuille de calcul par le champ unique
2. Supprimez les lignes en double
3. Vérifiez si des enregistrements existent déjà dans Twenty
<Warning>
**Les enregistrements supprimés de façon logique comptent pour l'unicité.**
Vérifiez le menu Commande → Voir les enregistrements supprimés. Les enregistrements qui s'y trouvent imposent toujours l'unicité. Supprimez-les définitivement ou restaurez-les et mettez-les à jour.
</Warning>
Pour plus de détails : [Contraintes d'unicité](/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints)
---
## Erreur : Format invalide
### Ce que vous verrez
La valeur de la cellule est surlignée en jaune. Survolez-la pour voir le message d'erreur :
```
{field name} is not a valid {field type}
```
### Ce que cela signifie
Les données ne correspondent pas au format attendu pour ce type de champ.
### Comment corriger — selon le type de champ
#### E-mail
**Problème :** Format d'e-mail invalide
**Solution :** Utilisez le format `name@domain.com`
```
❌ john.smith@
❌ john smith@acme.com
✓ john.smith@acme.com
```
#### Domaine
**Problème :** Un format incohérent peut provoquer des doublons
**Solution :** Utilisez le format `https://domain.com` (recommandé)
```
⚠️ acme.com (valid, but not recommended)
⚠️ www.acme.com (valid, but not recommended)
✅ https://acme.com (recommended)
```
<Note>Tous les formats sont valides, mais `https://domain.com` est recommandé car il correspond au format utilisé par la synchronisation e-mail/calendrier. L'utilisation d'autres formats peut créer des entreprises en double.</Note>
#### Date
**Problème :** Format de date non reconnu
**Solution :** Utilisez le format `YYYY-MM-DD` de façon cohérente dans tout le fichier
```
✓ 2024-03-15 (YYYY-MM-DD)
❌ 03/15/2024 (MM/DD/YYYY)
❌ 15/03/2024 (DD/MM/YYYY)
```
#### Téléphone
**Problème :** Colonnes obligatoires manquantes
**Solution :** Incluez toutes les colonnes de téléphone
| Colonne | Exemple |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number** | `4159095555` |
| **Phones / Primary Phone Country Code** | `US` |
| **Phones / Primary Phone Calling Code** | `+1` |
#### Booléen
**Problème :** Valeur booléenne incorrecte
**Solution :** Utilisez `TRUE` ou `FALSE` en majuscules
```
❌ true
❌ yes
❌ 1
✓ TRUE
✓ FALSE
```
#### Sélection / Sélection multiple
**Problème :** La valeur ne correspond pas aux options existantes
**Solution :** Utilisez les **noms d'API**, pas les libellés d'affichage
Comment trouver les noms d'API :
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez l'objet et le champ
3. Activez le **mode avancé** (bouton à bascule en bas à droite)
4. Utilisez le nom d'API (p. ex., `OPTION_1`, pas "Option 1")
```
❌ High Priority
✓ HIGH_PRIORITY
```
#### Devise
**Problème :** Montant ou code de devise manquant
**Solution :** Renseignez les deux colonnes
| Colonne | Exemple |
| --------------------- | --------- |
| **Amount / Amount** | `1234.56` |
| **Amount / Currency** | `USD` |
#### Nombre
**Problème :** Caractères non numériques
**Solution :** Chiffres uniquement, point pour les décimales
```
❌ $1,234.56
❌ 1,234.56
✓ 1234.56
```
Pour la référence complète des formats : [Correspondance des champs](/l/fr/user-guide/data-migration/capabilities/field-mapping)
---
## Erreur : Champ obligatoire manquant
### Ce que vous verrez
La ligne est surlignée en jaune et la cellule du champ obligatoire est indiquée.
### Ce que cela signifie
Un champ obligatoire est vide pour cette ligne.
### Comment corriger
**Option 1 : Saisir une valeur**
1. Cliquez sur la cellule vide
2. Saisissez une valeur
3. Continuer l'importation
**Option 2 : Supprimer la ligne**
1. Si vous n'avez pas les données, cliquez sur X pour ignorer la ligne
### Comment éviter cette erreur
Avant l'importation, identifiez les champs obligatoires :
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez votre objet
3. Vérifiez quels champs sont marqués comme obligatoires
---
## Erreur : Relation introuvable
### Ce que vous verrez
Cette erreur apparaît **après le début de l'importation** — l'importation échoue avec un message comme :
```
Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f
```
Cela signifie qu'il n'existe aucune entreprise dans Twenty avec cet identifiant précis.
<Note>Contrairement aux autres erreurs, celle-ci n'est pas détectée lors de l'étape de révision des données. L'importation commencera puis échouera lorsqu'elle rencontrera la relation manquante.</Note>
### Ce que cela signifie
Vous essayez de lier un enregistrement qui n'existe pas dans Twenty.
### Comment corriger
**Option 1 : Importer d'abord les enregistrements parents**
1. Annulez l'importation en cours
2. Importez les enregistrements parents (p. ex., Entreprises)
3. Importez ensuite les enregistrements enfants (p. ex., Personnes)
**Option 2 : Corriger la valeur de référence**
1. Vérifiez la valeur de référence dans votre fichier
2. Assurez-vous qu'elle correspond exactement à un enregistrement existant
3. Vérifiez le format : les domaines doivent être `https://domain.com`
**Option 3 : Supprimer la relation**
1. Effacez la cellule pour importer sans la relation
2. Ajoutez la relation manuellement plus tard
### Comment éviter cette erreur
1. **Importez dans le bon ordre :**
* Entreprises en premier
* Personnes ensuite (avec références à l'entreprise)
* Opportunités en troisième
2. **Vérifiez les valeurs de référence :**
* Exportez les enregistrements parents pour obtenir les identifiants exacts
* Utilisez le format de domaine `https://domain.com`
* Vérifiez les fautes de frappe et la casse
<Warning>
**L'importation échouera si une référence est faite à un enregistrement inexistant.**
Importez toujours les objets parents avant les objets enfants.
</Warning>
Pour plus de détails : [Import des relations](/l/fr/user-guide/data-migration/capabilities/import-relations)
---
## Erreur : Fichier trop volumineux
### Ce que vous verrez
Cette erreur apparaît **lors du téléversement de votre fichier** — le téléversement est entièrement bloqué :
```
Too many records. Up to 10000 allowed
```
Vous ne pourrez pas passer à l'étape de révision des données tant que vous n'aurez pas réduit la taille du fichier.
### Ce que cela signifie
Votre fichier contient plus de 10 000 enregistrements.
### Comment corriger
**Option 1 : Fractionner en plusieurs fichiers**
1. Divisez vos données en fichiers de 10 000 enregistrements ou moins
2. Importez chaque fichier séparément
3. Conservez l'ordre d'importation (Entreprises avant Personnes)
**Option 2 : Utiliser l'import via l'API**
Pour de très grands jeux de données, utilisez l'API qui n'a pas de limite d'enregistrements.
Voir : [Comment importer des données via l'API](/l/fr/user-guide/data-migration/how-tos/import-data-via-api)
---
## Erreur : Champ non reconnu
### Ce que cela signifie
Une colonne de votre fichier ne peut pas être mise en correspondance car le champ n'existe pas dans Twenty.
### Comment corriger
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez l'objet que vous importez
3. Cliquez sur **+ Add field**
4. Créez le champ personnalisé avec le type approprié
5. Téléversez de nouveau votre fichier
<Note>L'import CSV crée des enregistrements, pas des champs. Tous les champs doivent exister avant l'importation.</Note>
---
## Erreur : Relation utilisateur vide
### Ce que cela signifie
Vous essayez d'assigner un enregistrement à un utilisateur (Propriétaire, Assignataire) mais la relation n'est pas mise en correspondance.
### Causes courantes
1. **L'utilisateur n'a pas accepté son invitation** — l'utilisateur n'existe pas encore dans Twenty
2. **Utilisation de l'ID utilisateur de l'ancien système** — Twenty ne peut pas faire correspondre les ID d'un autre système
3. **Format d'e-mail incorrect** — l'adresse e-mail ne correspond pas au compte Twenty de l'utilisateur
### Comment corriger
1. Assurez-vous que tous les utilisateurs ont **accepté leur invitation** à votre espace de travail Twenty
2. Utilisez l'**adresse e-mail** de l'utilisateur (pas son nom ni l'ID de l'ancien système)
3. Utilisez la même adresse e-mail que celle utilisée pour rejoindre Twenty
<Warning>
**Les utilisateurs doivent accepter les invitations avant l'importation.**
Si un utilisateur n'a pas accepté son invitation, les enregistrements qui s'y réfèrent auront des relations utilisateur vides.
</Warning>
---
## Liste de vérification avant l'importation
Évitez les erreurs en vérifiant ces éléments avant l'importation :
### Exigences relatives au fichier
<Check>Le fichier est au format CSV, XLSX ou XLS</Check>
<Check>Le fichier contient moins de 10 000 enregistrements</Check>
<Check>Le fichier utilise l'encodage UTF-8</Check>
### Qualité des données
<Check>Aucune adresse e-mail en double (pour Personnes)</Check>
<Check>Aucun domaine en double (pour Entreprises)</Check>
<Check>Toutes les dates utilisent un format cohérent</Check>
<Check>Tous les domaines utilisent le format `https://domain.com`</Check>
### Formats des champs
<Check>Les champs booléens utilisent `TRUE` ou `FALSE` (majuscules)</Check>
<Check>Les champs de sélection utilisent les noms d'API, pas les libellés d'affichage</Check>
<Check>Les champs de téléphone ont toutes les colonnes requises</Check>
<Check>Les champs de devise ont à la fois Montant et Code de devise</Check>
### Relations
<Check>Enregistrements parents importés avant les enregistrements enfants</Check>
<Check>Les colonnes de relation font référence à des enregistrements existants</Check>
<Check>Le format de domaine correspond exactement au format de Twenty</Check>
### Modèle de données
<Check>Tous les champs personnalisés existent dans Paramètres → Modèle de données</Check>
<Check>Les options de sélection existent avant l'importation</Check>
---
## Vous avez encore des problèmes ?
Si vous avez essayé les solutions ci-dessus :
1. **Téléchargez le fichier d'exemple** — voyez le format exact attendu par Twenty
2. **Exportez les enregistrements existants** — comparez votre fichier à des données fonctionnelles
3. **Testez avec un petit lot** — essayez d'abord 5 à 10 lignes
4. **Consultez les articles de référence :**
* [Correspondance des champs](/l/fr/user-guide/data-migration/capabilities/field-mapping)
* [Contraintes d'unicité](/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints)
* [Import des relations](/l/fr/user-guide/data-migration/capabilities/import-relations)
* [Gestion des erreurs](/l/fr/user-guide/data-migration/capabilities/error-handling)

View File

@@ -0,0 +1,201 @@
---
title: Importer des entreprises via CSV
description: Guide complet étape par étape pour importer des entreprises dans Twenty.
---
## Vue d'ensemble
Ce guide vous accompagne pour importer vos entreprises dans Twenty. **Les entreprises doivent être importées en premier** car les Personnes et les Opportunités sont liées aux Entreprises.
## Avant de démarrer
### Liste de vérification des prérequis
<Check>
Votre fichier est au format CSV, XLSX ou XLS
</Check>
<Check>
Le fichier contient moins de 10 000 enregistrements
</Check>
<Check>
Aucun domaine en double dans votre fichier
</Check>
<Check>
Tous les champs personnalisés existent dans **Paramètres → Modèle de données**
</Check>
<Note>
Besoin d'importer plus de 10 000 entreprises ? Divisez en plusieurs fichiers ou utilisez l’[importation via l’API](/l/fr/user-guide/data-migration/how-tos/import-data-via-api).
</Note>
## Étape 1 : Préparer vos données d'entreprises
### Champs obligatoires et recommandés
| Champ | Obligatoire ? | Format | Notes |
| ------------------------ | ------------- | -------------------- | -------------------------------------- |
| **Nom** | Recommandé | Texte | Nom d'affichage de l'entreprise |
| **Domaine** | Recommandé | `https://domain.com` | Identifiant unique |
| **Adresse** | Facultatif | Plusieurs colonnes | Voir ci-dessous |
| **Employés** | Facultatif | Nombre | Nombre d'employés |
| **Champs personnalisés** | Facultatif | Variable | Doit exister dans le Modèle de données |
### Format du domaine
<Warning>
**Utilisez le format `https://domain.com` pour les domaines.**
Cela correspond au format utilisé lorsque des entreprises sont créées automatiquement à partir de la synchronisation e-mail/calendrier, ce qui évite les doublons par la suite.
</Warning>
**Colonnes de domaine :**
* **Domaine / Libellé du domaine** : `acme.com`
* **Domaine / URL du domaine** : `https://acme.com`
### Format de l'adresse
L'adresse est un champ imbriqué avec plusieurs colonnes :
```
Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
123 Main Street,San Francisco,CA,USA,94105
```
### Exemple de structure CSV
```csv
name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
Widget Co,https://widgets.co,widgets.co,New York,USA,50
```
<Note>
**Astuce :** Cliquez sur **Télécharger le fichier d'exemple** lors de l'import pour voir les noms de colonnes exacts attendus par Twenty.
</Note>
## Étape 2 : Accéder à la fonction d'importation
**Option 1 : Depuis la vue Entreprises**
1. Accédez à **Entreprises** dans la barre latérale gauche
2. Cliquez sur l'icône **⋮** en haut à droite
3. Sélectionnez **Importer des enregistrements**
**Option 2 : Utiliser le menu de commandes**
1. Appuyez sur `Cmd + K` (Mac) ou `Ctrl + K` (Windows)
2. Tapez "import"
3. Sélectionnez **Importer des enregistrements**
4. Choisissez **Entreprises**
## Étape 3 : Téléverser votre fichier
1. Cliquez sur **Sélectionner un fichier**
2. Choisissez votre fichier CSV, XLSX ou XLS
3. Attendez que Twenty analyse votre fichier
## Étape 4 : Associer vos colonnes
Twenty tente automatiquement d'associer vos colonnes aux champs. Vérifiez et ajustez :
1. **Vérifiez les correspondances automatiques** — assurez-vous qu'elles sont correctes
2. **Corrigez les correspondances incorrectes** — cliquez sur la liste déroulante pour sélectionner le bon champ
3. **Ignorer des colonnes** — sélectionnez **Do not map** pour les colonnes que vous ne souhaitez pas importer
### Règles de mappage importantes
* **Domaine** : Associez à **Domaine / URL du domaine** (et non au Libellé du domaine)
* **Adresse** : Associez chaque partie à sa colonne spécifique (Ville, État, etc.)
* **Champs de sélection** : les valeurs doivent correspondre aux options existantes (ou vous les associerez à l'étape suivante)
<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
## Étape 5 : Faire correspondre les valeurs des champs de sélection
Si vous avez des champs Sélection ou Multi-sélection :
1. Twenty affiche vos valeurs à côté des options existantes
2. Faites correspondre chaque valeur de votre fichier à une option Twenty
3. Ou créez de nouvelles options si nécessaire
<Note>
Les options de sélection utilisent les **noms d'API**, pas les libellés d'affichage. Accédez à **Paramètres → Modèle de données** → activez le **Mode avancé** pour voir les noms d'API.
</Note>
## Étape 6 : Examiner et corriger les erreurs
Avant de terminer l'import, Twenty valide vos données :
1. Cliquez sur **Prochaines étapes**
2. Les lignes comportant des erreurs sont mises en évidence en **jaune**
3. **Corrigez les erreurs directement** — cliquez sur une cellule et modifiez la valeur
4. **Supprimez les lignes problématiques** — cliquez sur le X pour ignorer cette ligne
### Erreurs courantes lors de l'import d'entreprises
| Erreur | Cause | Solution |
| ------------------------------ | ---------------------------------- | ------------------------------------------------------------------ |
| **Domaine en double** | Le domaine existe déjà dans Twenty | Supprimez-le du fichier ou mettez à jour l'enregistrement existant |
| **Format de domaine invalide** | Mauvais format | Utilisez `https://domain.com` |
| **Champ obligatoire manquant** | Le champ obligatoire est vide | Renseignez la valeur ou supprimez la ligne |
## Étape 7 : Finaliser l'import
1. Vérifiez le récapitulatif de l'import
2. Cliquez sur **Confirmer** pour importer
3. Attendez la fin de l'import
4. Vérifiez en examinant quelques enregistrements
## Après l'import des entreprises
Vous pouvez maintenant importer des enregistrements liés aux entreprises :
1. **[Importer des personnes](/l/fr/user-guide/data-migration/how-tos/import-contacts-via-csv)** — liez-les aux entreprises à l'aide du domaine
2. **Importez des opportunités** — liez-les aux entreprises
3. **Vérifiez l'import** — faites un contrôle ponctuel de quelques enregistrements pour vous assurer que les données sont correctes
## Mise à jour des entreprises existantes
Pour mettre à jour des entreprises au lieu d'en créer de nouvelles :
1. Incluez la colonne `domain` ou `id` dans votre fichier
2. Twenty fait correspondre les enregistrements à partir de cet identifiant unique
3. Les entreprises existantes sont mises à jour ; les nouvelles sont créées
Voir [Comment mettre à jour des enregistrements existants](/l/fr/user-guide/data-migration/how-tos/update-existing-records-via-import) pour plus de détails.
## FAQ
<AccordionGroup>
<Accordion title="Pourquoi deux entreprises ne peuvent-elles pas avoir le même domaine ?">
Le domaine est un identifiant unique dans Twenty. Cela évite les entreprises en double et garantit que la synchronisation des e-mails associe correctement les e-mails à la bonne entreprise.
</Accordion>
<Accordion title="Que faire si j'ai des entreprises sans domaine ?">
Vous pouvez laisser le domaine vide. Cependant, nous recommandons d'ajouter des domaines lorsque c'est possible pour une meilleure qualité des données et une liaison automatique des e-mails.
</Accordion>
<Accordion title="Puis-je importer des entreprises sans aucune personne liée ?">
Oui! Vous pouvez d'abord importer des entreprises, puis importer des Personnes plus tard et les lier en utilisant le domaine de l'entreprise.
</Accordion>
<Accordion title="Que se passe-t-il si j'importe un domaine qui existe déjà ?">
Si vous incluez un identifiant unique (domaine ou id) correspondant à une entreprise existante, Twenty met à jour cette entreprise au lieu de créer un doublon.
</Accordion>
<Accordion title="Comment corriger les erreurs 'duplicate domain' ?">
Supprimez le doublon de votre fichier ou incluez l'`id` de l'entreprise pour mettre à jour l'enregistrement existant.
</Accordion>
</AccordionGroup>
## Résolution des problèmes
Vous rencontrez des problèmes ? Consultez :
* [Comment corriger les erreurs d'import](/l/fr/user-guide/data-migration/how-tos/fix-import-errors)
* [Référence de correspondance des champs](/l/fr/user-guide/data-migration/capabilities/field-mapping)
* [Contraintes d'unicité](/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints)

View File

@@ -0,0 +1,242 @@
---
title: Importer des contacts via CSV
description: Guide complet étape par étape pour importer des personnes/contacts dans Twenty.
---
## Vue d'ensemble
Ce guide vous accompagne pour importer vos contacts (Personnes) dans Twenty.
## Avant de démarrer
### Liste de vérification des prérequis
<Check>
Votre fichier est au format CSV, XLSX ou XLS
</Check>
<Check>
Le fichier contient moins de 10 000 enregistrements
</Check>
<Check>
Aucune adresse e-mail en double dans votre fichier
</Check>
<Check>
**Entreprises importées en premier** (si vous liez des personnes à des entreprises)
</Check>
<Check>
Tous les champs personnalisés existent dans **Paramètres → Modèle de données**
</Check>
<Warning>
**Importer les entreprises avant les personnes**
Si vous souhaitez lier des personnes à des entreprises, importez d'abord les entreprises. L'entreprise doit exister avant que vous puissiez y faire référence.
</Warning>
## Étape 1 : Préparer vos données de contacts
### Champs obligatoires et recommandés
| Champ | Obligatoire ? | Format | Notes |
| ------------------------ | ------------- | ------------------ | -------------------------------------- |
| **Email** | Recommandé | `name@domain.com` | Doit être unique |
| **Prénom** | Recommandé | Texte | |
| **Nom de famille** | Recommandé | Texte | |
| **Entreprise** | Facultatif | Domaine ou ID | Lie à une entreprise existante |
| **Téléphone** | Facultatif | Plusieurs colonnes | Voir ci-dessous |
| **Titre du poste** | Facultatif | Texte | |
| **Champs personnalisés** | Facultatif | Variable | Doit exister dans le Modèle de données |
### Format de l'e-mail
* Doit être un format d'e-mail valide : `name@domain.com`
* **Doit être unique** — aucun doublon dans votre fichier ni dans Twenty
* Pour des e-mails supplémentaires, utilisez la colonne **Emails / Additional Emails** :
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### Format du téléphone
Le téléphone est un **champ imbriqué** nécessitant plusieurs colonnes :
| Colonne | Exemple |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number** | `4159095555` |
| **Phones / Primary Phone Country Code** | `US` |
| **Phones / Primary Phone Calling Code** | `+1` |
### Lier aux entreprises
Ajoutez une colonne contenant l'identifiant unique de l'entreprise :
| Nom de la colonne | Format | Exemple |
| ----------------- | ------------ | -------------------------------------- |
| `companyDomain` | Format d'URL | `https://acme.com` |
| `companyId` | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Note>
**Utilisez le format d'URL de domaine** (`https://acme.com`), pas le libellé. Cela correspond à la façon dont les entreprises sont stockées dans Twenty.
</Note>
### Exemple de structure CSV
```csv
firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
```
<Note>
**Astuce :** Cliquez sur **Télécharger le fichier d'exemple** lors de l'importation ou exportez quelques personnes existantes pour voir les noms de colonnes exacts attendus par Twenty.
</Note>
## Étape 2 : Accéder à la fonction d'importation
**Option 1 : Depuis la vue Personnes**
1. Accédez à **Personnes** dans la barre latérale gauche
2. Cliquez sur l'icône **⋮** en haut à droite
3. Sélectionnez **Importer des enregistrements**
**Option 2 : Utiliser le menu de commandes**
1. Appuyez sur `Cmd + K` (Mac) ou `Ctrl + K` (Windows)
2. Tapez "import"
3. Sélectionnez **Importer des enregistrements**
4. Choisissez **Personnes**
## Étape 3 : Téléverser votre fichier
1. Cliquez sur **Sélectionner un fichier**
2. Choisissez votre fichier CSV, XLSX ou XLS
3. Attendez que Twenty analyse votre fichier
## Étape 4 : Associer vos colonnes
Twenty tente automatiquement d'associer vos colonnes aux champs. Vérifiez et ajustez :
1. **Vérifiez les correspondances automatiques** — assurez-vous qu'elles sont correctes
2. **Corrigez les correspondances incorrectes** — cliquez sur la liste déroulante pour sélectionner le bon champ
3. **Ignorer des colonnes** — sélectionnez **Do not map** pour les colonnes que vous ne souhaitez pas importer
### Règles de mappage importantes
| Type de colonne | Associer à | Notes |
| ----------------------- | -------------------------------- | ----------------------------------------- |
| Référence d'entreprise | Champ de relation **Entreprise** | Utilisez le domaine OU l'ID, pas les deux |
| E-mail | **Email** | Adresse e-mail principale |
| E-mails supplémentaires | **Emails / Additional Emails** | Format de tableau |
| Téléphone | Colonnes séparées | Numéro, Code pays, Indicatif d'appel |
<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
### Mappage de la relation Entreprise
Lors du mappage de la colonne entreprise :
1. Trouvez votre colonne de référence de l'entreprise (par ex. `companyDomain`)
2. Associez-la au champ de relation **Entreprise**
3. Twenty liera chaque personne à l'entreprise correspondante
<Warning>
**N'associez qu'UN SEUL identifiant unique pour les relations.**
Ne mappez pas à la fois `companyId` ET `companyDomain`. Choisissez-en un — de préférence le domaine, car il est lisible par un humain.
</Warning>
## Étape 5 : Faire correspondre les valeurs des champs de sélection
Si vous avez des champs Sélection ou Multi-sélection (comme Source du lead) :
1. Twenty affiche vos valeurs à côté des options existantes
2. Faites correspondre chaque valeur de votre fichier à une option Twenty
3. Ou créez de nouvelles options si nécessaire
<Note>
Les options de sélection utilisent les **noms d'API**, pas les libellés d'affichage. Accédez à **Settings → Data Model** → activez **Advanced mode** pour voir les noms d'API.
</Note>
## Étape 6 : Examiner et corriger les erreurs
Avant de terminer l'import, Twenty valide vos données :
1. Cliquez sur **Prochaines étapes**
2. Les lignes comportant des erreurs sont mises en évidence en **jaune**
3. **Corrigez les erreurs directement** — cliquez sur une cellule et modifiez la valeur
4. **Supprimez les lignes problématiques** — cliquez sur le X pour ignorer cette ligne
### Erreurs courantes lors de l'import de contacts
| Erreur | Cause | Solution |
| ------------------------------------ | ----------------------------------------------------------- | --------------------------------------------------------------- |
| **Adresse e-mail en double** | L'adresse e-mail existe déjà dans Twenty ou dans le fichier | Supprimez le doublon ou mettez à jour l'enregistrement existant |
| **Format d'adresse e-mail invalide** | Format d'adresse e-mail incorrect | Corrigez au format `name@domain.com` |
| **Relation introuvable** | L'entreprise n'existe pas | Importez d'abord les entreprises ou corrigez la référence |
| **Champ obligatoire manquant** | Le champ obligatoire est vide | Renseignez la valeur ou supprimez la ligne |
## Étape 7 : Finaliser l'import
1. Vérifiez le récapitulatif de l'import
2. Cliquez sur **Confirmer** pour importer
3. Attendez la fin de l'import
4. Vérifiez en consultant quelques enregistrements et leurs liens avec l'entreprise
## Après l'import des contacts
Vos contacts sont maintenant dans Twenty ! Prochaines étapes :
1. **Vérifiez les liens avec l'entreprise** — ouvrez quelques enregistrements de personnes pour confirmer qu'ils sont liés à la bonne entreprise
2. **Importez des opportunités** — si nécessaire, liez-les aux personnes et aux entreprises
3. **Configurez la synchronisation des e-mails** — connectez votre boîte mail pour voir l'historique des e-mails sur les enregistrements de contacts
## Mise à jour des contacts existants
Pour mettre à jour des contacts au lieu d'en créer de nouveaux :
1. Incluez la colonne `email` ou `id` dans votre fichier
2. Twenty fait correspondre les enregistrements à partir de cet identifiant unique
3. Les contacts existants sont mis à jour ; les nouveaux sont créés
Voir [Comment mettre à jour des enregistrements existants](/l/fr/user-guide/data-migration/how-tos/update-existing-records-via-import) pour plus de détails.
## FAQ
<AccordionGroup>
<Accordion title="Pourquoi deux personnes ne peuvent-elles pas avoir la même adresse e-mail ?">
L'adresse e-mail est un identifiant unique dans Twenty. Cela évite les contacts en double et garantit que la synchronisation des e-mails associe correctement les e-mails à la bonne personne.
</Accordion>
<Accordion title="Que faire si j'ai des personnes sans adresse e-mail ?">
Vous pouvez laisser l'adresse e-mail vide. Cependant, nous recommandons d'ajouter des adresses e-mail lorsque c'est possible pour une meilleure qualité des données et une synchronisation des e-mails plus efficace.
</Accordion>
<Accordion title="Comment lier des personnes à des entreprises lors de l'import ?">
Ajoutez une colonne avec le domaine de l'entreprise (par exemple, `https://acme.com`) ou l'ID. Lors du mapping, connectez cette colonne au champ de relation Entreprise.
</Accordion>
<Accordion title="Que faire si l'entreprise n'existe pas encore ?">
Importez d'abord les entreprises, puis importez les personnes. L'entreprise doit exister avant que vous ne puissiez y faire référence.
</Accordion>
<Accordion title="Puis-je importer l'ID depuis mon CRM précédent ?">
Oui! Créez un champ personnalisé marqué comme "unique" dans votre modèle de données pour stocker l'ID externe. Remarque : le nom de champ `id` est réservé à l'ID interne de Twenty.
</Accordion>
<Accordion title="Comment corriger les erreurs 'relation not found' ?">
L'entreprise à laquelle vous faites référence n'existe pas. Soit importez d'abord l'entreprise, soit vérifiez que le domaine/l'ID correspond exactement à une entreprise existante.
</Accordion>
</AccordionGroup>
## Résolution des problèmes
Des problèmes ? Consultez :
* [Comment corriger les erreurs d'import](/l/fr/user-guide/data-migration/how-tos/fix-import-errors)
* [Comment importer des relations](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [Référence de correspondance des champs](/l/fr/user-guide/data-migration/capabilities/field-mapping)

View File

@@ -0,0 +1,176 @@
---
title: Importer des données via l'API
description: Quand et comment utiliser les API de Twenty pour des importations de données à grande échelle.
---
## Vue d'ensemble
Twenty propose des **API GraphQL** et **REST** pour l'importation programmatique de données. Utilisez l'API lorsque l'importation CSV n'est pas pratique pour votre volume de données ou lorsque vous avez besoin d'importations automatisées et récurrentes.
## Quand utiliser l'importation via l'API
| Scénario | Méthode recommandée |
| -------------------------------------- | ----------------------------------------------- |
| Moins de 10 000 enregistrements | Importation CSV |
| 10 000 - 50 000 enregistrements | Importation CSV (divisée en plusieurs fichiers) |
| **50 000+ enregistrements** | **Importation via l'API** |
| Migration ponctuelle | L'un ou l'autre (selon le volume) |
| **Importations récurrentes** | **Importation via l'API** |
| **Synchronisation en temps réel** | **Importation via l'API** |
| **Intégration avec d'autres systèmes** | **Importation via l'API** |
<Note>Pour des jeux de données comptant des centaines de milliers d'éléments, l'API est nettement plus rapide et plus fiable que plusieurs importations CSV.</Note>
## Limites de débit de l'API
Twenty applique des limites de débit pour garantir la stabilité du système :
| Limite | Valeur |
| -------------------------------------- | ----------------------------- |
| **Requêtes par minute** | 100 |
| **Enregistrements par appel par lots** | 60 |
| **Débit maximal** | ~6 000 enregistrements/minute |
<Warning>
**Planifiez votre importation en fonction de ces limites.**
Pour 100 000 enregistrements au débit maximal, prévoyez environ 17 minutes d'importation. Ajoutez une marge pour la gestion des erreurs et les nouvelles tentatives.
</Warning>
## Prise en main
### Étape 1 : Obtenez votre clé API
1. Allez dans **Paramètres → Développeurs**
2. Cliquez sur **+ Créer une clé API**
3. Donnez à votre clé un nom descriptif
4. Copiez immédiatement la clé API (elle ne sera plus affichée)
5. Stockez-la en toute sécurité
<Warning>
**Gardez votre clé API secrète.**
Toute personne disposant de votre clé API peut accéder aux données de votre espace de travail et les modifier. Ne la validez jamais dans des dépôts de code et ne la partagez pas publiquement.
</Warning>
### Étape 2 : Choisissez votre API
Twenty prend en charge deux types d'API :
| API | Idéal pour | Documentation |
| ----------- | ----------------------------------------------------------------------- | ------------------------------------------------ |
| **GraphQL** | Requêtes flexibles, récupération de données liées, opérations complexes | [Documentation de l'API](/l/fr/developers/extend/api) |
| **REST** | Opérations CRUD simples, modèles REST familiers | [Documentation de l'API](/l/fr/developers/extend/api) |
Les deux API prennent en charge :
* Créer, lire, mettre à jour et supprimer des enregistrements
* **Opérations par lots** — créez ou mettez à jour jusqu'à 60 enregistrements par appel
**Pour les importations, utilisez les opérations par lots** afin de maximiser le débit tout en respectant les limites de débit.
### Étape 3 : Planifiez l'ordre d'importation
Comme pour les importations CSV, **l'ordre compte** pour les relations :
1. **Entreprises** d'abord (aucune dépendance)
2. **Personnes** ensuite (peuvent être liées aux Entreprises)
3. **Opportunités** en troisième (peuvent être liées aux Entreprises et aux Personnes)
4. **Tâches/Notes** (peuvent être liées à l'un des éléments ci-dessus)
5. **Objets personnalisés** (en suivant leurs dépendances)
## Meilleures pratiques
### Regroupez vos requêtes par lots
* N'envoyez pas les enregistrements un par un
* Regroupez jusqu'à **60 enregistrements par appel d'API**
* Cela maximise le débit tout en respectant les limites de débit
### Gérez les limites de débit
* Mettez en place des délais entre les requêtes (600 ms minimum pour des importations soutenues)
* Utilisez un backoff exponentiel lorsque vous atteignez les limites
* Surveillez les réponses 429 (Too Many Requests)
### Validez d'abord les données
* Nettoyez et validez vos données avant l'importation
* Vérifiez que les champs obligatoires sont renseignés
* Vérifiez que les formats correspondent aux exigences de Twenty (voir [Correspondance des champs](/l/fr/user-guide/data-migration/capabilities/field-mapping))
### Consignez tout
* Consignez chaque enregistrement importé (y compris les identifiants)
* Consignez les erreurs avec tout le contexte
* Cela aide à déboguer les problèmes et à vérifier l'achèvement
### Testez d'abord
* Testez avec un petit lot (10 à 20 enregistrements)
* Vérifiez que les données s'affichent correctement dans Twenty
* Exécutez ensuite l'importation complète
### Upsert pour éviter les doublons
L'API GraphQL prend en charge l'**upsert par lots** — mise à jour si l'enregistrement existe, création sinon. Cela évite les doublons lors de la réexécution des importations.
## Trouver les noms d'objets et de champs
Pour voir les objets et champs disponibles :
1. Allez dans **Paramètres → API et Webhooks**
2. Parcourez l'**API de métadonnées**
3. Affichez tous les objets standard et personnalisés avec leurs champs
La documentation présente tous les objets standard et personnalisés, leurs champs et les types de données attendus.
## Services Professionnels
Pour des migrations API complexes, nos partenaires peuvent vous aider :
| Service | Ce qui est inclus |
| ----------------------------------- | ------------------------------------------------ |
| **Conception du modèle de données** | concevoir votre structure de données optimale |
| **Scripts de migration** | écrire et exécuter les scripts d'importation |
| **Transformation des données** | gérer la correspondance complexe et le nettoyage |
| **Validation et assurance qualité** | vérifier que la migration est complète |
**Idéal pour :**
* Migrations de plus de 100 000 enregistrements
* Transformations de données complexes
* Délais serrés
* Équipes sans ressources de développement
Contactez-nous à [contact@twenty.com](mailto:contact@twenty.com) ou découvrez nos [services de mise en œuvre](/l/fr/user-guide/getting-started/capabilities/implementation-services).
## FAQ
<AccordionGroup>
<Accordion title="Quelle est la différence entre GraphQL et REST ?">
GraphQL vous permet de demander exactement les données dont vous avez besoin en une seule requête et est mieux adapté aux opérations complexes. REST utilise les méthodes HTTP standard (GET, POST, PUT, DELETE) et peut être plus familier si vous avez travaillé avec des API traditionnelles.
</Accordion>
<Accordion title="Puis-je mettre à jour des enregistrements existants via l'API ?">
Oui! Utilisez des mutations de mise à jour (GraphQL) ou des requêtes PUT/PATCH (REST) avec l'`id` de l'enregistrement.
</Accordion>
<Accordion title="Comment gérer les doublons ?">
Recherchez d'abord les enregistrements existants en utilisant des identifiants uniques (e-mail, domaine). Mettez à jour s'il existe, créez s'il n'existe pas.
</Accordion>
<Accordion title="Puis-je supprimer des enregistrements via l'API ?">
Oui, utilisez des mutations de suppression (GraphQL) ou des requêtes DELETE (REST).
</Accordion>
<Accordion title="Existe-t-il un SDK Python ou Node.js ?">
Pas pour le moment, mais les deux API fonctionnent avec n'importe quel client HTTP dans n'importe quel langage.
</Accordion>
</AccordionGroup>
## Documentation de l'API
Pour les détails complets de mise en œuvre, des exemples de code et la référence du schéma :
* [Documentation de l'API](/l/fr/developers/extend/api)

View File

@@ -0,0 +1,225 @@
---
title: Importer des relations entre objets via CSV
description: Guide complet étape par étape pour lier des enregistrements lors de l'importation CSV.
---
## Vue d'ensemble
Ce guide vous accompagne dans l'importation des relations entre objets — par exemple, lier des Personnes à des Entreprises, ou des Opportunités à des Personnes.
<Note>**Ce qui peut être importé :** Uniquement des relations un-à-plusieurs pointant vers un seul type d'objet. Les relations pointant vers plusieurs types d'objet (comme des Notes liées à des Personnes ET à des Entreprises) ne sont pas encore prises en charge pour l'importation.</Note>
## Comprendre les relations
### Qu'est-ce qu'une relation "un-à-plusieurs" ?
Dans une relation un-à-plusieurs :
* **Une** Entreprise a **de nombreuses** Personnes (employés)
* **Une** Entreprise a **de nombreuses** Opportunités
* **Une** Personne a **de nombreuses** Tâches
Le côté "un" est le **parent**. Le côté "plusieurs" est l'**enfant**.
### Relations courantes dans Twenty
| Relation | Côté "un" (Parent) | Côté "plusieurs" (Enfant) |
| -------------------------- | ------------------ | ------------------------- |
| Entreprises → Personnes | Entreprise | Personnes |
| Entreprises → Opportunités | Entreprise | Opportunités |
| Personnes → Tâches | Personne | Tâches |
| Personnes → Notes | Personne | Notes |
## Étape 1 : Identifier les côtés "un" et "plusieurs"
Avant l'importation, déterminez quel objet est le parent et lequel est l'enfant.
**Posez-vous la question :** "Est-ce qu'UN [Objet A] a PLUSIEURS [Objet B] ?"
* Une Entreprise → Plusieurs Personnes ✓ (l'Entreprise est le parent)
* Une Personne → Plusieurs Entreprises ✗ (C'est faux — une personne appartient à une seule entreprise)
## Étape 2 : Importer d'abord les enregistrements parents
Le parent (côté "un") doit exister dans Twenty avant que vous ne puissiez y faire référence.
**Ordre d'import :**
1. **Entreprises** d'abord (aucune dépendance)
2. **Personnes** ensuite (liées aux Entreprises)
3. **Opportunités** en troisième (liées aux Entreprises et/ou aux Personnes)
4. **Tâches/Notes** (liées à l'un des éléments ci-dessus)
<Warning>
**Si l'enregistrement parent n'existe pas, l'import échouera.**
Vérifiez toujours que les Entreprises sont importées avant d'importer des Personnes avec des références à l'Entreprise.
</Warning>
## Étape 3 : Noter l'identifiant unique du parent
Vous devez référencer l'enregistrement parent à l'aide d'un **identifiant unique**. Options disponibles :
| Objet parent | Identifiants uniques disponibles |
| ---------------------------------- | --------------------------------------------------------------------- |
| **Entreprises** | `id` (UUID), `domain` (recommandé), ou tout champ unique personnalisé |
| **Personnes** | `id` (UUID), `email`, ou tout champ unique personnalisé |
| **Membres de l'espace de travail** | `id` (UUID), `email` (pas le nom) |
| **Objets personnalisés** | `id` (UUID), ou tout champ marqué comme unique |
<Note>**Recommandé :** Utilisez `domain` pour les Entreprises et `email` pour les Personnes. Ils sont lisibles par l'humain et faciles à vérifier dans votre feuille de calcul.</Note>
### Trouver l'identifiant
Si vous avez besoin de l'`id` :
1. Exportez les enregistrements parents depuis Twenty
2. L'export comprend la colonne `id`
3. Utilisez ces identifiants dans votre fichier d'enregistrements enfants
## Étape 4 : Vérifier que le champ de relation existe
Avant l'importation, assurez-vous que le champ de relation existe entre vos objets.
**Pour vérifier ou créer :**
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez votre objet enfant (par ex., Personnes)
3. Recherchez un champ de relation pointant vers le parent (par ex., Entreprise)
4. S'il n'existe pas, créez-le :
* Cliquez sur **+ Add field**
* Sélectionnez le type **Relation**
* Choisissez l'objet parent
## Étape 5 : Préparer votre fichier CSV
Ajoutez une colonne à votre CSV enfant qui référence le parent en utilisant son identifiant unique.
### Exemple : Personnes liées aux Entreprises
**Votre CSV Personnes :**
```csv
firstName,lastName,email,jobTitle,companyDomain
John,Smith,john@acme.com,CEO,https://acme.com
Jane,Doe,jane@widgets.co,CTO,https://widgets.co
Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
```
La colonne `companyDomain` référence le domaine de l'Entreprise.
### Exigences de format
| Identifiant | Format | Exemple |
| ----------- | ----------------------- | -------------------------------------- |
| Domaine | Format d'URL | `https://acme.com` |
| E-mail | Adresse e-mail standard | `john@acme.com` |
| ID | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Warning>
**Le format du domaine est important !**
Utilisez `https://domain.com` (et non simplement `domain.com`). Cela correspond à la manière dont Twenty stocke les domaines des Entreprises et évite les erreurs d'association.
</Warning>
### Règles importantes
1. **Correspondance exacte requise** — la valeur doit correspondre exactement à l'enregistrement parent
2. **N'associez qu'UN SEUL identifiant unique** — n'incluez pas à la fois `companyId` ET `companyDomain`
3. **Sensible à la casse** — `Acme.com` ≠ `acme.com`
## Étape 6 : Téléverser et associer la relation
1. Accédez à l'objet enfant (par ex., Personnes)
2. Cliquez sur **⋮** → **Importer des enregistrements**
3. Téléversez votre fichier CSV
4. Lors de l'étape de correspondance des champs :
* Trouvez votre colonne de relation (par ex., `companyDomain`)
* Associez-la au champ de relation **Entreprise**
5. Complétez les correspondances restantes
6. Passez en revue les erreurs et confirmez
Twenty liera automatiquement chaque enregistrement enfant au parent correspondant.
## Étape 7 : Vérifier l'importation
Après l'importation :
1. Ouvrez quelques enregistrements enfants (par ex., Personnes)
2. Vérifiez que le champ de relation affiche le parent correct (par ex., Entreprise)
3. Ouvrez un enregistrement parent et vérifiez la section des enregistrements liés
## Erreurs courantes à éviter
| Erreur | Problème | Solution |
| ------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **Mauvais ordre d'import** | Importer des Personnes avant des Entreprises | Importez toujours les parents d'abord, puis les enfants |
| **Mauvais format de domaine** | Utiliser `acme.com` au lieu de `https://acme.com` | Utilisez le format d'URL complet avec `https://` |
| **Plusieurs champs uniques** | Associer à la fois `companyId` ET `companyDomain` | N'associez qu'UN SEUL identifiant unique |
| **Champ de relation manquant** | Le champ de relation n'existe pas dans le modèle de données | Créez-le dans **Paramètres → Modèle de données** avant l'importation |
| **Enregistrements inexistants** | L'enregistrement parent n'existe pas dans Twenty | Importez d'abord les enregistrements parents, ou vérifiez les fautes de frappe |
| **Incohérence de casse** | `Acme.com` dans le fichier mais `acme.com` dans Twenty | Assurez une correspondance exacte de la casse |
## Liaison aux membres de l'espace de travail
Lors de la liaison à des membres de l'espace de travail (votre équipe) :
* Utilisez leur **adresse e-mail**, pas leur nom
* Exemple : `owner@yourcompany.com`, pas "John Smith"
```csv
taskName,assignedTo
Follow up with client,john@yourcompany.com
Review proposal,jane@yourcompany.com
```
## FAQ
<AccordionGroup>
<Accordion title="Que faire si mon enregistrement parent n'a pas de domaine ni d'e-mail ?">
Vous avez deux options :
1. Utilisez l'`id` Twenty (exportez les enregistrements parents pour obtenir leurs identifiants)
2. Créez un champ unique personnalisé dans votre modèle de données pour stocker un identifiant externe provenant de votre système précédent
</Accordion>
<Accordion title="Puis-je mettre à jour les relations sur des enregistrements existants ?">
Oui! Incluez l'identifiant unique de l'enregistrement enfant (par ex., `email` pour les Personnes) ainsi que la nouvelle valeur de relation. L'import mettra à jour la relation.
</Accordion>
<Accordion title="Puis-je importer des relations plusieurs-à-plusieurs ?">
Les relations plusieurs-à-plusieurs ne sont pas encore prises en charge pour l'importation. C'est prévu pour S1 2026.
</Accordion>
<Accordion title="Puis-je lier à plusieurs types d'objet (comme des Notes à des Personnes ET à des Entreprises) ?">
Les relations pointant vers plusieurs types d'objet ne sont pas encore prises en charge pour l'import/export. C'est sur notre feuille de route.
</Accordion>
<Accordion title="Que se passe-t-il si un enregistrement parent n'existe pas ?">
L'import affichera une erreur pour cette ligne. Vous pouvez :
* Importez d'abord l'enregistrement parent, puis réimportez
* Corrigez la valeur de référence
* Supprimez la ligne de l'import
</Accordion>
<Accordion title="Pourquoi ma relation ne se lie-t-elle pas correctement ?">
Causes courantes :
* Mauvais format (utilisez `https://domain.com` pour les domaines)
* Incohérence de casse (vérifiez l'orthographe exacte)
* Le parent n'existe pas (importez d'abord les parents)
* Association de plusieurs identifiants (n'en utilisez qu'un seul)
</Accordion>
</AccordionGroup>
<Warning>
**Rappel : Les enregistrements supprimés de façon logique comptent pour l'unicité.**
Si vous obtenez des erreurs "introuvable" mais que l'enregistrement semble exister, vérifiez le menu de commande → Voir les enregistrements supprimés. Le parent a peut-être été supprimé de façon logique.
</Warning>
## Résolution des problèmes
Vous rencontrez des problèmes ? Consultez :
* [Comment corriger les erreurs d'import](/l/fr/user-guide/data-migration/how-tos/fix-import-errors)
* [Fonctionnalités d'import des relations](/l/fr/user-guide/data-migration/capabilities/import-relations)
* [Contraintes d'unicité](/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints)

View File

@@ -0,0 +1,289 @@
---
title: Migration depuis d'autres CRM
description: Guide pas à pas pour migrer vos données de n'importe quel CRM vers Twenty.
---
## Vue d'ensemble
Ce guide vous accompagne pour migrer vos données depuis n'importe quel CRM vers Twenty. Le processus consiste à auditer vos données, à préparer votre espace de travail sur Twenty, à exporter depuis votre système actuel et à importer dans Twenty.
<Note>Les vues, les flux de travail et les autorisations doivent être recréés manuellement après la migration. Prévoyez du temps pour ce travail de configuration.</Note>
## Étape 1 : Auditez vos données actuelles
La migration est une occasion de repartir sur de bonnes bases. N'importez pas de données superflues.
**À conserver :**
* Contacts et entreprises actifs
* Opportunités et affaires ouvertes
* Notes et activités importantes
* Champs personnalisés que vous utilisez réellement
**À laisser de côté :**
* Contacts obsolètes (aucune activité depuis plus de 2 ans)
* Doublons
* Données de test
* Champs personnalisés inutilisés
## Étape 2 : Cartographiez votre modèle de données
Créez un document de correspondance entre votre CRM actuel et Twenty :
| Votre CRM | Twenty |
| --------------------- | ---------------------- |
| Compte / Organisation | **Entreprise** |
| Contact / Personne | **Personnes** |
| Affaire / Opportunité | **Opportunité** |
| Activité | **Tâche** ou **Note** |
| Objet personnalisé | **Objet personnalisé** |
**Pour chaque champ, documentez :**
* Le nom du champ source
* Le champ Twenty cible
* Toute transformation de format nécessaire (dates, numéros de téléphone, etc.)
<Note>Gardez ce document de mappage à portée de main pendant l'importation — vous vous y référerez lors de la mise en correspondance des colonnes.</Note>
## Étape 3 : Configurez votre espace de travail Twenty
Avant d'importer des données, préparez votre espace de travail Twenty :
### Créez des objets et des champs personnalisés
1. Allez dans **Paramètres → Modèle de données**
2. Créez tous les objets personnalisés dont vous avez besoin
3. Ajoutez des champs personnalisés aux objets standard et personnalisés
4. Configurez les paramètres des champs (unique, obligatoire, options de sélection, etc.)
<Warning>
**Les champs doivent exister avant l'importation.**
L'import CSV crée des enregistrements, pas des champs. Créez tous les champs personnalisés dans **Paramètres → Modèle de données** avant l'importation.
</Warning>
### Invitez votre équipe
<Warning>
**Invitez les utilisateurs AVANT d'importer des données.**
Si vos données incluent des références à des utilisateurs (propriétaire du compte, assigné, etc.), ces utilisateurs doivent exister dans Twenty avant l'importation. Sinon, ces relations ne pourront pas être mises en correspondance.
</Warning>
1. Allez dans **Paramètres → Membres**
2. Invitez tous les membres de l'équipe
3. **Attendez que tout le monde accepte** son invitation
4. Vérifiez que tous les utilisateurs apparaissent dans votre liste des membres
## Étape 4 : Exportez depuis votre CRM actuel
Exportez vos données depuis votre CRM actuel :
1. Recherchez une fonction **Export** (généralement dans Paramètres, Gestion des données ou Admin)
2. Exportez au **format CSV** lorsque c'est possible
3. Exportez chaque type d'objet séparément (Entreprises, Contacts, Affaires, etc.)
4. Incluez tous les champs que vous souhaitez migrer
**Exportez ces objets (dans cet ordre à titre de référence) :**
1. Entreprises / Comptes / Organisations
2. Contacts / Personnes
3. Affaires / Opportunités
4. Notes et activités
5. Objets personnalisés
## Étape 5 : Nettoyez et mettez en forme vos données
Ouvrez chaque CSV exporté dans une application de tableur et préparez-le pour Twenty.
### Supprimez les doublons
1. Triez par le champ unique (e-mail pour les Personnes, domaine pour les Entreprises)
2. Supprimez ou fusionnez les lignes en double
3. Vérifiez qu'il n'existe pas déjà de doublons dans Twenty
### Formatez correctement les champs
| Type de champ | Format requis |
| ----------------------- | ----------------------------------------------------- |
| **Domaine** | `https://domain.com` |
| **Email** | `name@domain.com` (doit être unique) |
| **Date** | `YYYY-MM-DD` |
| **Téléphone** | Trois colonnes : numéro, code pays, indicatif d'appel |
| **Booléen** | `TRUE` ou `FALSE` (majuscules) |
| **Champs de sélection** | Utilisez les noms d'API, pas les libellés d'affichage |
<Warning>
**Le format du domaine est critique.**
Utilisez `https://domain.com` (pas `domain.com` ni `www.domain.com`). Cela correspond au format de Twenty et évite les doublons lorsque vous connectez la synchronisation e-mail/calendrier.
</Warning>
Voir [Comment préparer vos fichiers CSV](/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files) pour connaître les exigences complètes de formatage pour tous les types de champs.
### Ajoutez des colonnes de relation
Pour lier des enregistrements (par exemple, des Personnes à des Entreprises), ajoutez une colonne avec l'identifiant unique de l'entité parente.
**Exemple : CSV Personnes avec lien vers l'Entreprise**
```csv
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
Voir [Comment importer des relations](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) pour des instructions détaillées sur la liaison des enregistrements.
### Mettez à jour les références utilisateur
Si vos données incluent des attributions d'utilisateur (propriétaire, assigné) :
1. Ajoutez une colonne avec l'**e-mail de l'utilisateur** (pas seulement son ID de l'ancien système)
2. Utilisez les mêmes adresses e-mail que celles utilisées par les utilisateurs pour rejoindre votre espace de travail Twenty
Voir [Comment préparer vos fichiers CSV](/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files) pour un guide de formatage complet.
## Étape 6 : Importez dans Twenty
<Warning>
**L'ordre d'importation est important !**
Importez toujours dans cet ordre :
1. **Entreprises** d'abord (aucune dépendance)
2. **Personnes** ensuite (liées aux Entreprises)
3. **Opportunités** en troisième (liées aux Entreprises/Personnes)
4. **Notes et tâches** (liées aux enregistrements)
5. **Objets personnalisés** en suivant leurs dépendances
L'enregistrement parent doit exister avant que vous puissiez y faire référence.
</Warning>
### Importez chaque objet
Pour chaque fichier CSV, dans l'ordre :
1. Accédez à l'objet dans Twenty
2. Cliquez sur **⋮ → Importer des enregistrements**
3. Téléversez le fichier CSV
4. Faites correspondre les colonnes aux champs :
* Faites correspondre les colonnes d'e-mail des utilisateurs aux champs de relation appropriés
* Faites correspondre les colonnes de relation (comme `companyDomain`) aux champs de relation
5. Examinez et corrigez les erreurs éventuelles dans l'interface
6. Confirmez l'importation
7. Vérifiez quelques enregistrements avant de passer au fichier suivant
**Guides détaillés :**
* [Comment importer des entreprises](/l/fr/user-guide/data-migration/how-tos/import-companies-via-csv)
* [Comment importer des contacts](/l/fr/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [Comment importer des relations](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
## Étape 7 : Grandes migrations (50 000+ enregistrements)
Pour les grandes migrations :
| Volume | Approche recommandée |
| ------------------------------- | ------------------------------------- |
| Moins de 10 000 enregistrements | Importation CSV unique |
| 10 000 - 50 000 enregistrements | Fractionnez en plusieurs fichiers CSV |
| 50 000+ enregistrements | Utilisez l'API |
**Pour les importations via l'API :**
* Plus rapide et plus fiable pour les grands jeux de données
* Prend en charge les opérations par lots (jusqu'à 60 enregistrements par appel)
* Voir [Comment importer des données via l'API](/l/fr/user-guide/data-migration/how-tos/import-data-via-api)
## Étape 8 : Configuration post-migration
Après l'importation des données, terminez la configuration de votre espace de travail :
### Recréez les vues
* Configurez des vues enregistrées avec des filtres, des tris et des configurations de colonnes
* Créez toutes les vues kanban ou calendrier dont vous avez besoin
### Recréez les workflows
* Recréez vos automatisations dans **Paramètres → Flux de travail**
* Commencez par les flux de travail les plus critiques
* Testez chacun d'eux avant de vous y fier
### Configurez les rôles et les autorisations
* Configurez les rôles dans **Paramètres → Membres → Rôles**
* Affectez les utilisateurs aux rôles appropriés
### Connectez les e-mails et le calendrier
* Chaque utilisateur connecte son propre compte dans **Paramètres → Comptes**
* Twenty commencera à synchroniser les e-mails avec les enregistrements de contacts
* Voir [E-mails et calendrier](/l/fr/user-guide/calendar-emails/overview)
### Formez votre équipe
* Parcourez ensemble la nouvelle interface
* Documentez tous les processus spécifiques à l'équipe
## Problèmes Courants et Solutions
| Problème | Cause | Solution |
| ---------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| **Erreurs de doublons** | L'e-mail/le domaine existe déjà | Supprimez les doublons du fichier, ou incluez un identifiant unique pour mettre à jour les enregistrements existants |
| **Relation introuvable** | L'enregistrement parent n'existe pas | Importez d'abord les objets parents (Entreprises avant Personnes) |
| **Champs manquants** | Le champ personnalisé n'existe pas | Créez le champ dans **Paramètres → Modèle de données** avant l'importation |
| **Erreurs de champs de sélection** | Utilisation de libellés d'affichage | Utilisez les noms d'API (activez le mode avancé dans Paramètres pour les trouver) |
| **Relation utilisateur vide** | L'utilisateur n'a pas accepté l'invitation | Assurez-vous que tous les utilisateurs acceptent les invitations avant d'importer |
Voir [Comment corriger les erreurs d'importation](/l/fr/user-guide/data-migration/how-tos/fix-import-errors) pour des étapes détaillées de dépannage.
## Liste de vérification post-migration
### Intégrité des données
<Check>Tous les enregistrements importés (comparez les nombres avec le système source)</Check>
<Check>Relations fonctionnant correctement (Personnes liées aux Entreprises)</Check>
<Check>Attributions utilisateur correctement mises en correspondance (Propriétaire, Assigné)</Check>
<Check>Champs personnalisés renseignés</Check>
<Check>Aucun doublon inattendu</Check>
### Configuration
<Check>Vues recréées</Check>
<Check>Flux de travail recréés et testés</Check>
<Check>Rôles et autorisations configurés</Check>
<Check>Synchronisation e-mail/calendrier connectée</Check>
### Préparation de l'équipe
<Check>Équipe formée au nouveau système</Check>
<Check>Plan d'accès à l'ancien CRM décidé (le conserver comme référence ? Quand le désactiver ?)</Check>
## FAQ
<AccordionGroup>
<Accordion title="Puis-je migrer les flux de travail automatiquement ?">
Pas pour le moment. Les flux de travail doivent être recréés manuellement dans Twenty.
</Accordion>
<Accordion title="Qu'en est-il des pièces jointes ?">
Les pièces jointes ne sont pas incluses dans les exportations CSV. Vous devrez les téléverser à nouveau manuellement, les migrer via l'API ou contacter notre équipe pour obtenir de l'aide.
</Accordion>
<Accordion title="Puis-je garder les deux systèmes actifs pendant la migration ?">
Oui, nous recommandons de garder votre ancien CRM actif jusqu'à ce que vous ayez vérifié que la migration est terminée. Veillez simplement à ne pas créer de nouvelles données aux deux endroits.
</Accordion>
<Accordion title="Combien de temps la migration prend-elle généralement ?">
Cela dépend du volume et de la complexité des données. Les petites migrations (moins de 10 000 enregistrements) peuvent être effectuées en quelques heures. Les grandes migrations peuvent prendre plusieurs jours, y compris le nettoyage des données et les tests.
</Accordion>
</AccordionGroup>
## Besoin d'aide ?
<Tip>
Vous voulez de l'aide pour votre migration ? [Trouver un partenaire certifié Vingt partenaires] (https://twenty.com/partners/list?categories=SOLUTIONING&ref=docs-migrate-crm) pour déplacer vos données, vos pipelines et vos utilisateurs de bout en bout.
</Tip>

View File

@@ -0,0 +1,173 @@
---
title: Migration de l'hébergement local vers le cloud
description: Guide pas à pas pour migrer votre instance Twenty auto-hébergée vers Twenty Cloud.
---
## Vue d'ensemble
Ce guide vous accompagne pour migrer vos données d'une instance Twenty auto-hébergée vers Twenty Cloud. Le processus consiste à configurer votre espace de travail cloud, à exporter vos données, puis à les réimporter.
<Note>Les vues, les flux de travail et les rôles doivent être recréés manuellement après la migration. Prévoyez du temps pour ce travail de configuration.</Note>
## Étape 1: Créez votre espace de travail cloud
1. Accédez à [app.twenty.com](https://app.twenty.com) et créez un nouvel espace de travail
2. Terminez l'assistant de configuration initial
3. Notez l'URL de votre nouvel espace de travail
## Étape 2: Recréez votre modèle de données
Avant d'importer des données, recréez vos objets et champs personnalisés:
1. Allez dans **Paramètres → Modèle de données** dans votre instance cloud
2. Créez des objets personnalisés correspondant à votre configuration auto-hébergée
3. Ajoutez des champs personnalisés aux objets standard et personnalisés
4. Configurez les paramètres des champs (unique, obligatoire, etc.)
<Note>Faites des captures d'écran de votre modèle de données auto-hébergé pour référence, ou gardez les deux instances ouvertes côte à côte.</Note>
## Étape 3: Invitez tous les utilisateurs
<Warning>
**Critique: invitez les utilisateurs AVANT d'importer des données.**
Les utilisateurs doivent accepter leurs invitations avant que vous n'importiez des enregistrements qui les référencent (comme les champs Propriétaire du compte). Si les utilisateurs n'existent pas encore, ces relations ne pourront pas être mises en correspondance.
</Warning>
1. Allez dans **Paramètres → Membres** dans votre instance cloud
2. Invitez tous les membres de l'équipe qui avaient des comptes sur l'instance auto-hébergée
3. **Attendez que tout le monde accepte** son invitation
4. Vérifiez que tous les utilisateurs apparaissent dans votre liste des membres
## Étape 4: Exportez les données depuis l'instance auto-hébergée
Exportez chaque objet depuis votre instance auto-hébergée:
1. Accédez à chaque objet (Entreprises, Personnes, Opportunités, etc.)
2. Configurez la vue pour afficher **toutes les colonnes** que vous souhaitez migrer
3. Cliquez sur **⋮ → Exporter la vue**
4. Enregistrez chaque fichier CSV avec un nom explicite (par exemple, `companies-export.csv`)
**Exportez dans cet ordre** (pour référence lors de l'importation):
1. Entreprises
2. Personnes
3. Opportunités
4. Objets personnalisés (en suivant leurs dépendances)
5. Tâches, notes
## Étape 5 : Mettez à jour les références des membres de l'espace de travail
Les fichiers CSV exportés contiennent des ID utilisateur provenant de votre instance auto-hébergée. Ces ID ne correspondront pas à votre instance cloud, vous devez donc les remplacer par des adresses e-mail.
**Pour chaque fichier CSV contenant des références utilisateur (propriétaire, assigné, etc.):**
1. Ouvrez le CSV dans une application de feuille de calcul
2. Ajoutez une nouvelle colonne à côté de chaque colonne d'ID utilisateur (par exemple, `accountOwnerEmail` à côté de `accountOwnerId`)
3. Renseignez l'**adresse e-mail** de chaque utilisateur
4. Vous pouvez supprimer l'ancienne colonne d'ID ou la laisser (elle sera ignorée lors de l'importation)
**Exemple:**
Avant:
```csv
name,domain,accountOwnerId
Acme Corp,https://acme.com,old-uuid-123
```
Après:
```csv
name,domain,accountOwnerEmail
Acme Corp,https://acme.com,john@yourcompany.com
```
<Note>Utilisez les mêmes adresses e-mail que celles utilisées par les utilisateurs pour accepter l'invitation à l'espace de travail cloud.</Note>
## Étape 6: Planifiez l'ordre d'importation
Importez les fichiers dans le bon ordre pour conserver les relations:
1. **Entreprises** en premier (aucune dépendance)
2. **Personnes** en deuxième (liées aux entreprises)
3. **Opportunités** en troisième (liées aux entreprises et aux personnes)
4. **Objets personnalisés** (en suivant leurs dépendances)
5. **Tâches et notes** en dernier (liées aux autres enregistrements)
Voir [Comment importer des relations](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) pour plus de détails sur le maintien des relations.
## Étape 7: Importez vers le cloud
Pour chaque fichier CSV, dans l'ordre:
1. Accédez à l'objet dans votre instance cloud
2. Cliquez sur **⋮ → Importer des enregistrements**
3. Téléversez le fichier CSV
4. Faites correspondre les colonnes aux champs:
* Faites correspondre les colonnes d'e-mail des utilisateurs aux champs de relation appropriés
* Faites correspondre les autres colonnes comme d'habitude
5. Examinez et corrigez les erreurs éventuelles
6. Confirmez l'importation
7. Vérifiez quelques enregistrements avant de passer au fichier suivant
## Étape 8: Recréez la configuration
Après l'importation des données, recréez manuellement:
### Vues
* Recréez les vues enregistrées avec des filtres, des tris et des configurations de colonnes
* Configurez d'éventuelles vues kanban ou calendrier
### Flux de travail
* Recréez les automatisations dans **Paramètres → Flux de travail**
* Testez chaque flux de travail avant de vous y fier
### Rôles et autorisations
* Configurez les rôles dans **Paramètres → Membres → Rôles**
* Affectez les utilisateurs aux rôles appropriés
### Intégrations
* Reconnectez la synchronisation e-mail et calendrier pour chaque utilisateur
* Reconfigurez les intégrations API avec de nouvelles clés API
## Liste de vérification post-migration
<Check>Toutes les données importées avec succès</Check>
<Check>Relations entre objets fonctionnant correctement</Check>
<Check>Affectations des utilisateurs (propriétaire, assigné) correctement mises en correspondance</Check>
<Check>Vues recréées</Check>
<Check>Flux de travail recréés et testés</Check>
<Check>Rôles et autorisations configurés</Check>
<Check>Synchronisation e-mail/calendrier reconnectée</Check>
<Check>Intégrations API mises à jour avec de nouvelles clés</Check>
## FAQ
<AccordionGroup>
<Accordion title="Puis-je migrer les flux de travail automatiquement ?">
Pas pour le moment. Les flux de travail doivent être recréés manuellement dans votre instance cloud.
</Accordion>
<Accordion title="Qu'en est-il des pièces jointes et des images ?">
Les pièces jointes ne sont pas incluses dans les exportations CSV. Vous devrez téléverser à nouveau les pièces jointes manuellement, les migrer via l'API ou contacter notre équipe pour obtenir de l'aide pour les migrations de grande envergure.
</Accordion>
<Accordion title="Puis-je garder les deux instances actives pendant la migration ?">
Oui, nous vous recommandons de garder votre instance auto-hébergée active jusqu'à ce que vous ayez vérifié que la migration vers le cloud est terminée. Veillez simplement à ne pas créer de nouvelles données aux deux endroits.
</Accordion>
<Accordion title="Que se passe-t-il si un utilisateur n'a pas encore accepté son invitation ?">
Les enregistrements faisant référence à cet utilisateur échoueront à l'importation ou la relation sera vide. Assurez-vous que tous les utilisateurs acceptent les invitations avant d'importer des données.
</Accordion>
</AccordionGroup>
## Besoin d'aide ?
<Tip>
Vous migrez un espace de travail important ou complexe ? [Faites appel à un partenaire Twenty certifié](https://twenty.com/partners/list?categories=HOSTING\&ref=docs-migrate-cloud) pour gérer la migration de bout en bout. *(Ou faites intervenir notre équipe : [contact@twenty.com](mailto:contact@twenty.com).)*
</Tip>

View File

@@ -0,0 +1,267 @@
---
title: Préparez vos fichiers CSV
description: Guide complet étape par étape pour formater vos données en vue de leur importation dans Twenty.
---
## Vue d'ensemble
Ce guide vous explique comment préparer votre fichier CSV pour un import réussi. Suivez ces étapes afin d’éviter les erreurs.
## Étape 1 : Vérifiez les exigences du fichier
Avant de commencer, assurez-vous que votre fichier répond à ces exigences :
| Exigence | Détails |
| -------------------- | ---------------------------------- |
| **Format** | CSV, XLSX ou XLS |
| **Limite de taille** | 10 000 enregistrements par fichier |
| **Encodage** | UTF-8 recommandé |
| **Structure** | Un type d’objet par fichier |
<Note>Pour les ensembles de données supérieurs à 10 000 enregistrements, divisez-les en plusieurs fichiers ou utilisez l’[importation via l’API](/l/fr/user-guide/data-migration/how-tos/import-data-via-api).</Note>
## Étape 2 : Téléchargez le fichier d’exemple
**C’est l’étape la plus importante.** Le fichier d’exemple vous indique exactement les noms de colonnes et le format attendus par Twenty.
1. Accédez à la vue d’objet (Personnes, Entreprises, etc.)
2. Cliquez sur **⋮** → **Importer des enregistrements**
3. Cliquez sur **Télécharger le fichier d’exemple**
4. Utilisez ce fichier comme modèle
<Note>**Astuce pro :** Exportez plutôt quelques enregistrements existants. Cela vous donne des exemples réels de la manière dont les données doivent être formatées, et les noms de colonnes seront mis en correspondance automatiquement lors de l’import.</Note>
## Étape 3 : Supprimez les valeurs en double
Twenty impose l’unicité sur certains champs. Les doublons provoqueront des erreurs d’import.
| Objet | Champs uniques |
| ------------------------ | ------------------------------------------------------- |
| **Personnes** | `id`, `email` |
| **Entreprises** | `id`, `domain` |
| **Objets personnalisés** | `id`, plus tout champ que vous avez marqué comme unique |
**Avant l’import :**
1. Triez votre feuille de calcul par le champ unique (email ou domaine)
2. Supprimez ou fusionnez les lignes en double
3. Vérifiez les doublons qui existent déjà dans Twenty
<Warning>**Les enregistrements supprimés logiquement comptent pour l’unicité.** Les enregistrements dans Command Menu → See deleted records provoqueront des erreurs de doublon. Supprimez-les définitivement ou restaurez-les et mettez-les à jour.</Warning>
## Étape 4 : Formatez correctement chaque type de champ
Différents types de champs nécessitent des formats spécifiques. Voici la référence complète :
### Champs texte
* Aucun formatage particulier requis
* Les espaces en début/fin sont automatiquement supprimés
### Champs e-mail
* Doit avoir un format d’e-mail valide : `name@domain.com`
* Doit être unique (aucun doublon dans le fichier ni dans Twenty)
* Pour les e-mails supplémentaires, utilisez ce format dans la colonne **Emails / Additional Emails** :
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### Champs de domaine
* **Format recommandé** : `https://domain.com`
* Cela correspond au format utilisé par la synchronisation boîte mail/calendrier (évite les doublons)
* Renseignez les deux colonnes :
* **Domain / Domain Label** : `domain.com`
* **Domain / Domain URL** : `https://domain.com`
* Doit être unique dans votre fichier et dans Twenty
### Champs de téléphone
Le téléphone est un **champ imbriqué** qui nécessite plusieurs colonnes :
| Colonne | Exemple |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number** | `4159095555` |
| **Phones / Primary Phone Country Code** | `US` |
| **Phones / Primary Phone Calling Code** | `+1` |
### Champs d'adresse
Le champ Adresse est un **champ imbriqué** avec plusieurs colonnes (certaines peuvent être laissées vides):
* **Adresse / Adresse 1**: Première ligne de l’adresse
* **Adresse / Adresse 2**: Deuxième ligne de l’adresse (facultatif)
* **Adresse / Ville**: Nom de la ville
* **Adresse / État**: État ou province
* **Adresse / Pays**: Nom du pays
* **Adresse / Code postal**: Code postal/ZIP
### Champs de date
Utilisez un format cohérent dans tout votre fichier:
* `YYYY-MM-DD` (recommandé): `2024-03-15`
* ISO 8601: `2024-03-15T10:30:00Z`
### Champs numériques
* Uniquement des nombres (pas de texte)
* Utilisez le point pour les décimales: `1234.56`
* Aucun séparateur de milliers (pas `1,234.56`)
### Champs de devise
La devise est un **champ imbriqué** nécessitant deux colonnes qui doivent **toutes deux être renseignées**:
| Colonne | Exemple |
| --------------------- | --------- |
| **Montant / Montant** | `1234.56` |
| **Montant / Devise** | `USD` |
### Champs booléens
Utilisez des majuscules: `TRUE` ou `FALSE`
<Warning>Les minuscules `true` ou `false` ne fonctionneront pas.</Warning>
### Champs de sélection
Utilisez le **nom d’API** de l’option, et non le libellé affiché.
**Comment trouver les noms d’API:**
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez l’objet et le champ
3. Activez le **mode avancé** (bascule en bas à droite)
4. Copiez le nom d’API (par ex., `OPTION_1`, pas "Option 1")
<Note>Les nouvelles options de sélection ne sont pas créées automatiquement. Ajoutez-les dans **Paramètres → Modèle de données** avant l’importation.</Note>
### Champs à sélection multiple
Utilisez les noms d’API au format de tableau:
```
["VALUE1","VALUE2"]
```
### Champs de tableau
Utilisez le format de tableau JSON:
```
["value1","value2"]
```
### Champs d’évaluation
Utilisez le format: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4` ou `RATING_5`
### Champs de liens/URL
Renseignez les deux colonnes:
* **Liens / Libellé du lien**: `Twenty`
* **Liens / URL du lien**: `https://twenty.com`
Pour les liens secondaires, utilisez la colonne **Liens / Liens secondaires**:
```
[{"url":"https://twenty.com","label":"Twenty"}]
```
### Champs JSON
Utilisez un format JSON valide:
```
{"key":"value","key2":"value2"}
```
### Champs d’ID
* **Optionnel**: Twenty génère automatiquement des ID s’ils ne sont pas fournis
* **Format**: UUID (par ex. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`)
* **Cas d’usage**: Incluez l’ID pour mettre à jour des enregistrements existants au lieu d’en créer de nouveaux
## Étape 5: Ajouter des colonnes de relation (si vous liez des enregistrements)
Pour lier des enregistrements à d’autres objets (par ex., Personnes à Entreprises), ajoutez une colonne contenant l’identifiant unique de l’enregistrement associé.
**Exemple**: Lier des Personnes à des Entreprises
Ajoutez une colonne à votre CSV Personnes:
```
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
**Règles importantes pour les relations:**
* L’enregistrement parent doit déjà exister dans Twenty
* Utilisez le format **URL de domaine** (`https://domain.com`), pas le libellé
* Associez UN SEUL identifiant unique (n’incluez pas à la fois `companyId` ET `companyDomain`)
* Pour les membres de l’espace de travail, utilisez leur **adresse e-mail** (et non le nom)
<Warning>
**L’ordre d’importation est important !**
Importez le côté « un » avant le côté « plusieurs »:
1. **Entreprises** d’abord
2. **Personnes** ensuite (avec référence à l’entreprise)
3. **Opportunités** en troisième
L’enregistrement parent doit exister avant que vous puissiez y faire référence.
</Warning>
Consultez [Comment importer des relations](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) pour des instructions détaillées.
## Étape 6: Vérifiez que les champs existent dans Twenty
L’import crée des **enregistrements**, pas des **champs**. Tous les champs que vous souhaitez importer doivent déjà exister dans votre modèle de données.
**Avant l’importation:**
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez votre objet
3. Créez les champs personnalisés dont vous avez besoin
4. Notez les noms de champs exacts (ils doivent correspondre aux en-têtes de vos colonnes)
## Étape 7: Liste de contrôle finale
Avant de téléverser votre fichier, vérifiez:
<Check>Le fichier est au format CSV, XLSX ou XLS</Check>
<Check>Le fichier contient moins de 10 000 enregistrements</Check>
<Check>L’encodage est UTF-8</Check>
<Check>Aucune adresse e-mail en double (pour les Personnes) ni domaine en double (pour les Entreprises)</Check>
<Check>Les dates utilisent un format cohérent partout</Check>
<Check>Les domaines utilisent le format `https://domain.com`</Check>
<Check>Les champs booléens utilisent `TRUE` ou `FALSE` (majuscules)</Check>
<Check>Les champs de sélection utilisent les noms d’API, pas les libellés affichés</Check>
<Check>Tous les champs personnalisés existent dans Paramètres → Modèle de données</Check>
<Check>Enregistrements parents importés avant les enregistrements enfants</Check>
<Check>Les colonnes de relation font référence à des enregistrements existants</Check>
## Erreurs courantes à éviter
| Erreur | Solution |
| ----------------------------------------------------------- | ----------------------------------------------------- |
| Utiliser `true` au lieu de `TRUE` | Les valeurs booléennes doivent être en majuscules |
| Utiliser des libellés affichés pour les champs de sélection | Recherchez et utilisez les noms d’API dans Paramètres |
| Importer les Personnes avant les Entreprises | Importez toujours d’abord les objets parents |
| Code de devise manquant pour les champs de devise | Renseignez les colonnes Montant et Devise |
| Format de domaine incorrect | Utilisez systématiquement `https://domain.com` |
| Associer plusieurs champs uniques pour les relations | N’associez qu’UN SEUL (domaine OU ID, pas les deux) |
## Prochaines étapes
Votre fichier est prêt ! Maintenant:
* [Importer des entreprises](/l/fr/user-guide/data-migration/how-tos/import-companies-via-csv) (importez-les d’abord)
* [Importer des contacts](/l/fr/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [Corriger les erreurs d’importation](/l/fr/user-guide/data-migration/how-tos/fix-import-errors)

View File

@@ -0,0 +1,198 @@
---
title: Mettre à jour des enregistrements existants via l'importation
description: Guide complet étape par étape pour mettre à jour en masse des enregistrements à l'aide de l'importation CSV.
---
## Vue d'ensemble
Besoin de mettre à jour de nombreux enregistrements en une seule fois ? Au lieu de les modifier un par un, utilisez l'importation CSV pour mettre à jour en masse les enregistrements existants.
**Cas d'utilisation :**
* Mettre à jour les intitulés de poste pour plusieurs personnes
* Modifier les informations d'entreprise en masse
* Ajouter des données à de nouveaux champs personnalisés
* Corriger des erreurs de données sur de nombreux enregistrements
## Comment ça marche
Lorsque vous importez un fichier contenant un **identifiant unique** qui correspond à un enregistrement existant, Twenty met à jour cet enregistrement au lieu de créer un doublon.
| Si l'identifiant unique... | Twenty va... |
| --------------------------------------- | ------------------------------------------------------------------------------- |
| Correspond à un enregistrement existant | **Mettre à jour** l'enregistrement existant |
| Ne correspond à aucun enregistrement | **Créer** un nouvel enregistrement |
| Est absent de votre fichier | **Créer** un nouvel enregistrement (avec un identifiant généré automatiquement) |
<Warning>
**Les champs à sélection multiple sont écrasés, pas fusionnés.**
Si un enregistrement a `Option A` et `Option B` sélectionnées et que vous importez `["Option C"]`, l'enregistrement n'aura plus que `Option C` après l'importation. L'importation remplace toutes les sélections précédentes — elle ne les complète pas.
Pour conserver les valeurs existantes, incluez-les toutes dans votre importation : `["Option A","Option B","Option C"]`
</Warning>
## Étape 1 : Exporter vos données actuelles
Commencez par exporter les enregistrements que vous souhaitez mettre à jour :
1. Accédez à l'objet (Personnes, Entreprises, etc.)
2. **Ajoutez les colonnes dont vous avez besoin** — cliquez sur **Options → Champs** pour afficher les champs que vous souhaitez mettre à jour
3. **Filtrez si nécessaire** — réduisez la vue aux seuls enregistrements que vous souhaitez mettre à jour
4. Cliquez sur **⋮** → **Exporter la vue**
5. Enregistrez le fichier CSV
<Note>**Pourquoi exporter d'abord ?** Le fichier exporté a le bon format, inclut des identifiants uniques et se met automatiquement en correspondance lors de l'importation.</Note>
### Ce qui est exporté
* Toutes les colonnes visibles dans votre vue actuelle
* Les identifiants uniques de l'enregistrement (`id`, `email`, `domain`)
* Les valeurs de champ actuelles que vous pouvez modifier
## Étape 2 : Modifier le fichier CSV
Ouvrez le fichier exporté dans votre application de feuille de calcul (Excel, Google Sheets, etc.) :
1. **Conservez la colonne de l'identifiant unique** — ne supprimez pas `id`, `email` ni `domain`
2. **Mettez à jour les valeurs** dans les colonnes que vous souhaitez modifier
3. **Supprimez les colonnes que vous n'avez pas besoin de mettre à jour** (facultatif, mais plus propre)
4. **Ne modifiez pas les valeurs des identifiants uniques** — sinon Twenty créera de nouveaux enregistrements
### Exemple : Mise à jour des intitulés de poste
**Fichier exporté :**
```csv
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
```
**Après vos modifications :**
```csv
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
```
<Warning>
**Ne modifiez pas les valeurs des identifiants uniques.**
Si vous remplacez `john@acme.com` par `john.smith@acme.com`, Twenty créera un nouvel enregistrement au lieu de mettre à jour l'existant.
</Warning>
## Étape 3 : Importer le fichier mis à jour
1. Accédez à l'objet
2. Cliquez sur **⋮** → **Importer des enregistrements**
3. Téléversez votre fichier CSV modifié
4. **Assurez-vous que l'identifiant unique est mis en correspondance** — vérifiez que `email`, `domain` ou `id` est correctement mis en correspondance
5. Vérifiez les correspondances de champs
6. Recherchez des erreurs
7. Cliquez sur **Confirmer**
Twenty fait correspondre les enregistrements via l'identifiant unique et les met à jour avec les nouvelles valeurs.
## Choisir le bon identifiant unique
| Objet | Recommandé | Alternative | Notes |
| ------------------------ | --------------------------- | ----------- | ------------------------------------------ |
| **Personnes** | `e-mail` | `id` | L'adresse e-mail est lisible par un humain |
| **Entreprises** | `domaine` | `id` | Le domaine est lisible par un humain |
| **Objets personnalisés** | N'importe quel champ unique | `id` | Utilisez votre champ unique personnalisé |
<Note>**N'utilisez qu'UN SEUL identifiant unique.** N'associez pas à la fois `email` ET `id`. Cela peut provoquer de la confusion et des erreurs.</Note>
### Utiliser des champs uniques personnalisés
Si vous avez un champ personnalisé marqué comme unique (comme un ID externe provenant d'un autre système) :
1. Incluez ce champ dans votre export et votre import
2. Associez-le lors de l'importation
3. Twenty effectuera la correspondance sur ce champ
## Étape 4 : Vérifier les mises à jour
Après l'importation :
1. Ouvrez quelques enregistrements mis à jour
2. Vérifiez que les modifications ont été appliquées
3. Vérifiez qu'aucun enregistrement en double n'a été créé
## Et les champs qui ne figurent pas dans votre fichier ?
**Les champs non inclus dans votre fichier d'import restent inchangés.**
| Votre fichier inclut... | Résultat |
| ---------------------------- | -------------------------------------------------------------------- |
| `email`, `jobTitle` | Seul `jobTitle` est mis à jour ; les autres champs restent inchangés |
| `email`, `jobTitle`, `phone` | `jobTitle` et `phone` sont mis à jour |
Cela signifie que vous n'avez besoin d'inclure que les champs que vous souhaitez modifier (plus l'identifiant unique).
## Combiner mises à jour et nouveaux enregistrements
Vous pouvez mettre à jour des enregistrements existants ET en créer de nouveaux dans la même importation :
```csv
email,firstName,lastName,jobTitle
john@acme.com,John,Smith,Senior Manager ← Updates existing (email matches)
newperson@acme.com,New,Person,Analyst ← Creates new (email doesn't match)
```
## Erreurs courantes à éviter
| Erreur | Problème | Résultat | Solution |
| --------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------- |
| **Modifier l'identifiant unique** | Remplacé `john@acme.com` par `john.smith@acme.com` | Crée un nouvel enregistrement au lieu de mettre à jour | Conservez les identifiants uniques inchangés |
| **Plusieurs champs uniques** | Association de `email` ET `id` | Risques de conflits de correspondance | N'associez qu'UN SEUL identifiant unique |
| **Pas d'identifiant unique** | Le fichier ne contient que `firstName`, `lastName`, `jobTitle` | Toutes les lignes créent de nouveaux enregistrements | Incluez toujours `email`, `domain` ou `id` |
| **Incohérence de casse** | Le fichier contient `John@acme.com` mais Twenty contient `john@acme.com` | Crée un nouvel enregistrement | Exportez depuis Twenty pour obtenir les valeurs exactes |
## FAQ
<AccordionGroup>
<Accordion title="Que se passe-t-il si certains enregistrements n'existent pas encore ?">
Les enregistrements avec des identifiants uniques qui ne correspondent à aucun enregistrement existant seront créés comme de nouveaux enregistrements. Cela vous permet de mettre à jour et de créer dans la même importation.
</Accordion>
<Accordion title="Puis-je effacer/vider la valeur d'un champ ?">
Oui, laissez la cellule vide dans votre CSV. L'importation effacera la valeur de ce champ sur l'enregistrement existant.
</Accordion>
<Accordion title="Que se passe-t-il pour les champs que je n'inclus pas dans l'import ?">
Les champs qui ne figurent pas dans votre fichier d'import restent inchangés sur les enregistrements existants. Seuls les champs que vous incluez sont mis à jour.
</Accordion>
<Accordion title="Puis-je mettre à jour des champs de relation (comme Entreprise) ?">
Oui! Incluez l'identifiant unique de la relation (par ex., `companyDomain`) et associez-le au champ de relation. La relation sera mise à jour.
</Accordion>
<Accordion title="Comment savoir quels enregistrements seront mis à jour et lesquels seront créés ?">
Lors de l'étape de révision de l'import, Twenty vous indique combien d'enregistrements seront mis à jour ou créés en fonction des correspondances d'identifiants uniques.
</Accordion>
<Accordion title="Puis-je annuler une mise à jour en masse ?">
Il n'existe pas d'annulation automatique. Nous recommandons d'exporter vos données comme sauvegarde avant d'effectuer des mises à jour en masse.
</Accordion>
</AccordionGroup>
## Meilleures pratiques
1. **Exportez d'abord** — commencez toujours à partir d'une exportation pour garantir le bon format
2. **Sauvegardez avant de mettre à jour** — exportez vos données avant d'effectuer des modifications en masse
3. **Testez avec quelques enregistrements** — essayez d'abord de mettre à jour 5 à 10 enregistrements avant d'effectuer un lot important
4. **Utilisez des identifiants lisibles par un humain** — `email` et `domain` sont plus faciles à vérifier que `id`
5. **Incluez uniquement les colonnes nécessaires** — moins de colonnes signifie moins de risques d'erreurs
## Résolution des problèmes
Vous rencontrez des problèmes ? Consultez :
* [Comment corriger les erreurs d'import](/l/fr/user-guide/data-migration/how-tos/fix-import-errors)
* [Contraintes d'unicité](/l/fr/user-guide/data-migration/capabilities/uniqueness-constraints)
* [Référence de correspondance des champs](/l/fr/user-guide/data-migration/capabilities/field-mapping)

View File

@@ -0,0 +1,83 @@
---
title: Migration de données
description: Importez et exportez vos données CRM via des fichiers CSV ou l’API.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Méthodes d’import
Twenty prend en charge deux méthodes principales d’import de données :
| Méthode | Idéal pour | Limite de volume |
| ----------------------- | -------------------------------------------- | ---------------------------------- |
| **Importation CSV** | Migrations standard, mises à jour régulières | 10 000 enregistrements par fichier |
| **Importation via API** | Migrations à grande échelle, automatisation | Illimité |
<Note>Pour des ensembles de données très volumineux (des centaines de milliers d’enregistrements), utilisez l’API. Nos [partenaires d’implémentation](/l/fr/user-guide/getting-started/capabilities/implementation-services) peuvent vous aider à exécuter ces scripts si nécessaire.</Note>
## Principes de base de l’import CSV
Vous pouvez importer des données pour n’importe quel objet à l’aide de fichiers CSV, XLSX ou XLS. Chaque fichier doit contenir **un seul type d’objet** (par exemple, uniquement des enregistrements Personnes).
<Note>**Les champs doivent exister avant l’import.** Le téléversement d’un CSV crée des enregistrements, mais ne crée pas de champs. Si vous avez besoin de champs personnalisés, créez-les d’abord dans **Paramètres → Modèle de données**.</Note>
### Étapes
1. Accédez à l’objet dans lequel vous souhaitez importer des données
2. Cliquez sur l’icône **⋮** en haut à droite (le menu Commande), puis cliquez sur **Importer des enregistrements**
3. Téléchargez le fichier modèle pour garantir que vos données sont au format attendu
4. Téléversez votre fichier CSV formaté
5. Faites correspondre vos colonnes aux champs Twenty
6. Passez en revue les erreurs (surlignées en jaune) et corrigez-les en les modifiant directement dans l’interface
7. Confirmez l’importation
### Importer des relations entre objets
Vous pouvez importer des relations entre objets à l’aide de la fonction d’import CSV. Vous devez référencer l’objet lié en utilisant un champ unique de cet objet : l’`id`, l’`email` pour les Personnes et les membres de l’espace de travail, le `domain` pour les entreprises, tout autre champ défini comme unique dans le modèle de données pour tout autre objet.
<Note>**Les enregistrements supprimés comptent pour l’unicité.** Les enregistrements supprimés de façon logique (visibles dans le menu Commande → Voir les enregistrements supprimés) sont inclus dans les vérifications d’unicité. Si vous importez un enregistrement ayant la même valeur unique qu’un enregistrement supprimé, l’enregistrement supprimé sera restauré.</Note>
<Warning>
**L’ordre d’importation est important !**
Lors de l’import d’objets liés, téléversez les fichiers dans cet ordre :
1. **Entreprises** d’abord (le côté "un" des relations)
2. **Personnes** en second (liées aux Entreprises via companyId)
3. **Opportunités** en troisième (liées aux Entreprises/Personnes)
4. **Objets personnalisés** avec relations en dernier
Pourquoi ? Le côté "un" d’une relation un-à-plusieurs doit exister avant que vous puissiez y faire référence. Par exemple, l’enregistrement Entreprise doit exister avant d’importer une Personne avec l’ID de cette entreprise.
</Warning>
Veuillez consulter [cet article](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) pour un guide étape par étape sur la procédure à suivre.
## Exporter des données
Exportez les données de votre espace de travail pour des sauvegardes, des rapports ou des migrations.
### Étapes
1. Accédez à l’objet que vous souhaitez exporter
2. Configurez la vue avec les colonnes dont vous avez besoin
3. Cliquez sur **⋮** → **Exporter la vue**
4. Enregistrez le fichier CSV
<Note>**Seules les colonnes visibles sont exportées.** Le fichier CSV ne contiendra que les colonnes affichées dans votre vue actuelle. Ajoutez ou masquez des colonnes avant l’exportation pour contrôler les données incluses.</Note>
<Note>**Limites d’exportation** : jusqu’à 20 000 enregistrements par export.</Note>
## Autorisations
L’import et l’export de données nécessitent des autorisations spécifiques :
* **Importation** : nécessite l’autorisation "Import CSV"
* **Exportation** : nécessite l’autorisation "Export CSV"
Contactez l’administrateur de votre espace de travail si vous n’avez pas ces autorisations.
## Prochaines étapes
* [Préparez vos fichiers CSV](/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files)
* [Importer des relations entre objets](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [Importer via API pour de grands ensembles de données](/l/fr/user-guide/data-migration/how-tos/import-data-via-api)

View File

@@ -0,0 +1,122 @@
---
title: Champs
description: Comprendre le rôle des champs et comment les gérer.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## À propos des Champs
Les champs sont comme les colonnes d'une feuille de calcul. Ils stockent différents types de données comme du texte, des chiffres ou des dates. Les champs peuvent être standard (intégrés) ou personnalisés (ceux que vous créez).
### Champs Standards
Les champs standard sont intégrés à Twenty pour répondre aux besoins professionnels courants.
Par exemple, `Prénom` et `Nom de famille` sont des champs standards dans l'objet `Personnes`. Ils stockent des données textuelles pour les noms individuels.
Vous ne pouvez pas supprimer les champs standard, mais vous pouvez les désactiver si vous n'en avez pas besoin.
Vous pouvez également personnaliser les options des champs standard de type `SELECT`, par exemple les options pour l’`Étape` des Opportunités.
<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />
### Champs Personnalisés
Les champs personnalisés peuvent être ajoutés à n'importe quel objet. Vous pouvez stocker du texte, des chiffres, des dates, des sélections déroulantes, et plus encore. Utilisez les champs personnalisés pour suivre des informations spécifiques à votre entreprise.
Par exemple, un champ personnalisé pour SpaceX pourrait être `Statut Actif de la Fusée`, indiquant si une fusée est opérationnelle.
<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />
## Types de champs
Twenty prend en charge divers types de champs :
| Type | Description | Exemple |
| ------------------ | ----------------------------------------------------------- | -------------------------- |
| Adresse | Adresse structurée avec rue, ville, état, pays, code postal | Adresse du bureau |
| Tableau | Liste de valeurs textuelles | Étiquettes |
| Booléen | Case à cocher vrai/faux | Actif |
| Devise | Valeur monétaire avec code de devise | Montant de l’affaire (USD) |
| Date | Valeurs de date | Date de clôture |
| Date et heure | Date avec heure | Heure de réunion |
| Domaine | Domaine de site web (utilisé pour les Entreprises) | acme.com |
| E-mail | Adresses e-mail (principale + supplémentaires) | Adresse e-mail du contact |
| JSON | Données JSON structurées | Métadonnées personnalisées |
| Liens | URL avec libellés (primaire + secondaire) | Site web, LinkedIn |
| Texte long | Texte sur plusieurs lignes | Description, Notes |
| Sélection multiple | Choix multiples à partir d’une liste prédéfinie | Étiquettes, Catégories |
| Nombre | Valeurs numériques (entières ou décimales) | Quantité, Score |
| Téléphone | Numéros de téléphone avec indicatif du pays | Téléphone professionnel |
| Note | Notation par étoiles (1-5) | Priorité, Score |
| Relation | Liens vers des enregistrements dans d’autres objets | Entreprise → Personnes |
| Sélection | Choix unique à partir d’une liste prédéfinie | Étape, Statut |
| Texte | Texte sur une seule ligne | Nom, Titre |
## Créer un Champ Personnalisé
Pour ajouter un champ personnalisé à n'importe quel objet, suivez ces étapes:
1. Allez dans les `Paramètres` dans la barre latérale gauche.
2. Allez dans le `Modèle de Données`, puis sélectionnez l'objet que vous souhaitez personnaliser.
3. Continuez en cliquant sur `+ Nouveau champ`.
4. Choisissez un nom de champ et un type qui répondent à vos exigences. Envisagez d'ajouter une description du champ pour une meilleure compréhension.
Votre nouveau champ est maintenant disponible dans les champs de l'application. Pour l'afficher sur une vue spécifique, cliquez sur le menu des options, puis sélectionnez `Champs`.
<VimeoEmbed videoId="927628219" title="Démonstration vidéo" />
**Méthode rapide:** Cliquez sur le bouton **+** en haut à droite de tout tableau d'objet, puis sélectionnez `Personnaliser les champs`. Cela vous amène directement aux paramètres du Modèle de Données.
<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />
## Désactiver un champ
Vous pouvez désactiver un champ pour le masquer dans l'application sans perdre vos données. Considérez cela comme masquer le champ plutôt que de le supprimer.
Voici comment vous pouvez le faire:
1. Trouvez le champ que vous voulez désactiver dans vos paramètres d'objet.
2. Cliquez sur les trois points `⋮` à côté du champ pour ouvrir le menu.
3. Sélectionnez `Désactiver` dans le menu déroulant.
<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />
Que se passe-t-il lorsque vous désactivez un champ?
1. **Dans l'application :** Le champ disparaît et vous ne pouvez plus ajouter de nouvelles valeurs.
2. **Relations existantes :** S'il s'agit d'un champ de relation, les connexions existantes restent, mais vous ne pouvez pas en créer de nouvelles.
3. **Accès API :** Vous pouvez toujours accéder au champ et à ses données par l'API.
Vous pouvez réactiver les champs standards et personnalisés ou avoir l'option de les supprimer définitivement.
## Rendre les Champs Uniques
Rendez un champ unique pour garantir que des enregistrements distincts ne peuvent pas avoir la même valeur. Par exemple, les adresses e-mail sont uniques pour chaque personne.
Si vous obtenez une erreur lors de la définition de l'unicité, vérifiez les valeurs en double dans vos données (y compris les enregistrements supprimés).
## Index (avancé)
Les index de base de données sont gérés automatiquement — ajouter les vôtres est rarement nécessaire et il est facile de se tromper. Lorsque le mode avancé est activé, chaque objet possède une section **Index** sous `Paramètres → Modèle de données → <object>` pour les cas où vous savez que vous en avez besoin.
## Bonnes pratiques de configuration des champs
### Conventions de nommage et limitations
* **Les noms au singulier et au pluriel doivent être distincts** : Notre API GraphQL nécessite des noms distincts pour les mutations
* **Noms de champs protégés** : certains noms sont réservés à l’usage du système (par exemple, `Type`, `Application`)
### Champs de devise et de téléphone
* **Devise par défaut** : peut être configurée via le modèle de données
* **Codes de pays par défaut** : peuvent être configurés pour les champs téléphoniques via le modèle de données
### Champs de sélection
* **Une option par défaut peut être sélectionnée** pour chaque champ de sélection
### Champs de texte d'enregistrement
* **Chaque objet a un champ d'affichage principal**: Ce champ apparaît dans la colonne la plus à gauche et représente l'enregistrement lorsqu'il est lié à d'autres objets. Il doit s'agir d'un champ de texte. Par exemple, le champ `Nom` est utilisé pour les Personnes comme champ principal, donc lorsque vous liez une personne à une entreprise, vous verrez son nom dans la vue de l'entreprise.

View File

@@ -0,0 +1,92 @@
---
title: Objets
description: Découvrez les objets standard et personnalisés dans Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Objets Standard
Les objets standard sont des entités prédéfinies dans votre espace de travail pour vous aider à commencer. Ils font partie d'un modèle de données partagé accessible à tous les utilisateurs de Twenty. Vous pouvez les utiliser tels quels, les personnaliser ou les désactiver.
<img src="/images/user-guide/objects/standard-objects.png" style={{width:'100%'}} />
### Personnes
L'objet `Personnes` stocke vos contacts. Il inclut les détails de contact et l'historique des interactions, afin que vous puissiez voir toutes vos interactions client en un seul endroit.
### Entreprises
L'objet `Entreprises` stocke vos comptes professionnels. Il inclut des détails tels que l'industrie, la taille et la localisation. Les entreprises se connectent aux objets `Personnes` et `Opportunités`.
### Opportunités
L'objet `Opportunités` stocke les données liées aux affaires. Il suit la progression des ventes potentielles, de la prospection à la clôture, en enregistrant les étapes, les tailles des affaires, le compte associé et la date prévue de clôture. Vous pouvez visualiser votre pipeline de ventes dans une mise en page kanban.
### Notes
L'objet `Notes` stocke des notes en texte libre qui peuvent être associées à des Personnes, des Entreprises, des Opportunités et d'autres enregistrements. Utilisez les notes pour consigner des comptes rendus de réunion, des détails importants ou toute information contextuelle.
### Tâches
L'objet `Tasks` stocke des tâches à faire et des actions à effectuer. Les tâches peuvent être liées à des Personnes, des Entreprises, des Opportunités et à d'autres enregistrements. Suivez les dates d'échéance, les responsables et l'état d'achèvement pour garder la maîtrise de vos suivis.
## Objets personnalisés
Les objets personnalisés vous permettent de stocker des informations uniques à votre organisation que les objets standards ne peuvent pas gérer. Par exemple, si vous êtes SpaceX, vous pouvez créer un objet personnalisé pour les Fusées et les Lancements.
<img src="/images/user-guide/objects/custom-objects.png" style={{width:'100%'}} />
### Créer un nouvel objet personnalisé
Pour créer un nouvel objet personnalisé :
1. Accédez à Paramètres dans la barre latérale à gauche.
2. Sous Espace de travail, allez sur le Modèle de données. Ici vous pourrez voir un aperçu de tous vos objets standards et personnalisés existants (actifs et désactivés).
<VimeoEmbed videoId="926288174" title="Démonstration vidéo" />
3. Cliquez sur `+ Nouvel objet` en haut. Entrez le nom (à la fois singulier et pluriel), choisissez une icône, ajoutez une description pour votre objet personnalisé et cliquez sur Enregistrer (en haut à droite). En utilisant Listing comme exemple d'objet personnalisé, le singulier serait "listing" et le pluriel serait "listings" avec une description comme "Les annonces que les hôtes ont créées pour présenter leur propriété."
4. Votre objet personnalisé est maintenant créé et apparaîtra dans votre barre latérale. Vous pouvez commencer à y ajouter des enregistrements immédiatement.
## Gestion des objets
### Désactivation des objets
Si vous n'avez pas besoin d'un objet standard ou personnalisé :
1. Allez dans Paramètres → Modèle de données
2. Trouvez l'objet que vous voulez désactiver et cliquez dessus
3. Allez à l'onglet **Paramètres** de l'objet
4. Cliquez sur le bouton `Désactiver`
5. L'objet sera masqué dans votre espace de travail, mais ses données seront conservées
### Réactivation des objets
Pour réactiver un objet désactivé :
1. Allez dans Paramètres → Modèle de données
2. Activer le filtre `Désactivé`
3. Recherchez les objets désactivés (ils ont `désactivé` à côté de leur nom)
4. Cliquez sur `⋮`, puis sur `Activer` pour le réactiver
5. L'objet et toutes ses données seront restaurés
## Meilleures pratiques
### Quand créer des objets personnalisés
* **Entités métier uniques** : Éléments spécifiques à votre secteur ou à votre processus
* **Relations complexes** : Lorsque vous devez suivre les liens entre plusieurs entités
* **Données évolutives** : Lorsque vous pouvez avoir de nombreuses occurrences d'un élément
### Quand utiliser des champs à la place
* **Attributs simples** : Propriétés qui décrivent des objets existants
* **Catégories ou libellés** : Moyens de classer des enregistrements existants
* **Valeurs uniques** : Informations qui n'ont pas besoin de leur propre cycle de vie
### Nommage des objets
* **Utilisez des noms clairs et explicites** : Indiquez clairement ce que représente l'objet
* **Suivez les conventions** : utilisez le singulier pour le nom de l'objet, le pluriel pour la collection
* **Tenez compte de votre équipe** : Choisissez des noms que tout le monde comprendra

View File

@@ -0,0 +1,94 @@
---
title: Champs de relation
description: Reliez des enregistrements entre différents objets à l'aide de champs de relation.
---
## Types de relations
### Un-à-plusieurs
Un enregistrement de l'Objet A peut être lié à de nombreux enregistrements de l'Objet B.
**Exemple :** Une Entreprise peut avoir de nombreuses Personnes (employés).
### Plusieurs-à-un
De nombreux enregistrements de l'Objet A peuvent être liés à un enregistrement de l'Objet B.
**Exemple :** De nombreuses Personnes peuvent appartenir à une Entreprise.
### Relations vers plusieurs types d'objets
Certains objets peuvent se lier à plusieurs types d'objets sur un côté de la relation.
**Exemple :** Une Note peut être rattachée simultanément à une Personne ET à une Entreprise ET à une Opportunité. La Note est du côté "plusieurs", et se connecte à plusieurs côtés "un".
<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
De même, un Projet (du côté "un") pourrait recevoir des liens de plusieurs Personnes, de plusieurs Entreprises et de plusieurs Notes.
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
**Limitation d'import/export** : Les relations pointant vers plusieurs types d'objets ne sont pas encore prises en charge pour l'import/export CSV. C'est sur notre feuille de route.
</Warning>
### Plusieurs-à-plusieurs
De nombreux enregistrements de l'Objet A peuvent être liés à de nombreux enregistrements de l'Objet B.
**Exemple :** De nombreuses Personnes peuvent être liées à de nombreux Projets, et inversement.
Les relations plusieurs-à-plusieurs utilisent un modèle d'**objet de jonction**: un objet intermédiaire qui relie les deux côtés. Avec la fonctionnalité de relation via objet de jonction, Twenty affiche directement les enregistrements finaux liés, en masquant l'objet intermédiaire dans l'interface utilisateur.
<Warning>
**Fonctionnalité bêta**: Les relations de jonction doivent être activées dans **Paramètres → Communauté → Fonctionnalités** avant l'utilisation.
</Warning>
Voir [Comment créer des relations plusieurs-à-plusieurs](/l/fr/user-guide/data-model/how-tos/create-many-to-many-relations) pour un guide pas à pas complet.
## Créer un champ de relation
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez l'objet dans lequel vous souhaitez ajouter la relation
3. Cliquez sur **+ Nouveau champ**
4. Sélectionnez **Relation** comme type de champ
5. Choisissez l'objet cible ou les objets cibles à relier
6. Configurez les paramètres de la relation :
* **Nom du champ sur l'objet source** : Le nom du champ de relation sur l'objet que vous modifiez
* **Nom du champ sur l'objet de destination** : Le nom du champ de relation qui apparaîtra sur l'objet cible
* Type de relation (un-à-plusieurs, plusieurs-à-un)
7. Cliquez sur **Enregistrer**
## Relations standard
Twenty est livré avec des relations prédéfinies entre des objets standard :
| Objet source | Objet de destination | Type de relation |
| ------------ | -------------------- | ---------------- |
| Personnes | Entreprises | Plusieurs-à-un |
| Opportunités | Entreprises | Plusieurs-à-un |
| Opportunités | Personnes | Plusieurs-à-un |
## Meilleures pratiques
### Planifier les relations
* **Cartographiez votre modèle de données** : Planifiez les relations avant de les créer
* **Tenez compte de la direction** : Réfléchissez à l'objet qui "possède" la relation
* **Évitez les dépendances circulaires** : Gardez votre modèle de données propre
### Nommer les relations
* **Utilisez des noms clairs** : Indiquez clairement ce que représente la relation
* **Soyez cohérent** : Utilisez des conventions de nommage similaires dans l'ensemble des relations
* **Prenez en compte les deux côtés** : Nommez correctement les deux côtés de la relation
### Performances
* **N'abusez pas des relations** : Trop de relations peuvent ralentir votre espace de travail
## Limitations
* **La suppression des relations** supprime le lien, mais pas les enregistrements associés
* **Les relations circulaires** doivent être évitées pour préserver l'intégrité des données

View File

@@ -0,0 +1,72 @@
---
title: Créer des Champs Personnalisés
description: Guide étape par étape pour ajouter des champs personnalisés à n'importe quel objet.
---
Les champs personnalisés vous permettent de capturer des informations spécifiques à votre entreprise. Ajoutez-les à n'importe quel objet — standard ou personnalisé.
## Étapes
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez l'objet auquel vous souhaitez ajouter un champ
3. Cliquez sur **+ Nouveau champ**
4. Choisissez un **type de champ** (voir [Champs](/l/fr/user-guide/data-model/capabilities/fields) pour tous les types)
5. Saisissez le **nom du champ** et une description facultative
6. Configurez les paramètres spécifiques au champ (voir ci-dessous)
7. Cliquez sur **Enregistrer**
**Méthode rapide :** Cliquez sur le **+** à la fin des en-têtes de colonne dans n'importe quelle vue en tableau → **Personnaliser les champs**.
## Afficher le champ dans les vues
Les nouveaux champs ne sont pas visibles automatiquement. Pour l'afficher :
1. Ouvrez la vue en tableau de l'objet
2. Cliquez sur **Options → Champs**
3. Cliquez sur l'**icône en forme d'œil** à côté de votre champ pour l'afficher
4. Faites glisser pour réorganiser
## Options de configuration
### Pour Sélection / Sélection multiple
1. Cliquez sur **+ Ajouter une option** pour créer des choix
2. Définissez une **option par défaut** si vous le souhaitez
3. Faites glisser pour réorganiser les options
<Note>
**Utilisez les noms d'API pour les importations.** Activez le **mode avancé** dans Paramètres pour voir les noms d'API. Voir [Correspondance des champs](/l/fr/user-guide/data-migration/capabilities/field-mapping).
</Note>
### Pour les champs de devise
Définissez la **devise par défaut** (USD, EUR, etc.) pour les nouveaux enregistrements.
### Pour les champs de téléphone
Définissez le **code du pays par défaut** à préremplir pour les nouveaux numéros de téléphone.
### Rendre un champ unique
Activez **Unique** pour empêcher les valeurs en double dans l'ensemble des enregistrements.
<Note>
S'il existe des doublons (y compris dans les enregistrements supprimés), une erreur s'affichera. Commencez par supprimer les doublons.
</Note>
### Définir des valeurs par défaut
Pour les champs Sélection, vous pouvez choisir quelle option est présélectionnée pour les nouveaux enregistrements. Pour les champs Case à cocher, définissez s'ils sont cochés ou décochés par défaut.
## Désactiver un champ
1. Allez dans **Paramètres → Modèle de données**
2. Recherchez le champ
3. Cliquez sur **⋮ → Désactiver**
Les données sont conservées. Vous pourrez le réactiver ou le supprimer définitivement plus tard.
## Articles connexes
* [Champs](/l/fr/user-guide/data-model/capabilities/fields) — tous les types de champs expliqués
* [FAQ du modèle de données](/l/fr/user-guide/data-model/how-tos/data-model-faq) — questions fréquentes

View File

@@ -0,0 +1,51 @@
---
title: Créer des objets personnalisés
description: Guide étape par étape pour créer des objets personnalisés dans Twenty.
---
Les objets personnalisés vous permettent de stocker des informations propres à votre entreprise que les objets standard ne couvrent pas. Par exemple : Projets, Produits, Tickets ou Annonces.
<Note>
**Vous ne savez pas si vous avez besoin d'un objet ou d'un champ ?** Consultez [Comprendre votre modèle de données](/l/fr/user-guide/data-model/overview) pour des conseils.
</Note>
## Étapes
1. Allez dans **Paramètres → Modèle de données**
2. Cliquez sur **+ Ajouter un objet**
3. Renseignez :
* **Nom au singulier** (p. ex. "Annonce")
* **Nom au pluriel** (p. ex. "Annonces")
* **Icône**
* **Description** (facultative)
4. Cliquez sur **Enregistrer**
Votre objet apparaît immédiatement dans la barre latérale.
## Ensuite : ajouter des champs
Les nouveaux objets commencent avec des champs de base. Ajoutez des champs personnalisés pour saisir les données dont vous avez besoin :
1. Dans **Paramètres → Modèle de données**, sélectionnez votre objet
2. Cliquez sur **+ Nouveau champ**
3. Choisissez un type de champ, configurez et enregistrez
Voir [Comment créer des champs personnalisés](/l/fr/user-guide/data-model/how-tos/create-custom-fields) pour des détails sur les types de champs et la configuration.
## Connexion à d'autres objets
Pour lier votre objet à des Personnes, des Entreprises ou à d'autres objets, créez un champ de relation. Voir [Comment créer des champs de relation](/l/fr/user-guide/data-model/how-tos/create-relation-fields).
## Désactivation d'un objet
Si vous n'avez plus besoin d'un objet :
1. Allez dans **Paramètres → Modèle de données → objet de votre choix → Paramètres**
2. Cliquez sur le bouton **Désactiver**
L'objet est masqué, mais les données sont conservées. Vous pourrez le réactiver ou le supprimer définitivement plus tard.
## Articles connexes
* [Objets](/l/fr/user-guide/data-model/capabilities/objects) — objets standard vs objets personnalisés
* [FAQ du modèle de données](/l/fr/user-guide/data-model/how-tos/data-model-faq) — questions fréquentes

View File

@@ -0,0 +1,175 @@
---
title: Créer des relations plusieurs-à-plusieurs
description: Reliez des enregistrements lorsque de nombreux éléments des deux côtés peuvent être associés ensemble au moyen d'objets de jonction.
---
Les relations plusieurs-à-plusieurs vous permettent de relier plusieurs enregistrements des deux côtés. Par exemple : de nombreuses Personnes peuvent travailler sur de nombreux Projets, et chaque Projet peut avoir de nombreuses Personnes.
<Warning>
**Fonctionnalité bêta** : Les relations de jonction sont actuellement en bêta. Activez-les dans **Paramètres → Communauté → Fonctionnalités** avant de suivre ce guide.
</Warning>
<Note>
Cette fonctionnalité exige également que le **mode avancé** soit activé (bascule en bas à gauche des Paramètres).
</Note>
## Quand utiliser les relations plusieurs-à-plusieurs
Utilisez plusieurs-à-plusieurs lorsque les deux côtés d'une relation peuvent avoir plusieurs connexions :
| Relation | Exemple |
| ------------------------ | ------------------------------------------------------------------------------------------------------- |
| Personnes ↔ Projets | Une personne travaille sur plusieurs projets ; un projet a plusieurs membres de l'équipe |
| Entreprises ↔ Étiquettes | Une entreprise peut avoir plusieurs étiquettes ; une étiquette peut s'appliquer à plusieurs entreprises |
| Produits ↔ Commandes | Un produit peut se trouver dans plusieurs commandes ; une commande contient plusieurs produits |
## Comment ça marche
Twenty utilise un modèle d'**objet de jonction** pour les relations plusieurs-à-plusieurs. Un objet de jonction se situe entre deux objets et conserve les connexions :
```
People ←→ Project Assignments ←→ Projects
```
L'objet **Affectations de projet** (jonction) comporte :
* Une relation vers Personnes (plusieurs-à-un)
* Une relation vers Projets (plusieurs-à-un)
Lorsque vous activez la bascule de relation de jonction, Twenty affiche directement les enregistrements liés au lieu d'afficher les enregistrements de jonction intermédiaires.
## Prérequis
1. **Activer les relations de jonction dans les fonctionnalités bêta** : Allez dans **Paramètres → Communauté → Fonctionnalités** et activez **Relations de jonction**
2. **Activer le mode avancé** : Activez le **mode avancé** via la bascule en bas à gauche de la barre latérale des Paramètres
3. Planifiez votre modèle de données :
* Quels sont les deux objets que vous connectez ?
* Comment doit s'appeler l'objet de jonction ?
## Étape 1 : Créer l'objet de jonction
D'abord, créez l'objet intermédiaire qui contiendra les connexions.
1. Allez dans **Paramètres → Modèle de données**
2. Cliquez sur **+ Ajouter un objet**
3. Donnez-lui un nom explicite (p. ex., "Affectation de projet", "Membre de l'équipe", "Commande de produit")
4. Activez l’option "Ignorer la création d’un champ Nom"
<img src="/images/user-guide/fields/new-pivot-object.png" alt="Nouvel objet de jonction" />
5. Cliquez sur **Enregistrer**
<Tip>
**Convention de nommage** : Utilisez un nom qui décrit la relation, comme "Affectation de projet" ou "Appartenance à l'équipe". Cela rend le modèle de données plus facile à comprendre.
</Tip>
## Étape 2 : Créer des relations entre les objets et l’objet de jonction
Ajoutez des champs de relation depuis chacun de vos deux objets vers l’objet de jonction.
### Première relation (Objet A → Jonction)
1. Sélectionnez votre premier objet dans **Paramètres → Modèle de données**
2. Cliquez sur **+ Ajouter une relation**
3. Sélectionnez l’objet de jonction (p. ex., "Affectations de projet")
4. Définissez le type de relation sur **Un-à-plusieurs** (une personne peut être liée à de nombreuses affectations)
5. Nommez les champs :
* Champ sur Personnes : p. ex., "Affectations de projet"
* Champ sur la jonction : p. ex., "Personne"
6. Cliquez sur **Enregistrer**
### Deuxième relation (Objet B → Jonction)
1. Sélectionnez votre deuxième objet dans **Paramètres → Modèle de données**
2. Cliquez sur **+ Ajouter une relation**
3. Sélectionnez l’objet de jonction (p. ex., "Affectations de projet")
4. Définissez le type de relation sur **Un-à-plusieurs** (un projet peut être lié à de nombreuses affectations)
5. Activez **"Il s'agit d'une relation vers un objet de jonction"**
<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}} />
6. Nommez les champs :
* Champ sur la jonction : p. ex., "Projet"
* Champ sur Projets : p. ex., "Membres de l'équipe"
7. Cliquez sur **Enregistrer**
## Étape 3 : Configurer l'affichage de la relation de jonction
Configurez maintenant les objets sources pour afficher directement les enregistrements liés, en ignorant l'objet de jonction intermédiaire.
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez le premier objet (p. ex., "Personnes")
3. Recherchez le champ de relation pointant vers l'objet de jonction (p. ex., "Affectations de projet")
4. Cliquez pour modifier le champ
5. Activez **"Il s'agit d'une relation vers un objet de jonction"**
6. Sélectionnez la **relation cible** (p. ex., "Projet" — le champ sur la jonction qui pointe vers l'autre côté)
7. Cliquez sur **Enregistrer**
## Résultat
Après configuration :
* Sur un enregistrement **Personne**, le champ "Affectations de projet" affiche directement les **Projets** (et non les enregistrements d'affectation)
* Sur un enregistrement **Projet**, le champ "Membres de l'équipe" affiche directement les **Personnes**
L'objet de jonction existe toujours et stocke les connexions, mais l'interface présente une vue plusieurs-à-plusieurs plus épurée.
## Exemple : Personnes ↔ Projets
Voici un guide complet :
### Créer l'objet de jonction
* Nom : **Affectation de projet**
* Description : "Associe les personnes aux projets sur lesquels elles travaillent"
### Ajouter des relations
1. **Personnes → Affectation de projet**
* Type : Un-à-plusieurs
* Champ sur Personnes : "Affectations de projet"
* Champ sur Affectation : "Personne"
2. **Projets → Affectation de projet**
* Type : Un-à-plusieurs
* Champ sur Projets : "Membres de l'équipe"
* Champ sur Affectation : "Projet"
### Configurer l'affichage de la jonction
1. Sur l'objet **Personnes** :
* Modifiez le champ "Affectations de projet"
* Activez la bascule de jonction
* Cible : "Projet"
2. Sur l'objet **Projets** :
* Modifiez le champ "Membres de l'équipe"
* Activez la bascule de jonction
* Cible : "Personne"
### Utilisez-le
* Ouvrez un enregistrement Personne → Voyez directement ses Projets
* Ouvrez un enregistrement Projet → Voyez directement les membres de l'équipe
* Créez de nouvelles connexions depuis les deux côtés
## Ajout de données supplémentaires aux connexions
Comme l'objet de jonction est un véritable objet, vous pouvez ajouter des champs personnalisés pour stocker des informations sur la relation :
* **Rôle** : "Développeur", "Designer", "Responsable"
* **Date de début** : lorsque la personne a rejoint le projet
* **Heures allouées** : Heures hebdomadaires sur ce projet
Pour accéder à ces données, accédez directement à l'objet de jonction ou interrogez-le via l'API.
## Limitations
* **Import/Export CSV** : L'importation directe de relations plusieurs-à-plusieurs n'est pas prise en charge. Importez plutôt des enregistrements dans l'objet de jonction.
* **Filtres** : Le filtrage par relations plusieurs-à-plusieurs peut offrir des options limitées.
## Articles connexes
* [Champs de relation](/l/fr/user-guide/data-model/capabilities/relation-fields) — types de relation expliqués
* [Créer des objets personnalisés](/l/fr/user-guide/data-model/how-tos/create-custom-objects) — comment créer des objets
* [Créer des champs de relation](/l/fr/user-guide/data-model/how-tos/create-relation-fields) — configuration de base des relations

View File

@@ -0,0 +1,70 @@
---
title: Créer des champs de relation
description: Guide étape par étape pour connecter des objets à l'aide de champs de relation.
---
Les champs de relation relient des enregistrements provenant d'objets différents — par exemple, relier des Personnes à des Entreprises.
<Note>
**Les noms de relation ne peuvent pas être modifiés après leur création** (ils affectent l'API). Planifiez soigneusement les noms.
</Note>
## Avant de démarrer
Décidez :
* Quels objets connectez-vous ? (p. ex. : Personnes → Entreprises)
* Quel est le côté "un" ? (p. ex. : Entreprise)
* Quel est le côté "plusieurs" ? (p. ex. : Personnes — de nombreuses personnes travaillent dans une seule entreprise)
* Comment le champ doit-il s'appeler de chaque côté ?
Voir [Champs de relation](/l/fr/user-guide/data-model/capabilities/relation-fields) pour une explication des types de relation.
## Étapes
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez l'objet où vous voulez la relation (généralement le côté "plusieurs")
3. Cliquez sur **+ Nouveau champ**
4. Sélectionnez **Relation** comme type de champ
5. Choisissez l'**objet cible**
6. Sélectionnez **Un-à-plusieurs** ou **Plusieurs-à-un**
7. Saisissez des noms de champ pour **les deux côtés** de la relation
8. Cliquez sur **Enregistrer**
## Exemple : Personnes → Entreprises
* Allez dans **Paramètres → Modèle de données → Personnes**
* Ajoutez un champ de relation
* Cible : **Entreprises**
* Type : **Plusieurs-à-un**
* Champ dans Personnes : **Entreprise**
* Champ dans Entreprises : **Employés**
Désormais, chaque Personne peut être liée à une Entreprise, et chaque Entreprise affiche ses Personnes.
## Désactivation d'une relation
1. Allez dans **Paramètres → Modèle de données → objet de votre choix**
2. Trouvez le champ de relation et cliquez dessus
3. Cliquez sur le bouton **Désactiver**
Les liens sont conservés mais masqués. Réactivez pour restaurer.
<Note>
**La désactivation d'une relation ne supprime pas les enregistrements.** Seul le lien entre eux est supprimé.
</Note>
## Suppression d'une relation
1. Allez dans **Paramètres → Modèle de données → objet de votre choix**
2. Trouvez le champ de relation et cliquez dessus
3. Cliquez sur le bouton **Supprimer**
<Note>
S'applique uniquement aux relations personnalisées. Les relations standard ne peuvent être désactivées.
</Note>
## Connexes
* [Champs de relation](/l/fr/user-guide/data-model/capabilities/relation-fields) — types et limitations
* [Comment importer des relations](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) — importation en masse d'enregistrements liés

View File

@@ -0,0 +1,22 @@
---
title: Personnalisez votre modèle de données
description: Vue d’ensemble des options de personnalisation du modèle de données.
---
Le modèle de données de Twenty est entièrement personnalisable. Créez des objets, des champs et des relations adaptés à votre entreprise.
## Liens rapides
| Je souhaite... | Guide |
| ----------------------------- | ---------------------------------------------------------------------------------------------- |
| Créer un nouvel objet | [Comment créer des objets personnalisés](/l/fr/user-guide/data-model/how-tos/create-custom-objects) |
| Ajouter des champs à un objet | [Comment créer des champs personnalisés](/l/fr/user-guide/data-model/how-tos/create-custom-fields) |
| Relier des objets entre eux | [Comment créer des champs de relation](/l/fr/user-guide/data-model/how-tos/create-relation-fields) |
## En savoir plus
* [Comprendre votre modèle de données](/l/fr/user-guide/data-model/overview) — concepts clés et conseils de planification
* [Objets](/l/fr/user-guide/data-model/capabilities/objects) — objets standard et personnalisés
* [Champs](/l/fr/user-guide/data-model/capabilities/fields) — tous les types de champs
* [Champs de relation](/l/fr/user-guide/data-model/capabilities/relation-fields) — relier des objets
* [FAQ sur le modèle de données](/l/fr/user-guide/data-model/how-tos/data-model-faq) — questions fréquentes

View File

@@ -0,0 +1,157 @@
---
title: FAQ sur le modèle de données
description: Foire aux questions sur le modèle de données de Twenty.
---
## Gestion des objets
<AccordionGroup>
<Accordion title="Puis-je supprimer un objet personnalisé ?">
Oui, les objets personnalisés peuvent être supprimés. Vous pouvez également les désactiver d'abord, ce qui masque l'objet et ses données dans l'interface tout en préservant les données.
</Accordion>
<Accordion title="Puis-je supprimer des objets standard (Personnes, Entreprises, etc.) ?">
Non, les objets standards ne peuvent pas être supprimés. Vous pouvez seulement les désactiver, ce qui les masque dans l'interface tout en préservant les données.
</Accordion>
<Accordion title="Combien d'objets personnalisés puis-je créer ?">
Vous pouvez créer autant d'objets et de champs personnalisés que vous le souhaitez — le prix ne change pas.
</Accordion>
<Accordion title="Puis-je renommer un objet standard ?">
Vous pouvez renommer le libellé des objets standard (Personnes, Entreprises, Opportunités), mais pas leurs noms d'API. Les noms d'API sont fixes pour assurer la cohérence dans tous les espaces de travail Twenty.
</Accordion>
<Accordion title="Puis-je modifier l'icône d'un objet ?">
Oui, vous pouvez modifier l'icône des objets standard et personnalisés dans **Paramètres → Modèle de données**.
</Accordion>
<Accordion title="Puis-je réorganiser les objets dans la barre de navigation à gauche ?">
Pas encore. L'ordre des objets dans la navigation est actuellement fixe, mais cette fonctionnalité est prévue pour une future version.
</Accordion>
<Accordion title="Puis-je masquer des objets de la barre de navigation à gauche ?">
Tous les objets actifs apparaissent dans la navigation. Vous pouvez désactiver les objets dont vous n'avez pas besoin sous **Paramètres → Modèle de données**.
</Accordion>
</AccordionGroup>
## Capacités des champs
<AccordionGroup>
<Accordion title="Puis-je modifier le type d'un champ après sa création ?">
Non, les types de champ ne peuvent pas être modifiés après leur création. Si vous avez besoin d'un type différent, créez un nouveau champ avec le type correct, migrez vos données, puis désactivez l'ancien champ.
</Accordion>
<Accordion title="Pourquoi ai-je besoin de noms singuliers et pluriels différents ?">
Notre API GraphQL utilise les deux formes pour différentes opérations:
* `createPerson` (singulier) pour des actions sur un seul enregistrement
* `createPeople` (pluriel) pour des opérations en masse
Cela crée des limitations lorsque les formes singulier et pluriel sont identiques, mais cela améliore l'expérience développeur.
</Accordion>
<Accordion title="Pourquoi certains noms de champs sont-ils protégés ?">
Certains noms de champs comme `Type` ou `Application` sont réservés à l'usage du système. Choisissez des noms alternatifs comme `Catégorie` ou `Classification`.
</Accordion>
<Accordion title="Que se passe-t-il lorsque je désactive un champ ?">
* Le champ est masqué dans l'interface
* Les données existantes sont conservées
* Vous pouvez toujours accéder au champ via l'API
* Les relations existantes demeurent, mais vous ne pouvez pas en créer de nouvelles
* Vous pouvez réactiver le champ plus tard
</Accordion>
<Accordion title="Puis-je rendre un champ obligatoire ?">
Actuellement, vous ne pouvez pas rendre les champs personnalisés obligatoires. Tous les champs acceptent les valeurs vides. Vous pouvez utiliser des flux de travail pour imposer des champs obligatoires en envoyant des alertes ou en bloquant des actions lorsque des champs sont vides.
</Accordion>
<Accordion title="Quelle est la différence entre unique et obligatoire ?">
* **Unique** : Aucun enregistrement ne peut avoir la même valeur dans ce champ
* **Obligatoire** : Le champ doit avoir une valeur (actuellement non pris en charge pour les champs personnalisés)
</Accordion>
<Accordion title="Puis-je créer des champs de formule ?">
Les champs de formule arrivent dans **H2 2026**. En attendant, vous pouvez utiliser les workflows pour calculer et mettre à jour automatiquement les valeurs des champs.
</Accordion>
<Accordion title="Puis-je avoir des champs imbriqués dans mes objets ?">
Les champs imbriqués arrivent dans **H2 2026**. Actuellement, vous pouvez utiliser des workflows pour extraire des valeurs de champs à partir d'objets connexes. Par exemple, pour afficher le secteur d'une entreprise sur une fiche Personne, créez un champ personnalisé sur Personnes et utilisez un workflow pour synchroniser la valeur.
</Accordion>
<Accordion title="Puis-je réorganiser les champs dans les objets ?">
Oui, allez dans Paramètres → Modèle de données → objet de votre choix → Mise en page et cliquez sur **Personnaliser la page d'enregistrement**. Si ce bouton est désactivé, vous devez créer un enregistrement.
</Accordion>
</AccordionGroup>
## Relations
<AccordionGroup>
<Accordion title="Puis-je avoir une relation pointant vers le même objet ?">
Oui! Les relations auto-référencées sont prises en charge et recommandées pour des cas d'utilisation comme les hiérarchies de comptes. Par exemple, créez une relation d'Entreprises vers Entreprises pour suivre les comptes parent/enfant.
</Accordion>
<Accordion title="Puis-je créer des relations plusieurs-à-plusieurs ?">
De nombreuses relations arrivent dans **H2 2026**. Actuellement, créez un objet intermédiaire avec deux relations un-à-plusieurs comme solution de contournement.
Par exemple, pour lier Personnes et Projets (plusieurs-à-plusieurs), créez un objet "Affectations de projet" avec :
* Une relation vers Personnes (plusieurs affectations → une personne)
* Une relation vers Projets (plusieurs affectations → un projet)
</Accordion>
<Accordion title="Que sont les relations vers plusieurs types d'objets (relations Morph) ?">
Celles-ci permettent à un objet d'être lié à plusieurs types d'objets différents via un seul champ. Par exemple, des Notes peuvent être rattachées simultanément à des Personnes ET à des Entreprises ET à des Opportunités.
Chaque Note est liée en même temps à une Personne, une Entreprise et une Opportunité.
En savoir plus dans [Champs de relation](/l/fr/user-guide/data-model/capabilities/relation-fields).
</Accordion>
<Accordion title="Puis-je avoir plusieurs relations entre les mêmes objets ?">
Oui, vous pouvez créer plusieurs relations entre les deux mêmes objets. Par exemple, une Entreprise pourrait avoir à la fois une relation "Contact principal" et "Contact de facturation" vers Personnes.
</Accordion>
<Accordion title="Que se passe-t-il avec les relations lorsque je supprime un enregistrement ?">
Lorsque vous supprimez un enregistrement, le lien de relation est supprimé des enregistrements associés. Les enregistrements associés ne sont pas supprimés.
</Accordion>
<Accordion title="Puis-je créer des relations circulaires ?">
Bien que techniquement possible, les relations circulaires (A → B → C → A) doivent être évitées car elles peuvent entraîner de la confusion et des problèmes potentiels de performance.
</Accordion>
</AccordionGroup>
## Accès et Permissions
<AccordionGroup>
<Accordion title="Où puis-je voir et modifier mon modèle de données ?">
Accédez à **Paramètres → Modèle de données** pour afficher et modifier tous vos objets et champs.
</Accordion>
<Accordion title="Pourquoi ne puis-je pas voir le modèle de données sous Paramètres ?">
Contactez votre administrateur d'espace de travail. L'accès au modèle de données est généralement limité aux administrateurs uniquement.
</Accordion>
</AccordionGroup>
## Gestion des données
<AccordionGroup>
<Accordion title="Y a-t-il une limite au nombre d'enregistrements que je peux avoir ?">
Il n'y a pas de limite stricte au nombre d'enregistrements. Cependant, des ensembles de données très volumineux peuvent affecter les performances dans certaines vues. Utilisez des filtres et des vues pour gérer efficacement de grands ensembles de données.
</Accordion>
<Accordion title="Puis-je importer des données dans des objets personnalisés ?">
Oui, vous pouvez importer des données CSV dans n'importe quel objet, y compris les objets personnalisés. Le processus d'import prend en charge le mappage des champs pour les champs personnalisés. Voir [Comment préparer vos fichiers CSV](/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files).
</Accordion>
<Accordion title="Puis-je exporter la configuration de mon modèle de données ?">
Actuellement, il n'existe pas d'export intégré pour la configuration du modèle de données. Contactez le support si vous devez migrer votre modèle de données entre des espaces de travail.
</Accordion>
<Accordion title="Combien de champs un seul objet peut-il avoir ?">
Le nombre maximum de champs qu'un seul objet peut avoir est de 1600 champs selon les limites Postgres, y compris les champs existants et supprimés. Sachez que 20 ne corrigeront pas votre espace de travail si la limite de 1600 champs est atteinte car elle relève de notre politique d'utilisation équitable.
</Accordion>
</AccordionGroup>
## Besoin de plus d'aide ?
Consultez nos [services de mise en œuvre](/l/fr/user-guide/getting-started/capabilities/implementation-services) pour obtenir de l'aide pour la conception de modèles de données complexes.

View File

@@ -0,0 +1,177 @@
---
title: Modèle de données
description: Découvrez ce qu'est un modèle de données et comment en concevoir un qui correspond à votre entreprise.
---
## Qu'est-ce qu'un modèle de données ?
Un modèle de données est la structure qui définit comment l’information est organisée dans votre CRM. Considérez-le comme le **plan** de vos données clients — vous le concevez une fois, puis vous le remplissez avec vos données réelles.
## Concepts clés
### Objets
Les **objets** sont les principales catégories de données dans votre CRM. Chaque objet représente un type d'élément que vous souhaitez suivre.
Twenty inclut des objets standard :
* **People** — individus (contacts, prospects, partenaires)
* **Companies** — organisations
* **Opportunities** — affaires ou ventes
* **Notes** — notes jointes aux enregistrements
* **Tasks** — tâches liées aux enregistrements
Vous pouvez également créer des **objets personnalisés** pour tout ce qui est propre à votre entreprise (p. ex., Projets, Abonnements, Événements).
### Champs
Les **champs** sont les propriétés ou attributs qui décrivent chaque objet. Ils stockent les informations réelles.
Par exemple, l'objet **People** comporte des champs tels que :
* Nom
* E-mail
* Téléphone
* Titre du poste
* Company (une relation avec l'objet Companies)
Les champs ont différents **types** : texte, nombre, date, sélection, sélection multiple, relation, etc. Vous pouvez ajouter des champs personnalisés à n'importe quel objet.
### Enregistrements
Les **enregistrements** sont les entrées individuelles au sein d'un objet — les données proprement dites que vous créez et gérez.
Par exemple :
* "John Smith" est un **enregistrement** dans l'objet People
* "Acme Corp" est un **enregistrement** dans l'objet Companies
**Une analogie :**
| Concept du modèle de données | Analogie dans le monde réel |
| ---------------------------- | ---------------------------------------------------------------- |
| **Objets** | Sections d'un livre (les catégories) |
| **Champs** | Colonnes dans une feuille de calcul (les propriétés) |
| **Enregistrements** | Lignes dans une feuille de calcul (les entrées proprement dites) |
Vous concevez le modèle de données (objets + champs) une fois, puis vous créez de nombreux enregistrements dans cette structure.
## Pourquoi personnaliser votre modèle de données ?
Chaque entreprise fonctionne différemment. La personnalisation de votre modèle de données vous permet de façonner Twenty autour de **vos** processus au lieu de forcer les vôtres dans un système rigide.
Twenty offre une flexibilité totale :
* Créez tous les objets personnalisés dont vous avez besoin
* Ajoutez un nombre illimité de champs personnalisés
* Le prix ne change pas en fonction de la personnalisation
## Conseils pour concevoir votre modèle de données
### 1. Commencez par vos objets principaux
Identifiez les principaux concepts avec lesquels vous travaillez. Twenty propose déjà :
* **People** — vos contacts
* **Companies** — vos comptes
* **Opportunities** — vos affaires
Réfléchissez à ce dont vous pourriez avoir besoin :
* Stripe aurait besoin d'un objet `Subscriptions`
* Airbnb aurait besoin d'un objet `Trips`
* Un accélérateur aurait besoin d'un objet `Batches`
### 2. Utilisez des champs pour les variantes plutôt que de nouveaux objets
Si quelque chose n'est qu'une caractéristique d'un objet existant, faites-en un **champ**.
**Utilisez des champs pour :**
* Catégories et libellés (p. ex., `Industry` pour Companies)
* Valeurs de statut (p. ex., `Stage` pour Opportunities)
* Attributs et propriétés
### 3. Créez un objet lorsqu'il est autonome
Si le concept a son propre cycle de vie, ses propriétés ou ses relations, il mérite un objet.
**Créez un objet pour :**
* **Projets** — ont des échéances, des responsables et des tâches
* **Abonnements** — relient des entreprises, des produits et des factures
* **Événements** — impliquent des participants et des actions de suivi
Ceux-ci vont au-delà d'un seul champ car ils transportent leurs propres données et relations.
### 4. Créez un objet lorsque le nombre d'enregistrements est indéterminé
Si quelque chose peut être lié plusieurs fois et que vous ne savez pas combien, utilisez un objet.
**Mauvaise approche :**
Créer des champs comme `Product 1`, `Product 2`, `Product 3`...
**Bonne approche :**
Créez un objet `Products` et reliez-le aux enregistrements. Ainsi, vous pouvez prendre en charge un, deux ou cent produits sans changer votre modèle.
### 5. Commencez par faire simple
Commencez par les champs. Passez à de nouveaux objets seulement lorsque vous en ressentez les limites :
* Trop de champs sur un seul objet
* Enregistrements en double qui devraient être distincts
* Relations qui ne s'intègrent pas parfaitement
## Note spéciale sur les personnes, les entreprises et les opportunités
<Warning>
**La synchronisation des e-mails et du calendrier ne fonctionne qu'avec les Personnes, les Entreprises et les Opportunités.**
Ce sont les seuls objets où vous pouvez accéder aux e-mails et aux réunions synchronisés depuis votre boîte aux lettres/calendrier. Nous recommandons de les utiliser autant que possible.
</Warning>
**Meilleures pratiques:**
* Si vous avez besoin de catégories de Personnes, utilisez des champs (pas de nouveaux objets)
* Exemple : utilisez un champ `Person Type` avec les valeurs "Prospect" et "Partner" au lieu de créer des objets distincts
* Créez différentes **vues** pour filtrer : l'une montrant les partenaires, l'autre montrant les prospects
**Il est acceptable d'avoir des champs qui ne s'appliquent pas à chaque enregistrement.** Par exemple, un champ `Referral Link` sur Personnes qui ne s'applique que lorsque `Person Type = Partner`. Masquez ce champ dans les vues où il n'est pas pertinent.
## Questions pour guider votre choix
Demandez-vous :
<Check>Est-ce simplement une propriété de quelque chose que j'ai déjà, ou a-t-il besoin de ses propres propriétés ?</Check>
<Check>Aurai-je jamais besoin d'en suivre plusieurs par enregistrement, sans savoir combien ?</Check>
<Check>Ce concept se connecte-t-il à plusieurs objets différents, pas seulement un ?</Check>
<Check>Aura-t-il son propre cycle de vie (étapes, dates de début/fin) ?</Check>
Si la réponse est "oui" à l'une ou plusieurs de ces questions, il est probablement temps de créer un nouvel objet.
## Accéder à votre modèle de données
1. Accédez à **Paramètres** dans la barre latérale gauche
2. Cliquez sur **Modèle de données**
3. Affichez tous vos objets (standards et personnalisés)
4. Cliquez sur n'importe quel objet pour voir et modifier ses champs
<Note>
**Vous ne voyez pas le Modèle de données dans Paramètres ?**
L'accès au modèle de données est généralement limité aux administrateurs. Contactez l'administrateur de votre espace de travail si vous avez besoin d'un accès.
</Note>
## Prochaines étapes
Une fois que vous avez planifié votre modèle de données :
* [Comment créer des objets personnalisés](/l/fr/user-guide/data-model/how-tos/create-custom-objects)
* [Comment créer des champs personnalisés](/l/fr/user-guide/data-model/how-tos/create-custom-fields)
* [Comment créer des champs de relation](/l/fr/user-guide/data-model/how-tos/create-relation-fields)
## Besoin d'aide ?
<Tip>
Besoin d'aide pour concevoir votre modèle de données ? [Trouver un partenaire certifié Vingt partenaires] (https://twenty.com/partners/list?categories=SOLUTIONING&ref=docs-data-model) pour concevoir et construire vos objets, champs et relations.
</Tip>

View File

@@ -0,0 +1,104 @@
---
title: Glossaire
description: Familiarisez-vous avec la terminologie essentielle utilisée dans Twenty.
---
## API
L'API (Interface de Programmation d'Applications) permet de connecter Twenty avec d'autres systèmes logiciels et de créer des intégrations personnalisées.
## Applications
Les applications sont des extensions personnalisées, créées sous forme de code, qui peuvent définir des modèles de données et des fonctions de logique métier. Elles permettent aux développeurs de créer des personnalisations réutilisables pouvant être déployées sur plusieurs espaces de travail.
## Actions de code
Les Actions de code sont des étapes de flux de travail qui vous permettent d'écrire du JavaScript personnalisé pour transformer des données, effectuer des calculs ou exécuter une logique complexe qui n'est pas possible avec les actions intégrées.
## Menu de commandes
Le menu de commandes est une interface d'accès rapide (ouverte avec `Cmd + K` sur Mac et `Ctrl + K` sur Windows) qui vous permet d'effectuer des actions, de créer des enregistrements et de naviguer efficacement dans votre espace de travail.
## Entreprise & Personnes
Le CRM a deux types fondamentaux d'enregistrements :
* Une `Entreprise` représente une entreprise ou une organisation.
* Les `Personnes` représentent les clients ou prospects actuels ou potentiels de votre entreprise.
## Champs Personnalisés
Les Champs Personnalisés sont des champs de données que vous créez pour capturer des informations spécifiques aux besoins et processus de votre entreprise.
## Modèle de données
Un Modèle de Données est la structure qui définit comment les informations sont organisées dans votre CRM, y compris quels objets existent, leurs propriétés (champs) et comment ils sont liés les uns aux autres.
## Favoris
Les Favoris sont des enregistrements que vous avez marqués pour un accès rapide, apparaissant dans votre barre latérale pour une navigation instantanée vers des données importantes.
## Champ
Un champ se réfère à une zone spécifique où des données particulières sont stockées pour une entité.
## Itérateur
Un itérateur est une action de flux de travail qui parcourt un tableau d'éléments et exécute les actions suivantes pour chaque élément de la liste.
## Kanban
Un `Kanban` est une manière visuelle de suivre vos processus commerciaux en utilisant des cartes et des colonnes. Chaque colonne représente une étape dans votre processus (par exemple : nouveau, en cours, gagné, perdu), et vous déplacez les enregistrements à travers ces étapes au fur et à mesure de leur progression.
## Objet
Un Objet est une structure de données qui représente un type spécifique d'entité dans votre CRM (comme Personnes, Entreprises ou Opportunités). Les Objets peuvent être standards (intégrés) ou personnalisés (créés par vous).
## Opportunités
Les opportunités dans Twenty CRM sont des affaires ou ventes potentielles avec des comptes ou des contacts.
## Enregistrement
Un enregistrement est une instance d'un objet, comme un compte ou un contact spécifique.
## Champs de relation
Les Champs de Relation créent des connexions entre différents objets, vous permettant de lier des enregistrements ensemble (comme relier une Personne à une Entreprise).
## Champs Standards
Les Champs Standards sont des champs de données prédéfinis qui viennent avec des objets par défaut et fournissent une fonctionnalité commune à tous les espaces de travail.
## Tâches
Les Tâches dans le CRM Twenty sont des activités assignées concernant des contacts, des comptes ou des opportunités.
## Déclencheurs
Les déclencheurs sont le point de départ d'un flux de travail — l'événement ou la condition qui lance l'automatisation. Exemples : création d'enregistrements, mises à jour d'enregistrements, webhooks ou heures planifiées.
## Vues
Vous pouvez personnaliser l'affichage de vos enregistrements en utilisant des vues, en définissant différents filtres, mises en page et options de tri pour chaque vue.
## Upsert
L'upsert est une opération qui combine "update" et "insert" — elle met à jour un enregistrement existant si une correspondance est trouvée, ou crée un nouvel enregistrement si aucune correspondance n'existe.
## Webhooks
Les Webhooks sont des messages automatisés envoyés de Twenty à d'autres applications lorsque des événements spécifiques se produisent, permettant une synchronisation des données en temps réel.
## Flux de travail
Les flux de travail sont des processus automatisés qui déclenchent des actions selon des conditions spécifiques, vous aidant à automatiser des tâches répétitives et des processus métier.
## Espace de travail
Un `Espace de travail` représente généralement une entreprise utilisant Twenty. Il contient tous les enregistrements et données que vous et les membres de votre équipe ajoutez à Twenty.
Il a un nom de domaine unique, qui est généralement le nom de domaine que votre entreprise utilise pour les adresses e-mail des employés.
## Membres de l'espace de travail
Les membres de l'espace de travail sont les utilisateurs de Twenty de votre équipe qui ont accès à votre espace de travail. Ils peuvent être désignés comme propriétaires ou assignés à des enregistrements.

View File

@@ -0,0 +1,17 @@
---
title: Services d'implémentation
description: Que vous ayez besoin d'aide pour commencer ou pour créer des personnalisations avancées, nous avons une solution.
---
## Partenaires pour l'Implémentation
Collaborez avec des partenaires certifiés Twenty pour des personnalisations, des intégrations avancées et une assistance dédiée à la mise en œuvre.
<CardGroup cols={2}>
<Card title="Parcourir les partenaires certifiés" icon="magnifying-glass" href="https://twenty.com/partners/list?ref=docs-implementation-services">
Trouvez un partenaire et contactez-le directement — filtrez par région, langue et expertise.
</Card>
<Card title="Obtenez une mise en relation par Twenty" icon="envelope" href="mailto:contact@twenty.com">
Dites-nous ce dont vous avez besoin et nous vous mettrons en relation avec le bon partenaire.
</Card>
</CardGroup>

View File

@@ -0,0 +1,42 @@
---
title: Qu'est-ce que Twenty
description: Twenty est un CRM open source qui vous fournit les briques de base pour créer exactement ce dont votre entreprise a besoin.
---
## Vision
Créer un bon CRM est difficile car c'est un numéro d'équilibriste.
Pour chaque entreprise, les exigences semblent simples, mais les besoins de chacun sont distincts.
Le résultat est un CRM qui est soit trop basique, soit qui tente d'être polyvalent mais finit par ne maîtriser aucun domaine.
Au départ, Twenty ressemble à la plupart des CRM que vous connaissez déjà : vous pouvez suivre les offres, organiser les contacts, gérer les tâches et les notes.
**Mais ce qui le distingue, c'est notre approche de l'extensibilité. Nous construisons une plateforme ouverte qui fournit les éléments de base pour que vous puissiez résoudre vos problèmes commerciaux uniques.**
Nous privilégions les principes universels et les modèles communs plutôt que les listes de fonctionnalités.
Nous ne prétendons pas avoir toutes les réponses et préférons donner aux utilisateurs le pouvoir de trouver ce qui fonctionne le mieux pour eux.
L'open-source est la pierre angulaire de notre approche, garantissant que Twenty évolue avec sa communauté, pour sa communauté.
## Avantages
**Personnalisable :** Conçu pour répondre à vos besoins professionnels.
**Porté par la communauté :** Construit et maintenu par une large communauté open source.
**Rentable :** Vous ne serez jamais dépendant d'un fournisseur, car vous pouvez toujours l'héberger vous-même.
## Fonctionnalités principales
* **Calendrier et e-mails :** Synchronisez votre boîte de réception et votre calendrier pour voir toutes les communications sur vos enregistrements CRM. [En savoir plus](/l/fr/user-guide/calendar-emails/overview).
* **Modèle de données :** Créez des objets et des champs personnalisés pour correspondre à vos processus métier spécifiques. [Explorer](/l/fr/user-guide/data-model/overview).
* **Migration des données :** Importez et exportez vos données via CSV ou API. [Commencez](/l/fr/user-guide/data-migration/overview).
* **Vues et pipelines :** Organisez vos données avec des vues en tableau, des tableaux kanban et des pipelines de vente. [Découvrir](/l/fr/user-guide/views-pipelines/overview).
* **Flux de travail :** Automatisez vos processus métier et intégrez des outils externes. [Créer des automatisations](/l/fr/user-guide/workflows/overview).
* **IA :** Améliorez votre CRM avec des fonctionnalités et des agents alimentés par l'IA. [Explorer l'IA](/l/fr/user-guide/ai/overview).
* **Tableaux de bord :** Suivez les performances grâce à des rapports et des visualisations personnalisés. [Voir les tableaux de bord](/l/fr/user-guide/dashboards/overview).
* **Autorisations et accès :** Contrôlez qui peut voir, modifier et gérer vos données grâce à des autorisations basées sur les rôles. [Configurer l'accès](/l/fr/user-guide/permissions-access/overview).
* **Notes et tâches :** Créez des notes et des tâches liées à vos enregistrements pour une meilleure collaboration.
* **API & Webhooks :** Connectez-vous à d'autres applications et créez des intégrations personnalisées. [Commencez l'intégration](/l/fr/developers/extend/api).
## Rejoignez maintenant
[Inscrivez-vous ici](https://app.twenty.com) ou [devenez contributeur sur GitHub](https://github.com/twentyhq/twenty).

View File

@@ -0,0 +1,77 @@
---
title: Configurer votre espace de travail
description: Chaque entreprise fonctionne différemment. Commencez par ces 3 étapes pour adapter Twenty à vos besoins.
---
<Note>**Gain rapide**: Commencez par connecter votre boîte aux lettres. Cela vous procure une valeur immédiate et aide votre équipe à voir Twenty en action avec de vraies données. Vous pouvez le faire sous Paramètres → Comptes.</Note>
## 1. Personnalisez votre modèle de données
Twenty offre la flexibilité dont vous avez besoin pour façonner le modèle de données qui soutiendra au mieux votre quotidien.
Créez des objets et champs de tout type, y compris les relations entre vos différents objets. Vous pouvez le faire sous Paramètres → Modèle de données.
Voici quelques conseils :
* **Vous n'êtes pas limité dans le nombre de champs personnalisés ou d'objets personnalisés**. Ajouter des objets et champs personnalisés n'entraînera pas de mise à jour de votre plan.
* **Personnes, Entreprises et Opportunités sont les trois objets à partir desquels vous pouvez accéder aux e-mails et aux réunions synchronisés depuis votre boîte aux lettres et votre calendrier**. Nous recommandons d'utiliser ces éléments autant que possible, en ajoutant des champs pour catégoriser vos enregistrements si besoin. Voici un exemple :
* Il est préférable d'utiliser l'objet People pour vos prospects et partenaires, en créant un champ sur l'objet People nommé `Person Type`, au lieu de créer un objet personnalisé partenaire, parce que vous ne pourriez pas accéder aux e-mails échangés avec cette personne à partir des enregistrements du partenaire.
* Créez différentes vues sous Personnes, une pour afficher les partenaires et une pour afficher les prospects.
* Deux personnes ne peuvent pas avoir la même adresse email. Deux entreprises ne peuvent pas avoir le même domaine.
* Vous pouvez désactiver les champs et objets standards que vous ne souhaitez pas utiliser.
* Vous pouvez masquer les champs des vues : n'ayez pas peur de créer des champs, vous n'aurez pas à tous les afficher.
Lisez [cet article](/l/fr/user-guide/data-model/overview) pour apprendre à concevoir votre modèle de données.
## 2. Importez vos données
Importer vos données existantes dans Twenty donne à votre équipe le contexte dès le départ.
### Connectez votre boite aux lettres
Si vous ne l'avez pas fait lors de la création de votre espace de travail, connectez votre **compte Google ou Microsoft** sous Paramètres → Comptes. Cela permet à Twenty de :
* Importer vos messages et réunions
* Créer automatiquement des contacts basés sur les interactions (optionnel)
* Garder l'historique de communication visible pour votre équipe
**Utilisez un autre fournisseur ?**
Vous pouvez ajouter une autre boite aux lettres via SMTP ou un autre calendrier via CalDAV. Allez dans **Paramètres → Comptes** pour configurer.
### Importer des données via CSV
Utilisez le menu Commande (`Cmd + K` ou `Ctrl + K`) pour importer des Personnes, Entreprises, Opportunités ou tout autre objet personnalisé via CSV.
**Lignes directrices principales** :
* Téléchargez le fichier exemple pour comprendre le format attendu
* Limitez chaque fichier à 10k enregistrements
* Supprimez les emails en double pour les Personnes ou les domaines en double pour les Entreprises
* Examinez et corrigez les erreurs (surlignées en jaune) avant de les importer
Lisez [cet article](/l/fr/user-guide/data-migration/overview) pour en savoir plus sur l'importation de données.
## 3. Créez votre première vue
La création de différentes vues est essentielle pour rendre les données utilisables pour votre équipe.
Voici comment procéder :
* **Ajouter ou masquer les colonnes**
Gérer les champs visibles dans une vue donnée en cliquant sur Options → Champs (en haut à droite). Vous pouvez afficher/masquer des champs à partir de là.
* **Réorganiser les champs**
Réorganiser les champs d'une vue donnée en cliquant sur Options → Champs (en haut à droite). Glisser-déposer les champs pour les réorganiser.
* **Filtrer votre vue**
Réduisez le nombre d'enregistrements affichés en utilisant les Filtres en haut à droite.
* **Trier les enregistrements**
Réorganisez les enregistrements affichés en utilisant la fonction de tri en haut à droite, ou en cliquant directement sur le nom de la colonne.
* **Choisissez la disposition**
Vous pouvez passer à une disposition **Kanban** ou à une liste **Grouper Par**, tant que l'objet a un champ de type 'Étape' ou similaire.
* **Enregistrez votre vue comme Favoris**
Cela peut être fait en utilisant le menu déroulant affichant les différentes vues.
## Et après ?
Commencez à créer des automatisations en utilisant [les flux de travail](/l/fr/user-guide/workflows/overview).

View File

@@ -0,0 +1,48 @@
---
title: Créer un espace de travail
description: Suivez un guide étape par étape expliquant comment s'inscrire sur Twenty, choisir un plan d'abonnement et configurer votre compte.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Étape 1 : Inscription
1. Allez sur [Inscription à Twenty](https://app.twenty.com).
2. Sélectionnez votre méthode d'inscription préférée :
* **Continuer avec Google** pour s'inscrire avec un compte Google.
* **Continuer avec Microsoft** pour s'inscrire avec un compte Microsoft.
* Ou, **Continuer avec l'e-mail** pour vous inscrire par e-mail.
<VimeoEmbed videoId="927066829" title="Démonstration vidéo" />
## Étape 2 : Choisir une période d'essai
Choisissez entre deux périodes d'essai :
### 30 jours
Avec carte de crédit
### 7 jours
Sans carte de crédit
Les deux essais incluent :
* Accès complet
* Contacts illimités
* Intégration du courriel
* Objets personnalisés
* API & Webhooks
Vous pouvez cliquer sur "Changer de plan" pour choisir un autre plan ou intervalle de facturation.
<img src="/images/user-guide/create-workspace/choose-plan.png" style={{width:'100%'}} />
## Étape 3 : Confirmation du paiement & configuration du compte
Après l'approbation du paiement via Stripe, vous êtes dirigé vers la création de votre espace de travail et de votre profil d'utilisateur. Souvenez-vous que vous pouvez annuler votre abonnement à tout moment.
## Support
Pour toute question ou aide, contactez l'équipe de support dédiée à [contact@twenty.com](mailto:contact@twenty.com) ou envoyez un message sur [Discord](https://discord.gg/cx5n4Jzs57).

View File

@@ -0,0 +1,84 @@
---
title: Naviguer dans Twenty.
description: Obtenez un aperçu rapide de la navigation dans la plateforme et des différents endroits où effectuer divers types d’actions.
---
## La mise en page principale
Le centre de l'écran est **où vivent vos enregistrements**: Personnages, Entreprises, Opportunités, Tâches, Notes, Tableaux de bord, Workflows et tout autre objet que vous avez créé. C'est là que se fait le travail quotidien.
Vous pouvez **voir, modifier ou supprimer des enregistrements** à partir de là, ainsi que **créer de nouvelles vues**.
<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
## La barre de navigation
À gauche, de haut en bas, vous pourrez :
* Basculez entre vos différents espaces de travail à l’aide du menu déroulant ou créez un nouvel espace de travail
* Utilisez la **barre de recherche** (appuyez sur `/` pour y accéder instantanément)
* Ouvrez la section **Paramètres**
* Ayez un accès direct à vos **vues favorites**. Les favoris sont uniques pour chaque utilisateur.
* Alternez entre différents objets
* **Créez des automatisations** à l’aide de flux de travail
<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
## Le menu de commandes
Le menu de commandes vous donne **un accès rapide aux actions** dans Twenty. Vous pouvez y accéder de deux manières :
* **Raccourci clavier** : Appuyez sur `Cmd + K` (Mac) ou `Ctrl + K` (Windows)
* **Souris** : Cliquez sur les trois points dans le coin supérieur droit
À partir de là, vous pouvez :
* Créer de nouveaux enregistrements
* **Importer et exporter des données au format CSV**
* Créer de nouvelles vues
* Accéder aux enregistrements supprimés (Twenty prend en charge les suppressions logiques et définitives)
* Voir les raccourcis clavier pour accéder rapidement aux objets dans votre espace de travail
<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
## La barre de recherche
La barre de recherche est accessible via le menu de commandes, en haut de votre barre de navigation, ou en appuyant sur `/` pour y placer immédiatement le curseur. La recherche fonctionne sur tous les objets.
<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
## Le panneau latéral
Lorsque vous cliquez sur un enregistrement, le panneau latéral apparaît à droite. Cela vous donne un aperçu rapide des informations clés de l'enregistrement, sans vous amener sur une autre page. À partir de là, vous pouvez décider de fermer cet aperçu ou d'obtenir des informations supplémentaires sur ce dossier, en cliquant sur le bouton Ouvrir.
<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
## Vues
Chaque objet (comme Opportunités ou Personnes) prend en charge plusieurs vues. Vous n'êtes pas limité par le nombre de vues par objet.
Utilisez le menu déroulant en haut à gauche de la mise en page principale pour basculer entre les différentes vues. Par exemple :
* Utilisez une vue Kanban pour suivre les opportunités par étape
* Utilisez la vue Group By pour créer des sections et améliorer l'efficacité
* Utilisez des filtres pour vous concentrer sur des enregistrements spécifiques (par exemple, prospects créés la semaine dernière)
* Enregistrez des vues filtrées pour les réutiliser plus tard
* Vues favorites pour un accès rapide
<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
Si vous découvrez les Vues, lisez notre [guide Vues et Pipelines](/l/fr/user-guide/views-pipelines/overview) pour apprendre à les créer et à les personnaliser.
## Paramètres
Ouvrez vos Paramètres depuis le haut à gauche pour :
* **Connectez vos comptes de messagerie et de calendrier** pour une synchronisation fluide des e-mails et du calendrier
* Personnalisez votre **modèle de données** : créez des objets, champs et relations personnalisés
* **Accédez au bac à sable de l’API et configurez des webhooks**
* **Gérez les autorisations des utilisateurs** et les contrôles d’accès à l’espace de travail
* Invitez des membres de l'équipe et gérez les rôles des utilisateurs
* Modifiez votre profil et les préférences de l'espace de travail
* Configurez la facturation et surveillez l'utilisation des crédits de flux de travail
* Découvrez et activez les fonctionnalités à venir (dans Mises à jour → Accès anticipé)
* **Accéder à l'assistance** pour obtenir de l'aide via le chat en direct
* **Ouvrir la documentation** pour parcourir le Guide de l'utilisateur et la documentation développeur
<Note>Si vous ne voyez pas toutes ces sections sous Paramètres, contactez l'administrateur de votre espace de travail — certaines sections ont un accès restreint.</Note>

View File

@@ -0,0 +1,59 @@
---
title: Guide de l'utilisateur
description: Bienvenue dans le guide utilisateur de Twenty, vos ressources pour les configurations avancées et les meilleures pratiques.
---
import { CardTitle } from "/snippets/card-title.mdx"
<CardGroup cols={3}>
<Card href="/l/fr/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
<CardTitle>Modèle de données</CardTitle>
Personnalisez votre modèle de données pour l'adapter à vos processus métier.
</Card>
<Card href="/l/fr/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
<CardTitle>Migration des données</CardTitle>
Importez et exportez vos données via CSV ou API.
</Card>
<Card href="/l/fr/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
<CardTitle>Calendrier et e-mails</CardTitle>
Centralisez les réunions et les e-mails de votre équipe.
</Card>
<Card href="/l/fr/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
<CardTitle>Flux de travail</CardTitle>
Automatisez les processus et intégrez des outils externes.
</Card>
<Card href="/l/fr/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
<CardTitle>IA</CardTitle>
Renforcez votre équipe avec des agents IA.
</Card>
<Card href="/l/fr/user-guide/layout/overview" img="/images/user-guide/halftone/layout.png">
<CardTitle>Layout</CardTitle>
Navigation, vues et personnalisation de la page d'enregistrement.
</Card>
<Card href="/l/fr/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
<CardTitle>Tableaux de bord</CardTitle>
Analyses en temps réel pour suivre les performances.
</Card>
<Card href="/l/fr/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
<CardTitle>Autorisations et accès</CardTitle>
Gérez les rôles et l'accès à Twenty.
</Card>
<Card href="/l/fr/user-guide/billing/overview" img="/images/user-guide/halftone/billing.png">
<CardTitle>Facturation</CardTitle>
Comprenez le fonctionnement de la tarification et de la facturation de Twenty.
</Card>
<Card href="/l/fr/user-guide/settings/overview" img="/images/user-guide/halftone/settings.png">
<CardTitle>Paramètres</CardTitle>
Configurez les préférences de votre espace de travail.
</Card>
</CardGroup>

View File

@@ -0,0 +1,38 @@
---
title: Navigation
description: Personnalisez la barre latérale gauche pour l'adapter à la façon dont votre équipe travaille.
---
La barre latérale gauche est votre moyen principal de naviguer dans Twenty. Elle est entièrement personnalisable — vous pouvez la réorganiser pour l'adapter à votre flux de travail sans toucher à aucune page de paramètres.
## Réorganisation des éléments
Glissez-déposez n'importe quel élément dans la barre latérale pour changer sa position. L'ordre est enregistré par utilisateur, ainsi chaque membre de l'équipe peut organiser sa propre barre latérale.
## Dossiers
Regroupez les éléments liés dans des dossiers. Par exemple, vous pouvez créer un dossier "Ventes" contenant vos vues du pipeline, un dossier "Support" pour les tickets, ou un dossier "Opérations" pour les objets internes.
Pour créer un dossier, cliquez avec le bouton droit dans la barre latérale ou utilisez le bouton `+`.
## Masquage des objets
Les objets que vous n'utilisez pas peuvent être masqués de la barre latérale. Ils ne sont pas supprimés — ils sont simplement mis de côté. Vous pouvez les réafficher à tout moment à partir des Paramètres → Modèle de données.
## Favoris
Épinglez des vues, des enregistrements ou des recherches dans la section Favoris en haut de la barre latérale pour un accès en un clic. Les Favoris sont personnels — chaque utilisateur gère les siens.
## Liens personnalisés
Ajoutez des liens vers des outils externes directement dans la barre latérale. Utile pour créer des liens vers votre wiki, des tableaux de bord dans d'autres outils, ou toute URL que votre équipe utilise régulièrement.
## Menu de commandes
Appuyez sur `Cmd+K` (ou `Ctrl+K`) pour ouvrir le menu de commandes — une barre de recherche à accès rapide pour accéder à n'importe quel enregistrement, vue ou action sans naviguer dans la barre latérale.
## Personnalisation de la barre latérale
Pour personnaliser la barre latérale, survolez la section "Workspace" de la barre latérale et cliquez sur l'icône de clé.
<img src="/images/user-guide/layout/navigation-edit-icon.png" alt="Icône de modification de la navigation" />

View File

@@ -0,0 +1,61 @@
---
title: Pages d'enregistrement
description: Personnalisez la mise en page de chaque page de détails d'enregistrement avec des onglets et des widgets.
---
## Vue d'ensemble
Lorsque vous ouvrez un enregistrement dans Twenty, la page de détails se compose d'**onglets** et de **widgets**. Les deux sont entièrement personnalisables par type d'objet.
## Onglets
Chaque page d'enregistrement peut comporter plusieurs onglets — similaires aux onglets d'un navigateur. Utilisez-les pour organiser différents aspects d'un enregistrement. Par exemple, un enregistrement de type Société peut comporter des onglets pour Aperçu, Communication, Tâches et Fichiers.
Vous pouvez :
* Ajouter et supprimer des onglets
* Renommer des onglets
* Réorganiser les onglets en les faisant glisser
* Définir l'onglet affiché par défaut
## Widgets
Les widgets sont les éléments constitutifs de chaque onglet. Types de widgets disponibles :
| Widget | Ce qu'il affiche |
| ---------------------------- | ------------------------------------------------------- |
| **Champs** | Champs de l'enregistrement, groupés ou individuellement |
| **Enregistrements associés** | Tableau d'enregistrements liés via une relation |
| **Emails** | Historique des e-mails des comptes connectés |
| **Calendrier** | Événements de calendrier associés à l'enregistrement |
| **Chronologie** | Historique des activités et des événements |
| **Tâches** | Tâches associées |
| **Notes** | Notes en texte enrichi |
| **Fichiers** | Fichiers joints |
| **Graphiques** | Données visuelles provenant d'enregistrements associés |
| **iFrame** | Contenu externe intégré |
| **Texte enrichi** | Contenu statique ou descriptions |
## Personnaliser une page d'enregistrement
1. Ouvrez n'importe quel enregistrement
2. Appuyez sur `Cmd+K` et recherchez "Modifier la mise en page de la page d'enregistrement"
ou
1. Accédez à Paramètres → Modèle de données → objet de votre choix → Mise en page
2. Cliquez sur le bouton "Personnaliser la page d'enregistrement" pour cet objet
3. Vous êtes maintenant en mode de personnalisation :
* **Ajoutez des widgets** à partir du sélecteur de widgets
* **Faites glisser les widgets** pour les repositionner sur la grille
* **Redimensionnez les widgets** en faisant glisser leurs bords
* **Configurez les champs** affichés dans chaque widget
* **Gérez les onglets** — ajouter, supprimer, renommer, réorganiser
4. Enregistrez vos modifications — elles s'appliquent à tous les enregistrements de ce type d'objet
## Visibilité des champs
Dans le widget Champs, vous pouvez contrôler quels champs sont visibles et dans quel ordre. Cela vous permet de créer des mises en page ciblées — par exemple, n'afficher que les champs les plus importants dans l'onglet Aperçu et placer les champs détaillés dans un onglet séparé.

View File

@@ -0,0 +1,45 @@
---
title: Disposition
description: Personnalisez la façon dont vous naviguez, parcourez et affichez les enregistrements dans Twenty.
---
La mise en page de Twenty est personnalisable à trois niveaux : la manière dont vous naviguez dans l'application, la façon dont vous parcourez les listes d'enregistrements et ce que vous voyez lorsque vous ouvrez un enregistrement individuel.
## Navigation
La barre latérale gauche est entièrement personnalisable. Vous pouvez :
* **Réorganiser les éléments** par glisser-déposer
* **Créer des dossiers** pour regrouper des objets et des vues liés
* **Masquer les objets** que vous n'utilisez pas
* **Ajouter des liens personnalisés** vers des outils externes
* **Épingler des favoris** pour accéder rapidement aux vues, enregistrements ou recherches
[Référence de navigation →](/l/fr/user-guide/layout/capabilities/navigation)
## Vues
Les vues déterminent la façon dont les listes d'enregistrements sont affichées. Twenty prend en charge trois types de vues :
| Vue | Idéal pour |
| -------------- | ------------------------------------------------------------------------------------------ |
| **Table** | Travailler avec de nombreux enregistrements à la fois — lignes et colonnes de type tableur |
| **Kanban** | Suivi du pipeline — cartes à glisser-déposer organisées par étape |
| **Calendrier** | Planification basée sur le temps — enregistrements affichés selon un champ de date |
Chaque vue enregistre ses propres filtres, critères de tri, visibilité des champs et configuration de regroupement. Les vues peuvent être partagées avec l'espace de travail ou rester privées.
[Vues Table →](/l/fr/user-guide/views-pipelines/capabilities/table-views) · [Vues Kanban →](/l/fr/user-guide/views-pipelines/capabilities/kanban-views) · [Vue Calendrier →](/l/fr/user-guide/views-pipelines/capabilities/calendar-view)
## Pages d'enregistrement
Lorsque vous ouvrez un enregistrement, la page de détails est composée d'onglets et de widgets configurables. Vous pouvez :
* **Ajouter, supprimer et réorganiser des onglets** pour n'importe quel type d'enregistrement
* **Configurer les widgets** - champs, enregistrements liés, e-mails, timeline, calendrier, tâches, notes, fichiers, graphiques, iFrames, et plus encore
* **Faire glisser et redimensionner les widgets** sur une grille
* **Contrôler la visibilité des champs** pour chaque widget
Accédez au mode de personnalisation de la mise en page depuis le menu de commandes (`Cmd+K` → "Modifier la mise en page de la page d'enregistrement").
[Référence des pages d'enregistrement →](/l/fr/user-guide/layout/capabilities/record-pages)

View File

@@ -0,0 +1,125 @@
---
title: FAQ légale
description: Foire aux questions juridiques.
---
## Résidence de données et transferts internationaux
<AccordionGroup>
<Accordion title="Dans quel pays et région nos données d'espace de travail, nos pièces jointes, nos journaux et nos sauvegardes seraient-elles stockées ?">
Vingt Cloud fonctionne sur des serveurs AWS situés à Francfort, en Allemagne.
</Accordion>
<Accordion title="La région d'hébergement peut-elle être réglée contractuellement pour notre espace de travail ?">
La sélection des régions d'hébergement sera disponible à partir de 2027, initialement pour les nouveaux espaces de travail. Les utilisateurs pourront demander une modification de région pour un espace de travail existant à une date ultérieure. Vous pouvez également contacter [nos partenaires] (https://twenty.com/partners/list?categories=HOSTING) pour vous aider à configurer votre instance.
</Accordion>
<Accordion title="Quels sous-processeurs peuvent traiter ou accéder à nos données CRM, et dans quels pays sont-ils localisés ?">
Une liste de tous les sous-processeurs est disponible dans [notre Centre de Confiance] (https://trust.twenty.com/?tab=subprocessors).
</Accordion>
<Accordion title="Quelles garanties s’appliquent aux transferts internationaux de données?">
Les clauses contractuelles standard de l'UE, ainsi que l'addenda britannique et les amendements suisses. s'appliquent aux transferts internationaux de données en dehors de l'UE, y compris les transferts à tous les sous-processeurs.
</Accordion>
</AccordionGroup>
## Accord de traitement des données et rôles légaux
<AccordionGroup>
<Accordion title="Où peut-on trouver l'accord actuel sur le traitement des données?">
Vous pouvez générer votre DPA signé à https://{your-domain}/settings/legal/dpa (par exemple https://getting-started.twenty.com/settings/legal/dpa).
</Accordion>
<Accordion title="Vingt agissent-ils en tant que processeur de données pour le commerçant et les informations de contact stockées dans le CRM, alors que notre entreprise reste le contrôleur de données?">
Conformément à notre [Politique de confidentialité] (https://twenty.com/privacy-policy), 20 agissent en tant que processeur de données pour le commerçant et les coordonnées stockées dans le CRM, pendant que votre entreprise reste le contrôleur de données.
</Accordion>
<Accordion title="Le contenu CRM est-il jamais utilisé pour former des modèles IA de 20 ou de tierces parties ?">
Le contenu CRM peut être utilisé pour former des modèles AI en fonction des conditions d'utilisation des sous-processeurs. Vingt ne possède pas son propre modèle IA — tous les modèles AI disponibles sur Twenty Cloud sont fournis par nos sous-processeurs.
</Accordion>
<Accordion title="Si le traitement IA optionnel existe, peut-il être complètement désactivé pour notre espace de travail ?">
L'IA peut être complètement désactivée en désactivant tous les modèles IA dans Paramètres → AI → Modèles. De plus, aucune donnée n'est envoyée à l'IA à moins que vous n'interagissiez activement avec le chat IA ou un nœud IA dans un flux de travail.
</Accordion>
</AccordionGroup>
## Contrôles de sécurité et d'accès
<AccordionGroup>
<Accordion title="Le chiffrement est-il utilisé dans le transport et au repos, quelles sont vos pratiques de gestion des clés, et comment les données du locataire sont-elles isolées?">
Toutes les données sont cryptées en transit et au repos. Les données du locataire sont isolées à travers une configuration de schéma par locataire, et les clés de chiffrement sont périodiquement tournées.
</Accordion>
<Accordion title="Quels sont les 20 employés ou sous-traitants qui peuvent accéder aux espaces de travail des clients, à quelles fins, et comment l'accès est-il approuvé et enregistré?">
Les équipes d’ingénierie et de support de Twenty peuvent accéder aux espaces de travail des clients afin d’enquêter sur les problèmes et de les résoudre. Les propriétaires d’espace de travail contrôlent cet accès : l’accès du support peut être désactivé à tout moment dans Paramètres → Général → Sécurité, et il reste désactivé jusqu’à ce que vous le réactiviez.
</Accordion>
<Accordion title="Quel est votre processus de notification d'incident et votre délai de notification cible à la suite d'un incident de sécurité confirmé affectant nos données ?">
En cas de violation des données personnelles confirmée affectant vos données, Nous vous avertirons sans délai et en tout cas dans les 48 heures suivant votre prise de conscience. Notre notification comprendra dans la mesure connue à l'époque : la nature de l'infraction, les catégories et le volume approximatif des données et des personnes touchées, les conséquences probables, ainsi que les mesures de redressement et d'atténuation prises ou prévues. Nous fournirons les mises à jour au fur et à mesure que l'enquête progressera.
</Accordion>
</AccordionGroup>
## Rétention et suppression des données
<AccordionGroup>
<Accordion title="Quand un enregistrement CRM individuel est supprimé, quand est-il supprimé des systèmes actifs?">
Lorsqu'un enregistrement est supprimé, il est d'abord supprimé et peut toujours être restauré. Il est définitivement supprimé et supprimé des systèmes actifs une fois la période de rétention écoulée ou qu'un utilisateur le détruit manuellement.
</Accordion>
<Accordion title="Combien de temps les enregistrements supprimés par logiciel sont-ils conservés dans le système?">
Par défaut, les enregistrements supprimés par logiciel sont conservés pendant 14 jours, après quoi ils sont définitivement retirés du système. La période de conservation des enregistrements supprimés par logiciel peut être modifiée dans Réglages → Général → Sécurité.
</Accordion>
<Accordion title="Combien de temps ce dossier peut-il rester dans des sauvegardes ou des journaux techniques?">
Un enregistrement supprimé reste dans les sauvegardes pendant 30 jours, après quoi il est définitivement supprimé.
</Accordion>
<Accordion title="Lorsqu'un espace de travail est fermé ou qu'une suppression complète est demandée, quel calendrier exact s'applique aux données de production, aux pièces jointes, aux journaux et aux sauvegardes ?">
Lorsqu’un espace de travail est supprimé, ses données sont retirées des systèmes de production dans un délai d’environ 90 jours après la fin du service, et généralement bien plus tôt. Les copies de sauvegarde et d’archivage sont ensuite écrasées ou purgées dans un nouveau délai de 90 jours, après quoi toutes les données sont définitivement supprimées. Pendant ces deux périodes, les données sont isolées de toute utilisation opérationnelle. Sur demande, nous pouvons fournir une attestation écrite une fois la purge terminée. Voir la clause 4.9 de votre Contrat de traitement des données pour connaître l’intégralité des conditions.
</Accordion>
<Accordion title="Pendant toute période de rétention de sauvegarde, les données supprimées sont-elles isolées de l'accès et de l'utilisation opérationnels ?">
Oui, pendant toute période de rétention de sauvegarde, les données supprimées sont isolées de toute utilisation opérationnelle.
</Accordion>
<Accordion title="Les catégories de données sont-elles conservées plus longtemps à des fins légales, de facturation, de prévention de la fraude, de sécurité ou d'audit ? Dans l'affirmative, quelles catégories et combien de temps?">
Pour plus d'informations sur la conservation des données, vous pouvez demander notre politique de gestion et de conservation des données disponible dans [notre Centre de confiance] (https://trust.twenty.com/?tab=documents).
</Accordion>
<Accordion title="Vingt peut-elle fournir une confirmation écrite quand une demande de suppression complète est terminée?">
Nous reconnaissons les demandes d'effacement et fournissons une confirmation écrite une fois la suppression terminée.
</Accordion>
</AccordionGroup>
## Sauvegardes et résilience
<AccordionGroup>
<Accordion title="Quelle est la fréquence de sauvegarde et la période de rétention ?">
Les sauvegardes sont créées en continu avec des instantanés pris quotidiennement, et la période de conservation est de 30 jours.
</Accordion>
<Accordion title="Quel est l'objectif de point de récupération et l'objectif de récupération pour Vingt nuages ?">
Le RTO et le RPO sont tous deux de 6 heures (selon notre DPA).
</Accordion>
<Accordion title="Quel est le processus de demande ou d’exécution d’une restauration?">
Pour demander une restauration, veuillez contacter notre équipe par chat de support ou par mail à [contact@twenty.com](mailto:contact@twenty.com).
</Accordion>
<Accordion title="Les sauvegardes sont-elles chiffrées et stockées dans la même région que les données de l'espace de travail principal ?">
Toutes les sauvegardes sont cryptées et stockées dans des endroits géographiquement séparés dans la même juridiction (par exemple au sein de l'UE pour les données de l'UE).
</Accordion>
</AccordionGroup>
## Conformité
<AccordionGroup>
<Accordion title="Vingt RGPD sont-ils conformes ?">
Oui, Vingt est [conforme au RGPD](https://trust.twenty.com/?tab=securityControls\&frameworks=gdpr_v1).
</Accordion>
<Accordion title="Vingt SOC 2 sont-ils conformes ?">
Oui, Vingt est [conforme à SOC 2] (https://trust.twenty.com/?tab=securityControls&frameworks=soc2_v1).
</Accordion>
<Accordion title="Vingt HIPAA est-elle conforme à la norme ?">
Non, vingt sont en train de devenir conformes à la norme HIPAA.
</Accordion>
</AccordionGroup>
## Licences
<AccordionGroup>
<Accordion title="Si je modifie le code pour ajouter des fonctionnalités uniquement destinées à l’usage interne de mon équipe, dois-je publier ces modifications ?">
Non. Exécuter une version modifiée pour votre propre équipe ne constitue pas une distribution, donc aucune obligation de publication n’en découle. La clause réseau de l’AGPL s’applique lorsque des personnes extérieures à votre organisation interagissent avec votre instance modifiée via le réseau.
</Accordion>
<Accordion title="Si je crée une interface distincte et que j’utilise Twenty comme backend tel quel, dois-je publier ces modifications ?">
Non. Votre interface est votre propre œuvre distincte, et le fait de communiquer avec Twenty via ses API ne change rien à cela. Étant donné que Twenty lui-même n’est pas modifié, il n’y a rien à publier.
</Accordion>
<Accordion title="Si je modifie le code pour ajouter des fonctionnalités afin de le revendre, dois-je publier ces modifications ?">
Oui, puisque vous modifiez du code pour le distribuer à d’autres, vous êtes tenu de publier ces modifications. Si vous ne souhaitez pas publier vos modifications, vous pouvez obtenir une licence Organization.
</Accordion>
</AccordionGroup>
Si vous avez plus de questions, veuillez consulter notre [Conditions générales] (https://twenty.com/terms), [Politique de confidentialité] (https://twenty.com/privacy-policy) et [Centre de confiance] (https://trust.twenty.com/). Si vos questions sont toujours sans réponse, envoyez-les à [contact@twenty.com] (mailto:contact@twenty.com) ou par chat d'assistance.

View File

@@ -0,0 +1,12 @@
---
title: Juridique
description: Éléments liés au juridique
---
Consultez notre [FAQ](/l/fr/user-guide/legal/how-tos/legal-faq).
## Liens utiles
* [Conditions générales](https://twenty.com/terms)
* [Politique de confidentialité](https://twenty.com/privacy-policy)
* [Centre de confiance](https://trust.twenty.com/)

View File

@@ -0,0 +1,213 @@
---
title: Permissions
description: Contrôlez l'accès aux objets, aux champs et aux paramètres avec des autorisations basées sur les rôles.
---
Le système d'autorisations de Twenty vous permet de contrôler l'accès à trois domaines principaux :
* **Objets et champs** : Contrôlez qui peut afficher, modifier ou supprimer des enregistrements et des champs individuels
* **Paramètres** : Gérez l'accès à la configuration de l'espace de travail et aux fonctions administratives
* **Actions** : Contrôlez les actions générales de l'espace de travail comme l'importation de données ou l'envoi d'e-mails
## Créer un Rôle
Pour créer un nouveau rôle :
1. Allez dans **Paramètres → Membres → Rôles**
2. Sous **Tous les rôles**, cliquez sur **+ Créer un rôle**
3. Entrez un nom de rôle
4. Dans l'onglet **Autorisations** par défaut, [configurez les autorisations](#customize-permissions)
5. Cliquez sur **Enregistrer** pour terminer
## Supprimer un Rôle
Pour supprimer un rôle :
1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle que vous souhaitez supprimer
3. Ouvrez l'onglet **Paramètres**, puis cliquez sur **Supprimer le rôle**
4. Cliquez sur **Confirmer** dans la fenêtre modale
<Note>
Si un rôle est supprimé, tout membre de l'espace de travail qui lui est attribué sera automatiquement réattribué au rôle par défaut. Tous les rôles sauf le rôle **Admin** peuvent être supprimés. Il doit toujours y avoir au moins un membre assigné au rôle **Admin**.
</Note>
## Attribuer des Rôles aux Membres
### Voir les Attributions Actuelles
* Allez dans **Paramètres → Membres → Rôles**
* Voir tous les rôles et combien de membres sont assignés à chacun
* Voir quels membres ont quels rôles
### Attribuer un Rôle à un Membre
1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle que vous souhaitez attribuer
3. Ouvrez l'onglet **Attribution**
4. Cliquez sur **+ Attribuer à un membre**
5. Sélectionnez le membre de l'espace de travail dans la liste
6. Confirmez l'attribution
### Définir le Rôle par Défaut
1. Allez dans **Paramètres → Membres → Rôles**
2. Dans la section **Options**, trouvez **Rôle par Défaut**
3. Sélectionnez le rôle que les nouveaux membres devraient automatiquement recevoir
4. Les nouveaux membres de l'espace de travail seront assignés à ce rôle lorsqu'ils rejoindront
<Note>
Vous ne pouvez attribuer des rôles qu'aux membres existants de l'espace de travail. Pour inviter de nouveaux membres, utilisez [Gestion des Membres](/l/fr/user-guide/settings/capabilities/member-management).
</Note>
## Personnaliser les Autorisations
Les permissions déterminent ce que chaque rôle peut accéder ou modifier dans votre espace de travail, y compris les objets, les enregistrements, les paramètres et les actions.
### Autorisations des objets
La section **Objets** contrôle ce que ce rôle peut faire avec les enregistrements dans l'ensemble de votre espace de travail.
#### Définir les autorisations par défaut (tous les objets)
Commencez par configurer les autorisations de base qui s'appliquent par défaut à **tous les objets** :
| Autorisation | Description |
| ----------------------------------------------------- | ------------------------------------------------------------------- |
| **Voir les enregistrements sur tous les objets** | Afficher les enregistrements dans les listes et les pages de détail |
| **Modifier les enregistrements sur tous les objets** | Modifier les enregistrements existants |
| **Supprimer les enregistrements sur tous les objets** | Supprimer logiquement les enregistrements (peuvent être restaurés) |
| **Détruire les enregistrements sur tous les objets** | Supprimer définitivement les enregistrements |
Sélectionnez ou désélectionnez selon le comportement par défaut souhaité pour ce rôle.
<Note>
**Exemple — rôle de stagiaire** : Un stagiaire doit pouvoir voir tous les objets mais ne pas les modifier par défaut. Activez "Voir les enregistrements sur tous les objets" mais laissez "Modifier les enregistrements sur tous les objets" décoché.
</Note>
#### Ajouter des exceptions au niveau de l'objet
Après avoir défini les valeurs par défaut, utilisez la sous-section **Niveau objet** pour ajouter des règles qui remplacent les valeurs par défaut pour des objets spécifiques.
Cliquez sur **+ Ajouter une règle** et sélectionnez un objet pour créer une exception.
**Exemples de règles pour un rôle de stagiaire :**
| Règle | Effet |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Opportunités → désactiver "Voir les enregistrements" | Le stagiaire ne peut pas du tout voir l'objet Opportunités |
| Personnes → activer "Modifier les enregistrements" | Le stagiaire peut modifier les enregistrements Personnes (mais pas les autres objets) |
### Autorisations au niveau des lignes
<Note>
Les autorisations au niveau des lignes sont une **fonctionnalité Premium** disponible avec l’offre **Organization** (Cloud et Self-Hosted).
</Note>
Les autorisations au niveau des lignes vous permettent de restreindre les enregistrements individuels qu’un rôle peut voir ou modifier, en fonction de critères dynamiques. Contrairement aux autorisations sur les objets (qui s’appliquent à un type d’objet entier), les autorisations au niveau des lignes évaluent chaque enregistrement indépendamment.
**Exemples de cas d’utilisation :**
* Les représentants commerciaux ne peuvent voir que leurs propres opportunités
* Les responsables peuvent voir tous les enregistrements de leur région
* Les agents du support ne peuvent consulter que les tickets qui leur sont attribués
Pour configurer les autorisations au niveau des lignes, ouvrez un rôle, allez à l’onglet **Objects**, puis utilisez la section **Row-Level** pour définir des conditions de filtrage pour un objet spécifique.
### Autorisations des champs
Dans chaque règle au niveau de l'objet, vous pouvez aller plus loin et configurer des **autorisations au niveau du champ** pour contrôler l'accès à des champs spécifiques.
| Autorisation | Description |
| --------------------- | -------------------------------- |
| **Voir le champ** | Afficher la valeur du champ |
| **Modifier le champ** | Modifier la valeur du champ |
| **Aucun accès** | Le champ est complètement masqué |
**Exemple — Restreindre les champs sensibles :**
Pour le rôle de stagiaire avec l'accès de modification sur Personnes, il peut être souhaitable de restreindre certains champs :
* Personnes → E-mail → **Voir le champ** uniquement (impossible de modifier)
* Personnes → Adresse → **Aucun accès** (complètement masquée)
Cela permet au stagiaire de modifier la plupart des champs de Personnes tout en protégeant les informations sensibles.
### Fonctionnement de l'héritage des autorisations
Les autorisations se propagent du général vers le spécifique :
1. **Tous les objets** → définit la base pour tous les objets
2. **Règles au niveau de l'objet** → remplacent la base pour des objets spécifiques
3. **Règles au niveau du champ** → remplacent le paramètre de l'objet pour des champs spécifiques
Les paramètres plus spécifiques prévalent toujours.
### Gestion des Exceptions d'Autorisations
Pour remplacer les autorisations héritées :
1. Cliquez sur **X** pour supprimer la règle héritée
2. Sélectionnez les autorisations spécifiques que vous souhaitez
3. Cliquez sur l'icône orange **Annuler** (flèche circulaire) pour revenir aux modifications
Lorsque terminé, cliquez sur **Terminer**, puis **Enregistrer** une fois redirigé vers la page de rôle.
### Autorisations des Paramètres de l'Espace de Travail
Contrôlez l'accès aux paramètres de l'espace de travail de deux manières :
* Activez **Accès Complet aux Paramètres** pour accorder un accès total
* Ou activez des autorisations spécifiques (par exemple, génération de clé API, préférences de l'espace de travail, attribution de rôles, configuration du modèle de données, paramètres de sécurité et gestion des workflows)
<Note>
**Limitation actuelle** : L'accès à la gestion des workflows est actuellement requis pour déclencher manuellement des workflows. Ce comportement pourrait changer dans de prochaines versions.
</Note>
### Autorisations des Actions de l'Espace de Travail
Contrôlez l'accès aux actions générales de l'espace de travail :
* Activez **Accès Complet à l'Application** pour accorder toutes les autorisations
* Ou activez des actions individuelles telles que **Envoyer un Email**, **Importer CSV** et **Exporter CSV**
## Assigner des rôles aux clés API et aux agents AI
Au-delà des membres de l'espace de travail, des rôles peuvent également être attribués aux **clés API** et aux **agents IA**. C'est particulièrement utile pour les équipes qui veulent contrôler précisément "qui" peut faire quoi dans leur espace de travail — y compris les processus automatisés et les intégrations.
### Pourquoi attribuer des rôles aux clés API et aux agents IA ?
* **Sécurité** : Limitez ce à quoi les processus automatisés peuvent accéder ou ce qu'ils peuvent modifier
* **Conformité** : Assurez-vous que les intégrations n'accèdent qu'aux données dont elles ont besoin
* **Contrôle** : Empêchez les modifications accidentelles de données dues à des automatisations mal configurées
* **Auditabilité** : Suivez quelles actions ont été effectuées par quelle intégration ou quel agent
### Attribuer un rôle à une clé API
1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle que vous souhaitez attribuer
3. Ouvrez l'onglet **Attribution**
4. Sous **Clés API**, cliquez sur **+ Attribuer à une clé API**
5. Sélectionnez la clé API dans la liste
6. Confirmez l'attribution
La clé API héritera désormais de toutes les autorisations définies par ce rôle. Toute requête API effectuée avec cette clé sera restreinte en conséquence.
<Note>
Les clés API sans rôle attribué utilisent les autorisations par défaut. Pour une sécurité renforcée, attribuez toujours un rôle spécifique aux clés API de production.
</Note>
### Attribuer un rôle à un agent IA
1. Allez dans **Paramètres → Membres → Rôles**
2. Cliquez sur le rôle que vous souhaitez attribuer
3. Ouvrez l'onglet **Attribution**
4. Sous **Agents IA**, cliquez sur **+ Attribuer à un agent IA**
5. Sélectionnez l'agent IA dans la liste
6. Confirmez l'attribution
L'agent IA ne pourra accéder aux données et effectuer des actions que celles autorisées par le rôle qui lui est attribué.
<Note>
Pour les agents IA exécutés au sein de workflows, cela garantit que l'agent ne peut ni accéder ni modifier des données en dehors de sa portée prévue — même si le workflow dispose d'autorisations plus larges.
</Note>

View File

@@ -0,0 +1,125 @@
---
title: Configuration du SSO
description: Configurez l'authentification unique (SSO) pour une authentification d'entreprise sécurisée.
---
## À propos du SSO
L'authentification unique (SSO) permet aux membres de votre équipe de se connecter à Twenty en utilisant le fournisseur d'identité de votre organisation. Cela offre :
* **Contrôle d'accès centralisé** : Gérez les accès depuis un seul endroit
* **Sécurité renforcée** : Exploitez vos politiques de sécurité existantes
* **Meilleure expérience utilisateur** : Un seul jeu d'identifiants pour tous les outils
## Fournisseurs pris en charge
Twenty prend en charge le SSO avec :
* **SAML 2.0** : Fonctionne avec la plupart des fournisseurs d'identité d'entreprise
* **Google Workspace** : Pour les organisations utilisant Google
* **Microsoft Entra ID** (anciennement Azure AD): Pour les environnements Microsoft
## Configuration du SSO
### Prérequis
* Offre Organization (espaces de travail cloud et auto-hébergés)
* Accès administrateur à votre fournisseur d'identité
* Accès administrateur à votre espace de travail de 20 ans
### Étapes de configuration
#### 1. Accédez aux paramètres du SSO
1. Allez dans **Paramètres → Sécurité**
2. Retrouvez la section Configuration du SSO
3. Cliquez sur **Configurer le SSO**
#### 2) Choisissez votre fournisseur
Sélectionnez votre fournisseur d'identité dans la liste ou choisissez "Custom SAML" pour d'autres fournisseurs.
#### 3. Configurez votre fournisseur d'identité
Vous devrez configurer votre fournisseur d'identité avec :
* **Entity ID** : Fourni par Twenty
* **URL ACS** : L'URL de rappel pour l'authentification
* **Certificat** : Pour une communication sécurisée
#### 4. Saisissez les informations du fournisseur dans Twenty
* **URL SSO** : L'URL de connexion fournie par votre fournisseur
* **Entity ID** : L'identifiant de votre fournisseur
* **Certificat** : Certificat X.509 de votre fournisseur
#### 5. Tester et activer
1. Cliquez sur **Tester la configuration** pour vérifier la configuration
2. Activez le SSO lorsque le test est réussi
3. Configurez les préférences d'approvisionnement des utilisateurs
## Approvisionnement des utilisateurs
### Approvisionnement Just-in-Time (JIT)
* Les utilisateurs sont créés automatiquement lors de la première connexion
* Les utilisateurs sont assignés automatiquement un rôle par défaut
* Aucune création manuelle d'utilisateurs nécessaire
### Approvisionnement manuel
* Invitez les utilisateurs avant qu'ils ne puissent se connecter
* Préattribuez des rôles spécifiques
* Plus de contrôle sur qui peut accéder à l'espace de travail
## Gestion des utilisateurs SSO
### Attribution des rôles
Les utilisateurs SSO peuvent se voir attribuer des rôles comme les utilisateurs classiques :
1. Allez dans **Paramètres → Membres**
2. Recherchez l'utilisateur
3. Modifiez leur rôle selon les besoins
### Révocation de l'accès
Pour supprimer l'accès des utilisateurs SSO :
* Retirez-les de votre fournisseur d'identité, ou
* Retirez-les de l'espace de travail Twenty
## Meilleures pratiques
### Sécurité
* **Exiger le SSO** : Désactivez la connexion par mot de passe pour les utilisateurs SSO
* **Audits réguliers** : Passez en revue les accès régulièrement
* **Politiques IdP strictes** : Imposez l'AMF au niveau du fournisseur d'identité
### Gestion des utilisateurs
* Utilisez un nommage cohérent avec votre annuaire
* **Correspondance de groupes** : Faites correspondre les groupes IdP aux rôles Twenty (si disponible)
* **Processus de départ** : Incluez Twenty dans votre workflow de déprovisionnement
## Résolution des problèmes
### Problèmes courants
* **Erreurs de certificats** : Assurez-vous que le certificat n'a pas expiré
* **Incompatibilité des URLs**: Vérifiez que l'URL ACS correspond exactement à
* **Utilisateur introuvable** : Vérifiez les paramètres d'approvisionnement JIT
### Obtenir de l'aide
Si vous rencontrez des problèmes, contactez le support avec :
* Messages d'erreur reçus
* Fournisseur d'identité utilisé
* Détails de configuration (sans données sensibles)
<Tip>
Vous avez besoin de configurer le SSO pour votre organisation ? [Trouvez un partenaire Twenty certifié](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-sso) spécialisé en SSO et en gestion des identités. *(Vous préférez impliquer directement Twenty ? [contact@twenty.com](mailto:contact@twenty.com))*
</Tip>

View File

@@ -0,0 +1,120 @@
---
title: FAQ sur les autorisations
description: Foire aux questions sur les rôles et les autorisations.
---
## Rôles
<AccordionGroup>
<Accordion title="Quels rôles sont inclus par défaut avec Twenty ?">
Vingt sont fournis avec les rôles **Admin** et **Membre** par défaut. Vous pouvez créer des rôles personnalisés supplémentaires selon les besoins de votre équipe (par ex., Représentant commercial, Responsable, Utilisateur en lecture seule).
</Accordion>
<Accordion title="Puis-je supprimer le rôle Admin ?">
Non, le rôle Admin ne peut pas être supprimé. Il doit toujours y avoir au moins un membre assigné au rôle Admin.
</Accordion>
<Accordion title="Que se passe-t-il lorsque je supprime un rôle ?">
Tout membre de l'espace de travail assigné à ce rôle sera automatiquement réattribué au rôle par défaut.
</Accordion>
<Accordion title="Comment définir un rôle par défaut pour les nouveaux membres ?">
Allez dans **Paramètres → Membres → Rôles**, trouvez l'option **Rôle par défaut**, puis sélectionnez le rôle que les nouveaux membres doivent recevoir automatiquement lorsqu'ils rejoignent.
</Accordion>
<Accordion title="Puis-je attribuer plusieurs rôles à un même utilisateur ?">
Non, chaque utilisateur ne peut avoir qu'un seul rôle à la fois. Créez un rôle personnalisé si vous avez besoin d'une combinaison d'autorisations.
</Accordion>
</AccordionGroup>
## Autorisations
<AccordionGroup>
<Accordion title="Quelle est la différence entre les autorisations d'objet et de champ ?">
* **Autorisations d'objet** : Contrôlent l'accès aux enregistrements entiers (par ex., voir/modifier/supprimer des enregistrements People)
* **Autorisations de champ** : Contrôlent l'accès à des champs spécifiques au sein d'un objet (par ex., voir mais ne pas modifier le champ Salaire)
Les autorisations de champ permettent un contrôle plus fin des données sensibles.
</Accordion>
<Accordion title="Comment fonctionnent les remplacements d'autorisations ?">
Les autorisations se propagent du général vers le spécifique :
1. **Tous les objets** définit la base pour tous les objets
2. **Autorisations au niveau de l'objet** peuvent remplacer le paramètre global pour des objets spécifiques
3. **Autorisations au niveau du champ** peuvent remplacer le paramètre de l'objet pour des champs spécifiques
Les paramètres plus spécifiques prévalent toujours.
</Accordion>
<Accordion title="Que signifient les différents niveaux d'autorisation ?">
Pour les objets :
* **Voir les enregistrements** : Afficher les enregistrements dans les listes et les pages de détail
* **Modifier les enregistrements** : Modifier les enregistrements existants
* **Supprimer les enregistrements** : Suppression logique des enregistrements (peuvent être restaurés)
* **Détruire les enregistrements** : Supprimer définitivement les enregistrements
Pour les champs :
* **Voir le champ** : Afficher la valeur du champ
* **Modifier le champ** : Modifier la valeur du champ
* **Aucun accès** : Le champ est complètement masqué
</Accordion>
<Accordion title="Puis-je restreindre l'accès à des enregistrements spécifiques (autorisations au niveau des lignes) ?">
Les autorisations au niveau des lignes sont disponibles sur l'offre **Organization**. Cela vous permet de restreindre l'accès à des enregistrements spécifiques selon des critères (par ex., voir uniquement vos propres opportunités).
</Accordion>
<Accordion title="Comment rendre un champ en lecture seule pour certains utilisateurs ?">
1. Allez dans **Paramètres → Membres → Rôles**
2. Sélectionnez le rôle
3. Accédez à l'objet contenant le champ
4. Définissez l'autorisation du champ sur **Voir le champ** (sans Modifier le champ)
</Accordion>
</AccordionGroup>
## Paramètres et actions
<AccordionGroup>
<Accordion title="Quelles autorisations liées aux paramètres sont disponibles ?">
Vous pouvez contrôler l'accès à :
* Génération de clés API
* Préférences de l'espace de travail
* Attribution des rôles
* Configuration du modèle de données
* Paramètres de sécurité
* Gestion des flux de travail
Utilisez **Accès total aux paramètres** pour accorder un accès complet, ou activez des autorisations spécifiques.
</Accordion>
<Accordion title="Quelles autorisations d'actions sont disponibles ?">
Vous pouvez contrôler :
* **Envoyer des e-mails** : Possibilité d'envoyer des e-mails depuis Twenty
* **Importer un CSV** : Possibilité d'importer des données via CSV
* **Exporter en CSV** : Possibilité d'exporter des données en CSV
Utilisez **Accès total à l'application** pour autoriser toutes les actions, ou activez des actions spécifiques.
</Accordion>
</AccordionGroup>
## SSO
<AccordionGroup>
<Accordion title="Le SSO est-il disponible sur toutes les offres ?">
Non, le SSO est une fonctionnalité Premium disponible uniquement sur l'offre **Organization**.
</Accordion>
<Accordion title="Quels fournisseurs d'identité sont pris en charge ?">
Twenty prend en charge :
* **SAML 2.0** (fonctionne avec la plupart des fournisseurs d'identité d'entreprise)
* **Google Workspace**
* **Microsoft Entra ID** (anciennement Azure AD)
</Accordion>
<Accordion title="Qu'est-ce que l'approvisionnement Just-in-Time (JIT) ?">
Avec l'approvisionnement JIT, les comptes utilisateur sont automatiquement créés dans Twenty lorsqu'une personne se connecte via SSO pour la première fois. Le rôle par défaut leur est attribué automatiquement.
</Accordion>
<Accordion title="Puis-je exiger le SSO pour tous les utilisateurs ?">
Oui, une fois le SSO configuré, vous pouvez désactiver la connexion par mot de passe pour les utilisateurs SSO afin d'imposer l'authentification via votre fournisseur d'identité.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,34 @@
---
title: Autorisations et accès
description: Gérez les rôles, les autorisations et le contrôle d’accès dans votre espace de travail.
---
Le système d’autorisations de Twenty vous permet de contrôler qui peut accéder aux données de votre espace de travail et les modifier. Créez des rôles, attribuez des autorisations et configurez l’authentification unique (SSO) pour un accès sécurisé.
## Contenu de cette section
<CardGroup cols={2}>
<Card title="Permissions" icon="lock" href="/l/fr/user-guide/permissions-access/capabilities/permissions">
Créez des rôles et configurez les autorisations sur les objets, les champs et les paramètres.
</Card>
<Card title="Configuration SSO" icon="key" href="/l/fr/user-guide/permissions-access/capabilities/sso-configuration">
Configurez l’authentification unique avec votre fournisseur d’identité.
</Card>
<Card title="FAQ" icon="circle-question" href="/l/fr/user-guide/permissions-access/how-tos/permissions-faq">
Questions fréquentes sur les rôles, les autorisations et l’authentification unique (SSO).
</Card>
</CardGroup>
## Fonctionnalités clés
* **Accès basé sur les rôles** : Créez des rôles personnalisés avec des autorisations spécifiques
* **Autorisations sur les objets** : Contrôlez qui peut afficher, modifier ou supprimer des enregistrements
* **Autorisations sur les champs** : Restreignez l’accès aux champs sensibles
* **Autorisations sur les paramètres** : Contrôlez l’accès à la configuration de l’espace de travail
* **Intégration SSO** : Configurez l’authentification unique pour la sécurité d’entreprise (plan Organization)
## Liens rapides
* [Créer un rôle](/l/fr/user-guide/permissions-access/capabilities/permissions#create-a-role)
* [Configurer le SSO](/l/fr/user-guide/permissions-access/capabilities/sso-configuration)
* [Gérer les membres de l’équipe](/l/fr/user-guide/settings/capabilities/member-management)

View File

@@ -0,0 +1,36 @@
---
title: Paramètres de la communauté
description: Activez les fonctionnalités en Accès anticipé dans Twenty.
---
## À propos des paramètres de la communauté
La section Communauté vous permet d'activer des fonctionnalités en Accès anticipé avant qu'elles ne soient généralement disponibles, ainsi que de rechercher des partenaires Twenty.
## Fonctionnalités en Accès anticipé
Les fonctionnalités en Accès anticipé sont des fonctionnalités testées avant leur disponibilité générale.
**Actuellement en Accès anticipé :**
* **Relations de jonction** — Relations de plusieurs à plusieurs
### Comment activer les fonctionnalités en Accès anticipé
1. Allez dans **Paramètres → Communauté**
2. Accédez à la section **Fonctionnalités**
3. Repérez la fonctionnalité que vous souhaitez activer
4. Activez-la
5. La fonctionnalité sera disponible immédiatement
<Note>
Les fonctionnalités en Accès anticipé peuvent évoluer en fonction des retours des utilisateurs. Vos commentaires nous aident à améliorer Twenty !
</Note>
## Commentaires sur les fonctionnalités
Vos commentaires aident à améliorer Twenty :
* Signalez les problèmes liés aux fonctionnalités en Accès anticipé
* Partagez comment vous utilisez les nouvelles fonctionnalités
* Suggérez des améliorations via le [Discord de la communauté](https://discord.gg/cx5n4Jzs57)

View File

@@ -0,0 +1,52 @@
---
title: Paramètres des domaines
description: Configurez le domaine de l'espace de travail, les domaines d'accès approuvés et les domaines personnalisés des applications.
---
Les paramètres de domaine se trouvent à trois endroits, en fonction de ce que vous configurez.
## Domaine de l'espace de travail
Configurer sous **Paramètres → Général**.
Modifiez le nom de votre sous-domaine ou définissez un domaine personnalisé pour votre espace de travail.
### Personnaliser le domaine
1. Cliquez sur **Sous-domaine** pour modifier votre sous-domaine (par exemple, `yourcompany.twenty.com`)
2. Ou cliquez sur **Domaine personnalisé** pour configurer un domaine personnalisé (par exemple, `crm.yourcompany.com`)
Pour les domaines personnalisés, vous devrez configurer les paramètres DNS auprès de votre fournisseur de domaine.
## Domaines approuvés
Configurez dans **Paramètres → Membres → Invitation**.
Ajoutez le domaine de votre entreprise pour permettre aux membres de l'équipe de s'inscrire automatiquement à cet espace de travail.
### Ajouter un domaine d'accès approuvé
1. Cliquez sur **Ajouter un domaine d'accès approuvé**
2. Saisissez le domaine de votre entreprise (par exemple, `yourcompany.com`)
3. Enregistrer
Une fois configuré, toute personne ayant une adresse e-mail de ce domaine peut rejoindre votre espace de travail sans avoir besoin d'une invitation directe.
<Note>
Cela est utile pour permettre à toute votre équipe de s'auto-inscrire tout en gardant l'espace de travail restreint à votre organisation.
</Note>
## Domaines personnalisés des applications
Configurez dans **Paramètres → Applications → votre application → Paramètres → URL de l'application**.
Les applications qui exposent des routes sur le Web sont accessibles via une URL dédiée, indiquée dans la section **URL de l'application**. Vous pouvez plutôt héberger une application sur un domaine que vous possédez.
### Ajouter un domaine personnalisé
1. Cliquez sur **Domaine personnalisé**
2. Saisissez le domaine que vous souhaitez utiliser (par exemple, `app.yourcompany.com`)
3. Configurez les paramètres DNS comme indiqué
4. Vérifiez le domaine
Seules les routes de cette application sont accessibles sur le domaine. Les certificats SSL sont fournis automatiquement.

View File

@@ -0,0 +1,38 @@
---
title: Expérience - Paramètres
description: Personnalisez votre thème d'interface et vos préférences régionales.
---
Personnalisez votre expérience Twenty dans **Paramètres → Expérience**.
## Apparence
Choisissez votre thème visuel :
* **Clair** : Interface épurée et lumineuse
* **Sombre** : Plus reposant pour les yeux dans des conditions de faible luminosité
* **Paramètres système** : S'adapte automatiquement au thème de votre appareil
## Langue
Sélectionnez votre langue préférée pour l'interface Twenty dans le menu déroulant.
## Formats
Configurer la date, l'heure, le nombre, le fuseau horaire et le jour de début du calendrier.
| Paramètre | Description |
| ------------------------------- | --------------------------------------------------------------------------- |
| **Fuseau horaire** | Votre fuseau horaire local pour des horodatages et une planification précis |
| **Format de date** | Format d'affichage des dates (p. ex. : 12 déc. 2025) |
| **Format de l'heure** | Format 12 heures (7:22 PM) ou 24 heures |
| **Format de nombre** | Séparateurs pour les décimales et les milliers (p. ex. : 1 234,56) |
| **Jour de début du calendrier** | Premier jour de la semaine (dimanche ou lundi) |
Chaque paramètre peut être défini sur **Paramètres système** pour s'adapter automatiquement aux préférences de votre appareil, ou vous pouvez choisir un format spécifique.
## Comment mettre à jour
1. Allez dans **Paramètres → Expérience**
2. Ajustez vos préférences dans chaque section
3. Les modifications sont enregistrées automatiquement

View File

@@ -0,0 +1,86 @@
---
title: Gestion des membres
description: Invitez des membres de l'équipe et gérez l'accès à l'espace de travail.
---
Gérez qui a accès à votre espace de travail dans **Paramètres → Membres**.
## Inviter de nouveaux membres
### Utilisation de l'invitation par e-mail
1. Allez dans **Paramètres → Membres → Invitations**
2. Cliquez sur **+ Inviter**
3. Entrez l'adresse e-mail de la personne
4. Sélectionnez un rôle pour le nouveau membre
5. Cliquez sur **Envoyer l'invitation**
La personne invitée recevra un e-mail contenant un lien pour rejoindre votre espace de travail.
### Utilisation du lien d'invitation
1. Allez dans **Paramètres → Membres → Invitations**
2. Copiez le lien d'invitation de l'espace de travail
3. Partagez le lien avec les nouveaux membres de l'équipe
4. Ils auront accès dès leur inscription
## Afficher et gérer les membres
### Afficher tous les membres
Allez dans **Paramètres → Membres → Équipe** pour voir tous les membres actifs
Allez dans **Paramètres → Membres → Invitation** pour voir les invitations en attente
### Modifier le profil d'un membre
Cliquez sur un membre pour ouvrir sa page de profil. En tant qu'administrateur, vous pouvez :
* Modifier son **nom**
* Mettre à jour sa **photo de profil**
* **Se connecter à sa place** (utile pour le dépannage)
* **Supprimer** son compte
### Modifier le rôle d'un membre
Sur la page de profil du membre :
1. Ouvrez l'onglet **Autorisations**
2. Affichez le rôle actuellement attribué
3. Sélectionnez un rôle différent dans le menu déroulant
4. La modification prend effet immédiatement
→ [En savoir plus sur les rôles et les autorisations](/l/fr/user-guide/permissions-access/capabilities/permissions)
### Retirer un membre
1. Cliquez sur le membre pour ouvrir son profil
2. Cliquez sur **Supprimer le compte** pour les supprimer de l'espace de travail
<Warning>
Les membres retirés perdent immédiatement l'accès. Leurs données (enregistrements, notes, tâches) restent dans l'espace de travail.
</Warning>
<Note>
Les courriels et les événements du calendrier du membre supprimé sont archivés et disponibles pour les autres membres.
</Note>
## Invitations en attente
Gérez les invitations qui n'ont pas été acceptées :
* **Renvoyer** : envoyer à nouveau l'e-mail d'invitation
* **Annuler** : révoquer l'invitation avant qu'elle ne soit acceptée
## Domaines d'accès approuvés
Autorisez les membres de l'équipe à rejoindre automatiquement l'espace de travail selon leur domaine e-mail :
1. Allez dans **Paramètres → Membres → Invitations**
2. Ajoutez le domaine de votre entreprise (par exemple, `yourcompany.com`)
3. Toute personne dont l'adresse e-mail appartient à ce domaine peut rejoindre sans invitation
## Articles connexes
* [Autorisations](/l/fr/user-guide/permissions-access/capabilities/permissions) — configurez ce que chaque rôle peut faire
* [Paramètres de domaine](/l/fr/user-guide/settings/capabilities/domains-settings) — configurer les domaines approuvés

View File

@@ -0,0 +1,43 @@
---
title: Paramètres du profil
description: Gérez votre profil personnel et vos paramètres de sécurité.
---
## Informations personnelles
### Nom et e-mail
* **Nom affiché**: Modifiez comment votre nom apparaît aux autres membres de l’espace de travail
* **Adresse e-mail**: Changez votre e-mail de connexion (nécessite vérification)
* **Photo de profil**: Téléchargez un avatar personnalisé ou utilisez vos initiales
## Paramètres de sécurité
### Authentification à deux facteurs (2FA)
Activez le 2FA pour ajouter une couche supplémentaire de sécurité à votre compte :
1. Allez dans **Paramètres → Profil**
2. Cliquez sur **Application d'authentification**
3. Scannez le code QR avec votre application d'authentification
4. Entrez le code de vérification pour confirmer
### Gestion des mots de passe
* **Modifier le mot de passe**: Mettez à jour votre mot de passe actuel
* **Exigences du mot de passe**: Doit contenir au moins 8 caractères
## Gestion du profil
### Supprimer le compte
<Warning>
La suppression de votre compte supprimera définitivement votre accès à tous les espaces de travail. Cette action ne peut pas être annulée. Vous perdrez l'accès à tous les espaces de travail où vous êtes membre. Si vous ne voulez quitter que des équipes spécifiques, envisagez plutôt de quitter des espaces de travail individuels.
</Warning>
Pour supprimer votre compte :
1. Allez dans **Paramètres → Profil**
2. Faites défiler jusqu'à **Zone de danger**
3. Cliquez sur **Supprimer le compte**
4. Confirmez en tapant votre adresse e-mail

View File

@@ -0,0 +1,30 @@
---
title: Paramètres de l'espace de travail
description: Personnalisez le nom et la marque de votre espace de travail.
---
L'image, le nom et les options de suppression de votre espace de travail sont toutes accessibles dans **Paramètres → Général**.
## Image de l'espace de travail
* **Télécharger le logo** : Ajoutez un logo personnalisé pour l'espace de travail
* **Formats pris en charge** : fichiers PNG, JPEG et GIF de moins de 10 Mo
* **Supprimer** : Supprimez le logo actuel de l'espace de travail
## Nom de l'espace de travail
* **Nom** : Changez le nom d'affichage de votre espace de travail
* Ce nom apparaît à tous les membres de l'espace de travail
## Zone de danger
<Warning>
La suppression de votre espace de travail supprime définitivement toutes les données et révoque immédiatement l'accès pour tous les membres. Cette action ne peut pas être annulée.
</Warning>
Pour supprimer votre espace de travail :
1. Cliquez sur le bouton **Supprimer l'espace de travail**
2. Confirmez la suppression lorsque vous y êtes invité
**Remarque** : seuls les administrateurs d'espace de travail peuvent supprimer des espaces de travail.

View File

@@ -0,0 +1,171 @@
---
title: FAQ sur les paramètres
description: Foire aux questions sur les paramètres de Twenty.
---
## Paramètres de l'espace de travail
<AccordionGroup>
<Accordion title="Comment changer le nom de mon espace de travail ?">
1. Allez dans **Paramètres → Général**
2. Repérez le champ Nom de l'espace de travail
3. Saisissez le nouveau nom
4. Les modifications sont enregistrées automatiquement
</Accordion>
<Accordion title="Comment mettre à jour le logo de mon espace de travail ?">
1. Allez dans **Paramètres → Général**
2. Cliquez sur le logo actuel ou la zone de téléversement
3. Sélectionnez un fichier image (PNG, JPEG ou GIF de moins de 10 Mo)
4. Le logo est mis à jour immédiatement
</Accordion>
<Accordion title="Puis-je avoir plusieurs espaces de travail ?">
Oui, vous pouvez créer et être membre de plusieurs espaces de travail. Chaque espace de travail possède ses propres données, paramètres et abonnement.
</Accordion>
<Accordion title="Comment supprimer mon espace de travail ?">
1. Allez dans **Paramètres → Général**
2. Faites défiler jusqu'à la section Zone de danger
3. Cliquez sur **Supprimer l'espace de travail**
4. Confirmez la suppression
Remarque : cela supprime définitivement toutes les données et ne peut pas être annulé.
</Accordion>
<Accordion title="J'ai créé par erreur plusieurs espaces de travail. Que dois-je faire ?">
Supprimez les espaces de travail dont vous n'avez plus besoin dans **Paramètres → Général → Supprimer l'espace de travail**.
<Warning>
Ne supprimez pas votre **compte** (accessible sous Paramètres → Profil) : votre compte est partagé entre tous vos espaces de travail. La suppression de votre compte supprime l'accès à TOUS les espaces de travail.
</Warning>
</Accordion>
<Accordion title="Comment désactiver mon espace de travail sans le supprimer ?">
Si vous souhaitez désactiver temporairement votre espace de travail (et non le supprimer définitivement), allez dans **Paramètres → Facturation** et cliquez sur **Annuler l'abonnement**. Vos données seront conservées pendant une période de grâce.
</Accordion>
</AccordionGroup>
## Paramètres du profil
<AccordionGroup>
<Accordion title="Comment changer mon mot de passe ?">
1. Allez dans **Paramètres → Profil**
2. Repérez la section Mot de passe
3. Saisissez votre mot de passe actuel
4. Saisissez votre nouveau mot de passe
5. Enregistrez les modifications
</Accordion>
<Accordion title="Comment activer l'authentification à deux facteurs ?">
1. Allez dans **Paramètres → Profil**
2. Repérez la section 2FA
3. Cliquez sur **Activer le 2FA**
4. Scannez le code QR avec votre application d'authentification
5. Saisissez le code de vérification
</Accordion>
<Accordion title="Puis-je changer mon adresse e-mail ?">
Pour changer votre adresse e-mail, veuillez contacter [contact@twenty.com](mailto:contact@twenty.com).
</Accordion>
<Accordion title="Comment supprimer mon compte ?">
1. Allez dans **Paramètres → Profil**
2. Faites défiler jusqu'à la section Zone de danger
3. Cliquez sur **Supprimer le compte**
4. Confirmez en saisissant votre adresse e-mail
Remarque : cela supprime votre accès à tous les espaces de travail et supprime tous les e-mails synchronisés depuis vos comptes connectés.
</Accordion>
</AccordionGroup>
## Expérience - Paramètres
<AccordionGroup>
<Accordion title="Comment basculer entre le mode clair et le mode sombre ?">
1. Allez dans **Paramètres → Expérience**
2. Repérez la section Thème
3. Sélectionnez Clair, Sombre ou Système
</Accordion>
<Accordion title="Comment changer le format de date ?">
1. Allez dans **Paramètres → Expérience**
2. Repérez le paramètre Format de date
3. Sélectionnez votre format préféré
4. Les modifications s'appliquent immédiatement
</Accordion>
<Accordion title="Comment changer mon fuseau horaire ?">
1. Allez dans **Paramètres → Expérience**
2. Repérez le paramètre Fuseau horaire
3. Sélectionnez votre fuseau horaire local
4. Tous les horodatages seront ajustés
</Accordion>
<Accordion title="Puis-je changer la langue ?">
1. Allez dans **Paramètres → Expérience**
2. Repérez le paramètre Langue
3. Sélectionnez parmi les langues disponibles
4. L'interface se met à jour selon votre sélection
</Accordion>
</AccordionGroup>
## Paramètres du compte
<AccordionGroup>
<Accordion title="Comment connecter mon compte e-mail ?">
1. Allez dans **Paramètres → Comptes**
2. Cliquez sur **Ajouter un compte**
3. Choisissez Google ou Microsoft
4. Autorisez l'accès
5. Configurez les paramètres de synchronisation
</Accordion>
<Accordion title="Puis-je connecter plusieurs comptes e-mail ?">
Oui, vous pouvez connecter plusieurs comptes e-mail. Allez dans **Paramètres → Comptes** et ajoutez des comptes supplémentaires selon vos besoins.
</Accordion>
<Accordion title="Comment déconnecter un compte e-mail ?">
1. Allez dans **Paramètres → Comptes**
2. Repérez le compte à supprimer
3. Cliquez sur **Déconnecter**
4. Confirmez l'action
</Accordion>
</AccordionGroup>
## Domaines
<AccordionGroup>
<Accordion title="Puis-je personnaliser le domaine de mon espace de travail ?">
Oui! Allez dans **Paramètres → Général → Domaine de l'espace de travail** et cliquez sur **Personnaliser le domaine**. Vous avez deux options :
* **Sous-domaine** : Utilisez un sous-domaine Twenty comme `yourcompany.twenty.com`
* **Domaine personnalisé** : Utilisez votre propre domaine comme `crm.yourcompany.com` (nécessite une configuration DNS)
Un sous-domaine est rapide à configurer, tandis qu'un domaine personnalisé offre à votre équipe une expérience entièrement adaptée à votre marque.
</Accordion>
<Accordion title="Comment fonctionnent les domaines d'accès approuvés ?">
Vous pouvez configurer des domaines d'accès approuvés afin que les membres de l'équipe disposant d'adresses e-mail professionnelles puissent rejoindre automatiquement votre espace de travail. Allez dans **Paramètres → Membres → Inviter** et ajoutez le domaine de votre entreprise (par exemple, `yourcompany.com`).
</Accordion>
</AccordionGroup>
## Fonctionnalités en Accès anticipé
<AccordionGroup>
<Accordion title="Quelles sont les fonctionnalités en Accès anticipé ?">
Les fonctionnalités en Accès anticipé sont des fonctionnalités testées avant leur disponibilité générale.
</Accordion>
<Accordion title="Les fonctionnalités en Accès anticipé sont-elles sûres à utiliser ?">
Les fonctionnalités d'accès anticipé sont fonctionnelles et sûres à utiliser, mais peuvent être modifiées en fonction des commentaires des utilisateurs avant la disponibilité générale.
</Accordion>
<Accordion title="Comment activer les fonctionnalités en Accès anticipé ?">
1. Allez dans **Paramètres → Communauté**
2. Faites défiler vers le bas jusqu'à la section **Fonctionnalités**
3. Repérez la fonctionnalité souhaitée
4. Activez-la
5. La fonctionnalité devient disponible immédiatement
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,62 @@
---
title: Paramètres
description: Configurez votre espace de travail Twenty avec des paramètres essentiels.
---
## Configuration initiale
Lorsque vous créez votre espace de travail pour la première fois, il y a plusieurs paramètres clés à configurer.
### Nom et logo de l'espace de travail
1. Allez dans **Paramètres → Général**
2. Mettez à jour le nom de votre espace de travail
3. Téléversez le logo de votre entreprise
4. Enregistrez les modifications
### Fuseau horaire et format de date
1. Allez dans **Paramètres → Expérience**
2. Sélectionnez votre fuseau horaire
3. Choisissez votre format de date préféré
4. Enregistrez les modifications
## Configurations essentielles
### Connectez vos e-mails et votre calendrier
Configurez la synchronisation des e-mails et du calendrier :
1. Allez dans **Paramètres → Comptes**
2. Cliquez sur **Ajouter un compte**
3. Connectez votre compte Google ou Microsoft
4. Configurez les paramètres de synchronisation
→ [Guide complet de configuration des e-mails et du calendrier](/l/fr/user-guide/calendar-emails/overview)
### Invitez votre équipe
Ajoutez des membres de votre équipe à votre espace de travail :
1. Allez dans **Paramètres → Membres**
2. Cliquez sur **+ Inviter**
3. Saisissez des adresses e-mail
4. Attribuez les rôles appropriés
<Note>
Avant d'inviter votre équipe, vérifiez le rôle par défaut dans **Paramètres → Membres → Rôles**. Les nouveaux membres se voient automatiquement attribuer ce rôle lorsqu'ils rejoignent l'espace de travail.
</Note>
## Liste de contrôle des paramètres de l'espace de travail
* Nom et logo de l'espace de travail configurés
* Fuseau horaire et format de date définis
* E-mails et calendrier connectés
* Membres de l’équipe invités
* Rôles et autorisations configurés
## Prochaines étapes
* [Paramètres de l’espace de travail](/l/fr/user-guide/settings/capabilities/workspace-settings)
* [Paramètres du profil](/l/fr/user-guide/settings/capabilities/profile-settings)
* [Paramètres de l’expérience](/l/fr/user-guide/settings/capabilities/experience-settings)

View File

@@ -0,0 +1,46 @@
---
title: Vue Calendrier
description: Afficher les enregistrements comportant des champs de date sur un calendrier.
---
## À propos de la Vue Calendrier
La vue Calendrier affiche vos enregistrements sur un calendrier en fonction d'un champ de date. Chaque enregistrement apparaît comme un événement à la date correspondante.
<img src="/images/user-guide/views/calendar-view-zoom.png" style={{width:'100%'}} />
## Création d'une Vue Calendrier
1. Accédez à un objet comportant des champs de date
2. Cliquez sur le menu déroulant de la vue → **+ Ajouter une vue**
3. Nommez votre vue et cliquez sur **Créer**
4. Ouvrez les **Options** à droite
5. Sélectionnez **Calendrier** comme mise en page
6. Choisissez le **champ de date** à utiliser pour positionner les enregistrements
7. Cliquez sur **Mettre à jour la vue**
## Configuration du Calendrier
### Choisir le champ de date
Sous **Options**, sélectionnez le champ de date qui détermine où les enregistrements apparaissent sur le calendrier.
### Afficher les champs
Configurez les champs à afficher sur chaque événement du calendrier :
1. Cliquez sur **Options → Champs**
2. Activer/désactiver les champs
3. Faites glisser pour réorganiser
## Cas d'utilisation
* **Réunions et appels** : Voir les rendez-vous à venir
* **Échéances** : Suivre les dates d'échéance et de clôture
* **Événements** : Planifier et visualiser les activités programmées
* **Relances** : Voir quand les tâches arrivent à échéance
## Connexes
* [Aperçu des vues](/l/fr/user-guide/views-pipelines/overview) — création et gestion des vues
* [Filtres et tri](/l/fr/user-guide/views-pipelines/capabilities/filters-and-sorting) — filtrage des données du calendrier

View File

@@ -0,0 +1,52 @@
---
title: Champs et colonnes
description: Choisissez quels champs afficher et comment les organiser.
---
## Sélection des champs à afficher
Chaque vue peut afficher un ensemble de champs différent. Personnalisez ce qui est visible pour vous concentrer sur les informations importantes.
### Afficher ou masquer des champs
1. Cliquez sur **Options** en haut à droite
2. Cliquez sur **Champs**
3. Cliquez sur l'**icône en forme d'œil** à côté de chaque champ pour l'afficher ou le masquer
### Réorganiser les champs
Modifiez l'ordre dans lequel les champs apparaissent dans votre vue :
1. Cliquez sur **Options → Champs**
2. Faites glisser les champs vers le haut ou vers le bas
3. Les modifications sont enregistrées automatiquement
## Affichage des champs par type de vue
### Vues de Tableau
* Les champs apparaissent sous forme de colonnes
* Redimensionnez les colonnes en faisant glisser les bordures
### Vues Kanban
* Les champs apparaissent sur les cartes
* Réorganisez via Options → Champs
* Utilisez la vue compacte pour masquer tous les champs
### Vues calendrier
* Les champs sélectionnés s'affichent sur les événements du calendrier
* Configurez via Options → Champs
## Meilleures pratiques
* **Afficher seulement ce qui est nécessaire** — trop de champs encombrent la vue
* **Placez les champs importants en premier** — les colonnes les plus utilisées à gauche
* **Créez plusieurs vues** — ensembles de champs différents pour différents objectifs
* **Utilisez la visibilité des champs par vue** — même objet, angle différent
## Articles connexes
* [Vues de tableau](/l/fr/user-guide/views-pipelines/capabilities/table-views) — fonctionnalités de la vue en liste
* [Vues Kanban](/l/fr/user-guide/views-pipelines/capabilities/kanban-views) — vues basées sur des cartes

View File

@@ -0,0 +1,78 @@
---
title: Filtres et tri
description: Filtrez et triez les enregistrements pour trouver exactement ce dont vous avez besoin.
---
## Filtrage des données
Les filtres vous aident à vous concentrer sur des enregistrements spécifiques en n'affichant que ceux qui correspondent à vos critères.
### Ajout d'un filtre
1. Cliquez sur le bouton **Filtre** dans la barre d'outils
2. Sélectionnez le champ à utiliser pour le filtrage
3. Choisissez l'opérateur (égal à, contient, etc.)
4. Saisissez la valeur du filtre
5. Cliquez sur **Appliquer**
### Opérateurs de filtrage
| Type de champ | Opérateurs disponibles |
| ------------- | -------------------------------------------------------- |
| Texte | Égal à, Contient, Commence par, Se termine par, Est vide |
| Nombre | Égal à, Supérieur à, Inférieur à, Est vide |
| Date | Égal à, Avant, Après, Est vide |
| Sélection | Égal à, Est l'un de, Est vide |
| Case à cocher | Est vrai, Est faux |
| Relation | Égal à, Est vide |
### Filtres multiples
Combinez plusieurs filtres pour affiner les résultats:
* Tous les filtres sont appliqués avec une logique ET
* Chaque filtre supplémentaire restreint davantage les résultats
### Suppression des filtres
* Cliquez sur le **X** de chaque pastille de filtre
* Cliquez sur **Tout effacer** pour supprimer tous les filtres
## Tri des données
Le tri détermine l'ordre dans lequel les enregistrements apparaissent.
### Ajout d'un tri
1. Cliquez sur le bouton **Tri** dans la barre d'outils
2. Sélectionnez le champ à utiliser pour le tri
3. Choisissez l'ordre croissant (A-Z, 0-9) ou décroissant (Z-A, 9-0)
4. Cliquez sur **Appliquer**
### Tris multiples
Ajoutez plusieurs niveaux de tri:
* Le premier tri est prioritaire
* Les tris suivants s'appliquent au sein des groupes de valeurs égales
### Tri rapide par colonne
Cliquez sur l'en-tête d'une colonne pour trier:
* Premier clic: croissant
* Deuxième clic: décroissant
* Troisième clic: supprimer le tri
## Enregistrement des paramètres de filtre et de tri
Les filtres et les tris sont enregistrés avec la vue:
1. Configurez vos filtres et tris
2. Cliquez sur **Enregistrer** pour mettre à jour la vue actuelle
3. Ou cliquez sur **Enregistrer comme nouvelle vue** pour créer une variante
## Articles connexes
* [Vues de tableau](/l/fr/user-guide/views-pipelines/capabilities/table-views) — fonctionnalité de regroupement
* [Aperçu des vues](/l/fr/user-guide/views-pipelines/overview) — création et gestion des vues

View File

@@ -0,0 +1,98 @@
---
title: Vues du tableau Kanban
description: Apprenez à utiliser les vues Kanban pour visualiser et gérer vos flux de travail.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## À propos des Vues Kanban
Les vues Kanban cartographient visuellement les flux de processus, où chaque colonne représente une étape distincte et chaque carte représente un enregistrement.
## Déplacer les Cartes entre les Étapes
Vous pouvez déplacer chaque carte entre les étapes au fur et à mesure de votre flux de travail en cliquant et en maintenant une carte, puis glisser-le à l'étape suivante.
<VimeoEmbed videoId="927888627" title="Démonstration vidéo" />
## Ajouter et supprimer des étapes
Vous pouvez adapter votre flux de travail à vos besoins en utilisant des étapes, chacune représentant une valeur dans un champ de sélection:
### Ajouter des étapes
Pour ajouter une étape, accédez aux paramètres de champ Select en naviguant dans Paramètres > Modèle de données, en sélectionnant votre objet, puis en sélectionnant le champ dont dépend votre tableau Kanban.
<VimeoEmbed videoId="927890428" title="Démonstration vidéo" />
### Supprimer des Étapes
Pour supprimer une étape, survolez le nom de l'étape ou l'icône `⋮`, cliquez sur `Modifier depuis les réglages` dans les paramètres du champ de sélection, puis cliquez sur **Supprimer** à côté de l'étape concernée.
## Afficher les champs
Vous pouvez configurer votre tableau Kanban pour afficher certains champs et en masquer d'autres. Pour afficher ou masquer un champ, cliquez sur **Options** en haut à droite puis sur **Champs** pour afficher la liste des options, et cliquez sur l'icône de l'œil à côté du champ pour l'afficher ou le cacher.
Vous pouvez également réorganiser l'ordre des champs en maintenant le nom du champ et en le glissant à l'endroit souhaité.
<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />
## Vue compacte
Vous pouvez masquer tous les champs et obtenir une vue d'ensemble de tous les enregistrements en un coup d'œil. Pour activer :
1. Cliquez sur **Options** en haut à droite
2. Activez l'option **Vue compacte**
<img src="/images/user-guide/kanban-views/compact-view.png" style={{width:'100%'}} />
## Agrégations de colonnes
Chaque colonne d'une vue Kanban peut afficher des valeurs agrégées en haut, ce qui vous aide à comprendre vos données en un coup d'œil.
### Agrégations disponibles
| Agrégation | Description |
| ----------- | --------------------------------------------------------------- |
| **Nombre** | Nombre d'enregistrements dans la colonne |
| **Somme** | Total d'un champ numérique (par exemple, montants des affaires) |
| **Moyenne** | Valeur moyenne d'un champ numérique |
| **Min** | Valeur minimale |
| **Max** | Valeur maximale |
### Configuration des agrégations
1. Cliquez sur le nombre affiché à côté de la valeur de l'étape en haut d'une colonne
2. Sélectionnez le type d'agrégation
3. Choisissez le champ à agréger
**Exemple :** Affichez la valeur totale des affaires par étape en agrégeant le champ Montant avec la Somme.
## Quand utiliser les vues Kanban
Les vues Kanban sont idéales pour :
* **Pipelines de vente** : Suivez les affaires à travers les étapes, du prospect à la conclusion
* **Gestion de projet** : Suivez les tâches à travers les états du flux de travail
* **Recrutement** : Suivez les candidats à travers les étapes du recrutement
* **Tout processus en étapes** : Visualisez tout flux de travail avec des étapes définies
## Meilleures pratiques
### Organisez vos étapes
* **Limitez les étapes** : 5 à 7 étapes sont idéales pour la visibilité
* **Nommage clair** : Utilisez des noms d'étapes descriptifs
* **Ordre logique** : Organisez les étapes dans l'ordre du processus
### Optimisez l'affichage des cartes
* **Affichez les champs clés** : N'affichez que les informations les plus importantes
* **Utiliser la vue compacte**: pour les aperçus de haut niveau
* **Code couleur** : Utilisez les couleurs d'étape pour identifier rapidement le statut
### Maintenez la qualité des données
* **Mettez à jour régulièrement** : Faites avancer les cartes à travers les étapes
* **Archivez les éléments terminés** : Déplacez les éléments fermés hors de la vue active
* **Passez en revue les cartes inactives** : Assurez le suivi des cartes bloquées dans des étapes

View File

@@ -0,0 +1,64 @@
---
title: Vues de Tableau
description: Affichez vos données dans un format de liste semblable à un tableur.
---
## À propos des Vues de Tableau
Les vues de tableau affichent les enregistrements sous forme de lignes, avec des colonnes personnalisables — comme un tableur. C’est le type de vue par défaut pour la plupart des objets.
<img src="/images/user-guide/table-views/table-view.png" style={{width:'100%'}} />
## Fonctionnalités
### Configuration des colonnes
* Afficher ou masquer des colonnes (champs)
* Redimensionner la largeur des colonnes
* Réorganiser les colonnes en les faisant glisser
### Regrouper par un champ de type Sélection
Organisez les enregistrements en groupes repliables selon un champ de type Sélection.
<img src="/images/user-guide/table-views/table-group-by.png" style={{width:'100%'}} />
1. Cliquez sur **Options**
2. Sélectionnez **Grouper**
3. Choisissez un champ de type Sélection
4. Configurez l’ordre des groupes sous **Options → Grouper → Trier** :
* **Alphabétique** ou **alphabétique inversé**
* **Ordre manuel** : Faites glisser les groupes sous "Groupes visibles" pour les réorganiser
* Cliquez sur l’**icône en forme d’œil** à côté d’un groupe pour le masquer
**Cas d’utilisation :**
* Grouper les entreprises par type
* Regrouper les opportunités par étape
* Regrouper les tâches par statut
<Note>
**Pour des performances optimales, limitez-vous à 10-15 groupes visibles par vue.** Si vous avez besoin de plus de groupes, envisagez d’utiliser plutôt un tableau de bord.
</Note>
### Largeur des colonnes
Redimensionnez les colonnes pour afficher plus ou moins de contenu :
1. Placez le curseur entre deux en-têtes de colonne
2. Cliquez et faites glisser la bordure de la colonne
3. Relâchez pour définir la nouvelle largeur
## Quand utiliser les vues de tableau
Les vues de tableau sont idéales pour :
* **Parcourir de grands ensembles de données** — passer rapidement en revue un grand nombre d’enregistrements
* **Saisie de données** — modifier efficacement plusieurs enregistrements
* **Analyse détaillée** — voir de nombreux champs en même temps
* **Tri et filtrage** — trouver des enregistrements spécifiques
## Articles connexes
* [Champs et colonnes](/l/fr/user-guide/views-pipelines/capabilities/fields-and-columns) — configuration des champs à afficher
* [Filtres et tri](/l/fr/user-guide/views-pipelines/capabilities/filters-and-sorting) — affiner les enregistrements

View File

@@ -0,0 +1,74 @@
---
title: Paramètres de vue
description: Gérez la visibilité, le nom, les icônes et l'organisation des vues.
---
## Visibilité de la vue
Contrôlez qui peut voir vos vues personnalisées.
### Options de visibilité
| Paramètre | Qui peut voir |
| --------------------- | --------------------------------------- |
| **Espace de travail** | Tous les membres de l'espace de travail |
| **Non répertorié** | Vous uniquement |
### Modifier la visibilité
1. Ouvrez la vue
2. Cliquez sur **Options → Visibilité**
3. Sélectionnez **Espace de travail** ou **Non répertorié**
<Note>
La visibilité des vues par défaut "All [Object Name]" ne peut pas être modifiée.
</Note>
## Renommer une vue
1. Ouvrez le menu déroulant de la vue
2. Cliquez sur le menu **⋮** à côté de la vue
3. Sélectionnez **Modifier**
4. Saisissez le nouveau nom
## Modifier l'icône de la vue
1. Ouvrez le menu déroulant de la vue
2. Cliquez sur le menu **⋮** à côté de la vue
3. Sélectionnez **Modifier**
4. Cliquez sur l'icône pour la modifier
## Réorganiser les vues
Modifiez l'ordre d'affichage des vues dans le menu déroulant:
1. Ouvrez le menu déroulant de la vue
2. Faites glisser les vues à l'aide de leur poignée
3. Déposez à la position souhaitée
4. L'ordre est enregistré automatiquement
## Favoriser une vue
Épinglez les vues fréquemment utilisées pour un accès rapide:
1. Ouvrez le menu déroulant de la vue
2. Cliquez sur le menu **⋮** à côté d'une vue
3. Sélectionnez **Ajouter aux favoris**
Les vues ajoutées aux favoris apparaissent dans une section dédiée pour un accès rapide.
## Supprimer une vue
1. Ouvrez le menu déroulant de la vue
2. Cliquez sur le menu **⋮** à côté de la vue
3. Sélectionnez **Supprimer**
4. Confirmez la suppression
<Warning>
Les vues supprimées ne peuvent pas être restaurées.
</Warning>
## Articles connexes
* [Aperçu des vues](/l/fr/user-guide/views-pipelines/overview) — création de vues
* [Comment restreindre l'accès](/l/fr/user-guide/views-pipelines/how-tos/restrict-access-to-your-view) — guide pas à pas

View File

@@ -0,0 +1,61 @@
---
title: Créer une vue Calendrier pour les tâches arrivant à échéance
description: Visualisez vos tâches et vos échéances sur un calendrier.
---
<img src="/images/user-guide/views/calendar-view-zoom.png" style={{width:'100%'}} />
## Prérequis
L'objet Tasks doit comporter un champ **Due Date** (de type Date ou Date & Time).
## Étapes
1. Accédez à **Tasks**
2. Cliquez sur le menu déroulant de la vue → **+ Ajouter une vue**
3. Nommez votre vue (par exemple, "Tasks Calendar")
4. Cliquez sur **Créer**
5. Cliquez sur **Options** et sélectionnez **Calendar** comme mise en page
6. Choisissez **Due Date** comme champ de date
7. Cliquez sur **Enregistrer**
## Configurez votre calendrier
### Afficher les champs sur les événements
1. Cliquez sur **Options → Champs**
2. Cliquez sur l'**icône en forme d'œil** pour afficher/masquer les champs
3. Faites glisser pour réorganiser
Champs recommandés à afficher :
* **Title** — nom de la tâche
* **Assignee** — personne responsable
* **Status** — avancement actuel
### Filtrez votre calendrier
Créez des vues ciblées :
* **My Tasks** : Filtrez par Assignee = Me
* **This Week** : Filtrez par Due Date = This week
* **En retard** : Filtrer par Date d'échéance < Aujourd'hui, Statut ≠ Terminé
## Autres cas d'utilisation du calendrier
| Objet | Champ de date | Objectif |
| ------------------------ | ------------------- | -------------------------------- |
| Opportunités | Date de clôture | Suivre les clôtures prévues |
| Événements personnalisés | Date de l'événement | Planifier les activités |
| Projets | Échéance | Suivre les échéances des projets |
## Conseils
* **Passez en revue chaque semaine** : Commencez chaque semaine en consultant votre vue Calendrier
* **Combiner avec la vue Tableau** : Utilisez le calendrier pour la vue d'ensemble, le tableau pour les détails
* **Définir la visibilité** : Conservez les calendriers de tâches personnels comme Non répertoriés
## Articles connexes
* [Vue Calendrier](/l/fr/user-guide/views-pipelines/capabilities/calendar-view) — toutes les fonctionnalités du calendrier
* [Filtres et tri](/l/fr/user-guide/views-pipelines/capabilities/filters-and-sorting) — filtrez votre calendrier

View File

@@ -0,0 +1,80 @@
---
title: Créer une vue Kanban pour les projets
description: Suivez les projets au fil des étapes à l'aide d'un tableau visuel.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Utilisez une vue Kanban pour visualiser vos projets (ou tout objet avec des étapes) sous forme de cartes se déplaçant entre les colonnes.
<VimeoEmbed videoId="927888627" title="Démonstration vidéo" />
## Prérequis
Votre objet doit avoir un **champ Select** à utiliser comme colonnes (par exemple : Statut, Étape, Phase).
Si vous n'en avez pas :
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez votre objet
3. Ajoutez un champ Select avec vos options d'étapes
## Étapes
1. Accédez à votre objet (par exemple : Projets, Tâches)
2. Cliquez sur le menu déroulant de la vue → **+ Ajouter une vue**
3. Nommez votre vue (par exemple : "Tableau de projet")
4. Cliquez sur **Créer**
5. Cliquez sur **Options** et sélectionnez **Kanban** comme mise en page
6. La vue utilise automatiquement votre champ Select pour les colonnes
7. Cliquez sur **Enregistrer**
## Configurer votre tableau
### Afficher les champs clés sur les cartes
1. Cliquez sur **Options → Champs**
2. Recherchez des champs dans la section "Champs masqués"
3. Cliquez sur l'**icône en forme d'œil** pour les afficher sur les cartes
4. Faites glisser pour réorganiser
<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />
### Activer la vue compacte
Pour une vue d'ensemble :
1. Cliquez sur **Options**
2. Activez la **vue compacte**
Les cartes n'affichent que le nom de l'enregistrement.
<img src="/images/user-guide/kanban-views/compact-view.png" style={{width:'100%'}} />
### Ajouter des agrégations
Affichez les décomptes ou les totaux en haut de chaque colonne :
1. Cliquez sur le nombre à côté du nom d'une colonne
2. Sélectionnez une agrégation (Nombre, Somme, etc.)
3. Choisissez un champ si nécessaire
## Déplacer des cartes
Faites glisser et déposez les cartes entre les colonnes pour mettre à jour leur statut.
<VimeoEmbed videoId="927888627" title="Démonstration vidéo" />
## Exemple : tableau de tâches
| Colonne (statut) | Cartes |
| ---------------- | ------------------------ |
| **À faire** | Nouvelles tâches |
| **En cours** | Travail en cours |
| **Validation** | En attente d'approbation |
| **Terminé** | Terminé |
## Articles connexes
* [Vues Kanban](/l/fr/user-guide/views-pipelines/capabilities/kanban-views) — agrégations, vue compacte, étapes
* [Comment configurer un pipeline de vente](/l/fr/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline) — Kanban pour les opportunités

View File

@@ -0,0 +1,51 @@
---
title: Créer une vue de tableau avec regroupement
description: Organisez vos enregistrements en groupes repliables selon la valeur d'un champ.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Regroupez votre vue de tableau par un champ Sélection pour organiser les enregistrements en sections repliables.
<img src="/images/user-guide/table-views/table-group-by.png" style={{width:'100%'}} />
## Étapes
1. Accédez à l'objet (Personnes, Entreprises, etc.).
2. Cliquez sur le menu déroulant de la vue → **+ Ajouter une vue**
3. Nommez votre vue (par exemple, "Entreprises par type")
4. Cliquez sur **Créer**
5. Cliquez sur **Options → Regrouper**
6. Choisissez un champ Sélection pour regrouper
7. Cliquez sur **Enregistrer**
## Configurer l'ordre des groupes
Dans **Options → Regrouper → Trier**, choisissez comment les groupes sont ordonnés :
| Option | Description |
| ------------------------ | ----------------------------------------------------------------------- |
| **Alphabétique** | De A à Z |
| **Alphabétique inversé** | De Z à A |
| **Ordre manuel** | Faites glisser les groupes pour les réorganiser sous "Groupes visibles" |
Cliquez sur l'**icône en forme d'œil** à côté d'un groupe pour le masquer de la vue.
<Note>
**Pour des performances optimales, limitez-vous à 10-15 groupes visibles.** Si vous en avez besoin de plus, envisagez d'utiliser plutôt un tableau de bord.
</Note>
## Exemple : Entreprises par secteur d'activité
1. Accédez à **Entreprises**
2. Créez une nouvelle vue nommée "Par secteur d'activité"
3. Cliquez sur **Options → Regrouper**
4. Sélectionnez le champ **Secteur d'activité**
5. Enregistrer
Vos entreprises sont maintenant organisées par secteur d'activité, ce qui facilite la concentration sur un segment à la fois.
## Articles connexes
* [Vues de tableau](/l/fr/user-guide/views-pipelines/capabilities/table-views) — toutes les fonctionnalités des vues de tableau
* [Filtres et tri](/l/fr/user-guide/views-pipelines/capabilities/filters-and-sorting) — combinez le regroupement avec des filtres

View File

@@ -0,0 +1,32 @@
---
title: Restreindre l’accès à votre vue
description: Contrôlez qui peut voir vos vues personnalisées.
---
Chaque vue (sauf les vues par défaut "All [Object Name]") possède son propre paramètre de visibilité.
## Étapes
1. Ouvrez la vue que vous souhaitez restreindre
2. Cliquez sur **Options** en haut à droite
3. Cliquez sur **Visibilité**
4. Sélectionnez **Non répertorié**
Votre vue est désormais visible uniquement par vous.
## Options de visibilité
| Paramètre | Qui peut voir |
| --------------------- | --------------------------------------- |
| **Espace de travail** | Tous les membres de l’espace de travail |
| **Non répertorié** | Vous uniquement |
## Notes
* Les vues par défaut "All [Object Name]" ne peuvent pas être rendues non répertoriées
* Les vues non répertoriées n’apparaissent pas dans les menus déroulants de vues des autres utilisateurs
* Vous pouvez à tout moment rétablir la visibilité sur l’espace de travail
## Articles connexes
* [Paramètres des vues](/l/fr/user-guide/views-pipelines/capabilities/view-settings) — toutes les options de configuration des vues

View File

@@ -0,0 +1,120 @@
---
title: Mettre en place un pipeline de vente
description: Configurez votre pipeline de vente pour suivre les opportunités au fil des étapes.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Dans Twenty, un pipeline de vente est une vue Kanban de votre objet Opportunités, où chaque colonne représente une étape de votre processus commercial.
## Étape 1 : Configurez vos étapes
Les étapes sont définies dans le champ **Étape** de l'objet Opportunités.
1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez **Opportunités**
3. Trouvez et cliquez sur le champ **Étape**
4. Ajoutez, supprimez ou renommez des étapes pour correspondre à votre processus
<VimeoEmbed videoId="927890428" title="Démonstration vidéo" />
### Étapes recommandées
| Étape | Objectif |
| ------------------- | ---------------------------------- |
| **Nouveau** | Opportunités récemment identifiées |
| **Qualifié** | Confirmée comme bien adaptée |
| **Réunion** | Engagée dans des discussions |
| **Proposition** | Proposition envoyée |
| **Négociation** | Négociation des conditions |
| **Clôturée gagnée** | Affaire gagnée |
| **Clôturée perdue** | Affaire perdue |
<Note>
**5-7 étapes est optimale.** Trop d'étapes rendent le pipeline difficile à analyser; trop peu de perte de visibilité dans le progrès de l'opération.
</Note>
## Étape 2 : Créez une vue de pipeline
1. Allez dans **Opportunités**
2. Cliquez sur le menu déroulant de la vue → **+ Ajouter une vue**
3. Nommez-la "Pipeline de vente"
4. Cliquez sur **Créer**
5. Ouvrez **Options** et sélectionnez **Kanban** comme mise en page
La vue utilise automatiquement le champ Étape pour les colonnes.
## Étape 3 : Configurez votre vue
### Affichez les champs clés
1. Cliquez sur **Options → Champs**
2. Recherchez des champs dans la section "Champs masqués"
3. Cliquez sur l'**icône en forme d'œil** pour afficher : Société, Montant, Date de clôture, Propriétaire
### Activez les agrégations
Affichez les totaux en haut de chaque colonne :
1. Cliquez sur le nombre affiché à côté d'un nom d'étape en haut d'une colonne
2. Sélectionnez le type d'agrégation (Nombre, Somme, Moyenne, etc.)
3. Choisissez le champ à agréger (par exemple, Montant)
**Exemple :** Affichez la valeur totale des affaires par étape en agrégeant le champ Montant avec la Somme.
### Utiliser la vue compacte (facultatif)
Pour une vue d'ensemble avec un contenu de carte minimal :
1. Cliquez sur **Options**
2. Activez l'option **Vue compacte**
## Étape 4 : Créez des vues personnelles et d'équipe
### "Mon pipeline"
* **Filtre** : Propriétaire = Moi
* **Visibilité** : Non répertoriée (vue personnelle)
### "Pipeline de l'équipe"
* **Filtre** : Aucun (tout afficher)
* **Visibilité** : Espace de travail (vue partagée)
### "Clôture ce mois-ci"
* **Type** : Tableau
* **Filtre** : Date de clôture = Ce mois-ci, Étape ≠ Clôturée gagnée, Étape ≠ Clôturée perdue
* **Tri** : Date de clôture croissante
## Travailler avec les opportunités
### Créer des opportunités
* Cliquez sur **+ New** dans la vue Opportunités
* Ou cliquez sur **+** dans la colonne d'une étape spécifique
### Passer d'une étape à l'autre
Faites glisser et déposez les cartes d'opportunité entre les colonnes pour mettre à jour leur étape.
<VimeoEmbed videoId="927888627" title="Démonstration vidéo" />
## Meilleures pratiques
### Hygiène du pipeline
* Mettez à jour les affaires quotidiennement au fur et à mesure de leur avancement
* Déplacez ou fermez rapidement les affaires stagnantes
* Gardez des dates de clôture réalistes
### Discipline des étapes
* Définissez des critères clairs pour chaque étape
* Déplacez les affaires rapidement lorsque les critères sont remplis
* Ne laissez pas les affaires rester trop longtemps dans les étapes
## Articles connexes
* [Vues Kanban](/l/fr/user-guide/views-pipelines/capabilities/kanban-views) — agrégations et vue compacte
* [Filtres et tri](/l/fr/user-guide/views-pipelines/capabilities/filters-and-sorting) — création de vues filtrées

View File

@@ -0,0 +1,149 @@
---
title: Afficher le Montant attendu dans votre pipeline
description: Calculez et affichez les valeurs d'affaire pondérées en fonction de la probabilité de l'étape.
---
Le Montant attendu est une valeur calculée : **Montant × Probabilité**. Cela vous aide à prévoir les revenus en pondérant les affaires selon leur probabilité de conclusion.
<Tip>
Ceci est un exemple de création de [Champs de formule](/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields) à l'aide de workflows.
</Tip>
Ce guide vous explique comment configurer les champs personnalisés et les workflows nécessaires pour calculer et afficher les montants attendus dans votre pipeline.
## Étape 1 : Créer des champs personnalisés
Vous avez besoin de deux champs personnalisés sur l'objet Opportunités.
### Créer le champ Probabilité
1. Allez dans **Paramètres → Modèle de données → Opportunités**
2. Cliquez sur **+ Ajouter un champ**
3. Configurer:
* **Nom** : Probabilité
* **Type** : Nombre
* **Description** : Probabilité selon l'étape (0–100 %)
4. Cliquez sur **Enregistrer**
### Créer le champ Montant attendu
1. Cliquez sur **+ Ajouter un champ**
2. Configurer:
* **Nom** : Montant attendu
* **Type** : Devise
* **Description** : Calculé : Montant × Probabilité
3. Cliquez sur **Enregistrer**
### Facultatif : rendre les champs en lecture seule pour les utilisateurs
Si vous ne souhaitez pas que les utilisateurs modifient manuellement ces champs calculés :
1. Allez dans **Paramètres → Membres → Rôles**
2. Sélectionnez le rôle à configurer
3. Recherchez l'objet Opportunités
4. Définissez les champs **Probabilité** et **Montant attendu** en lecture seule
Cela garantit que seuls les workflows peuvent mettre à jour ces valeurs.
## Étape 2 : Créer le workflow n° 1 — Mettre à jour la probabilité lors d'un changement d'étape
Ce workflow définit automatiquement la Probabilité lorsqu'une opportunité passe à une nouvelle étape.
### Créer le workflow
1. Allez dans **Workflows**
2. Cliquez sur **+ Nouveau workflow**
3. Nommez-le "Mettre à jour la probabilité lors d'un changement d'étape"
### Configurer le déclencheur
1. Ajoutez un déclencheur **Enregistrement créé ou mis à jour**
2. Sélectionnez **Opportunités** comme objet
3. Filtrer sur : le champ **Étape** est mis à jour
### Ajouter des branches pour chaque étape
Créez une branche pour chaque étape avec sa probabilité :
| Étape | Probabilité |
| ------------- | ----------- |
| Nouveau | 10 % |
| Qualifié | 25 % |
| Réunion | 40 % |
| Proposition | 60 % |
| Négociation | 80 % |
| Fermée gagnée | 100 % |
| Fermée perdue | 0% |
<Note>
Pour créer une nouvelle branche, cliquez avec le bouton droit sur la zone de travail du workflow et cliquez sur **Nouvelle action**. Puis, reliez cette action au nœud précédent en faisant glisser la flèche du nœud précédent vers cette nouvelle action.
</Note>
Pour chaque étape :
1. Ajoutez un nœud **Filtre** : Étape = [nom de l'étape]
2. Ajoutez une action **Mettre à jour l'enregistrement** :
* Enregistrement : l'opportunité déclenchante
* Champ : Probabilité
* Valeur : [probabilité pour cette étape]
### Calculer le montant attendu
Après la jonction des branches :
1. Ajoutez un nœud **Filtre** : le champ Montant n'est pas vide
2. Ajoutez une action **Mettre à jour l'enregistrement** :
* Enregistrement : l'opportunité déclenchante
* Champ : Montant attendu
* Valeur : Montant × Probabilité
## Étape 3 : Créer le workflow n° 2 — Recalculer lors d'une modification du montant
Ce workflow met à jour le Montant attendu lorsque le Montant de l'affaire change.
### Créer le workflow
1. Allez dans **Workflows**
2. Cliquez sur **+ Nouveau workflow**
3. Nommez-le "Recalculer le Montant attendu lors d'une modification du Montant"
### Configurer le déclencheur
1. Ajoutez un déclencheur **Enregistrement créé ou mis à jour**
2. Sélectionnez **Opportunités** comme objet
3. Filtrer sur : le champ **Montant** est mis à jour
### Ajouter la logique
1. Ajoutez un nœud **Filtre** : le champ Montant n'est pas vide
2. Ajoutez une action **Mettre à jour l'enregistrement** :
* Enregistrement : l'opportunité déclenchante
* Champ : Montant attendu
* Valeur : Montant × Probabilité
## Étape 4 : Afficher dans votre pipeline
Affichez maintenant les totaux de Montant attendu dans votre vue Kanban :
1. Ouvrez votre vue Kanban **Pipeline des ventes**
2. Cliquez sur le **nombre** à côté de n'importe quel nom d'étape en haut d'une colonne
3. Sélectionnez **Somme**
4. Choisissez **Montant attendu**
Chaque colonne affiche maintenant la valeur totale pondérée du pipeline pour cette étape.
## Résumé
| Composant | Objectif |
| ------------------------- | ----------------------------------------------------------------------------------- |
| **Champ Probabilité** | Stocke la probabilité de gain selon l'étape |
| **Champ Montant attendu** | Stocke Montant × Probabilité |
| **Workflow n° 1** | Met à jour la Probabilité lorsque l'Étape change, puis recalcule le Montant attendu |
| **Workflow n° 2** | Recalcule le Montant attendu lorsque le Montant change |
| **Agrégation** | Affiche la somme du Montant attendu par étape |
## Connexes
* [Champs de formule](/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields) — créer des champs calculés à l'aide de workflows
* [Vues Kanban](/l/fr/user-guide/views-pipelines/capabilities/kanban-views) — agrégations de colonnes
* [Comment créer des champs personnalisés](/l/fr/user-guide/data-model/how-tos/create-custom-fields) — configuration des champs

View File

@@ -0,0 +1,231 @@
---
title: Suivre la durée pendant laquelle les opportunités restent à chaque étape
description: Surveillez la vélocité des affaires en suivant le moment où les opportunités entrent dans chaque étape.
---
<Tip>
Voici un exemple de création de [champs de formule](/l/fr/user-guide/workflows/how-tos/crm-automations/formula-fields) à l'aide de Workflows — plus précisément des calculs de dates.
</Tip>
Suivre le moment où les opportunités entrent dans chaque étape vous aide à identifier les goulots d'étranglement et à mesurer la vélocité des affaires.
Ce guide vous explique comment configurer des champs personnalisés et un workflow pour enregistrer automatiquement le moment où une opportunité passe à chaque étape, et calculer le nombre de jours passés dans l'étape précédente.
## Étape 1 : Créez des champs personnalisés
Vous avez besoin de deux types de champs pour chaque étape :
* **Champs Date et heure** : Enregistrer le moment où l'opportunité est entrée dans chaque étape
* **Champs numériques** : Stocker le nombre de jours que l'opportunité a passés dans chaque étape
### Créez les champs "Dernière entrée"
1. Allez dans **Paramètres → Modèle de données → Opportunités**
2. Pour chaque étape, cliquez sur **+ Ajouter un champ** et configurez :
* **Nom** : Dernière entrée [Nom de l'étape] (par exemple, "Dernière entrée Nouveau", "Dernière entrée Qualifiée")
* **Type** : Date et heure
* **Description** : Horodatage du moment où l'opportunité est entrée dans cette étape
3. Cliquez sur **Enregistrer**
Créez ces champs :
* Dernière entrée Nouveau
* Dernière entrée Qualifiée
* Dernière entrée Réunion
* Dernière entrée Proposition
* Dernière entrée Négociation
* Dernière entrée Clôturée gagnée
* Dernière entrée Clôturée perdue
### Créez les champs "Jours dans l'étape"
1. Pour chaque étape, cliquez sur **+ Ajouter un champ** et configurez :
* **Nom** : Jours dans [Nom de l'étape] (par exemple, "Jours dans Nouveau", "Jours dans Qualifiée")
* **Type** : Numérique
* **Description** : Nombre de jours passés dans cette étape
2. Cliquez sur **Enregistrer**
Créez ces champs :
* Jours dans Nouveau
* Jours dans Qualifiée
* Jours dans Réunion
* Jours dans Proposition
* Jours dans Négociation
<Note>
Vous n'avez pas besoin de champs "Jours dans" pour Clôturée gagnée et Clôturée perdue, car ce sont des étapes finales.
</Note>
### Facultatif : rendre les champs en lecture seule
Si vous ne souhaitez pas que les utilisateurs modifient manuellement ces champs calculés :
1. Allez dans **Paramètres → Membres → Rôles**
2. Sélectionnez le rôle à configurer
3. Trouvez l'objet Opportunités
4. Définissez les champs "Dernière entrée" et "Jours dans" en lecture seule
## Étape 2 : Créez le workflow
Ce seul workflow gère les deux tâches :
* Enregistre l'horodatage lors de l'entrée dans une nouvelle étape
* Calcule le nombre de jours passés dans l'étape précédente
### Créez le workflow
1. Allez dans **Workflows**
2. Cliquez sur **+ Nouveau workflow**
3. Nommez-le "Suivre le temps par étape"
### Configurez le déclencheur
1. Ajoutez un déclencheur **Enregistrement mis à jour**
2. Sélectionnez **Opportunités** comme objet
3. Filtrer sur : le champ **Étape** est mis à jour
### Ajoutez des branches pour chaque étape
<Note>
Pour créer une nouvelle branche, faites un clic droit sur le canevas du workflow et cliquez sur **Nouvelle action**. Ensuite, reliez cette action au nœud précédent en faisant glisser la flèche du nœud précédent vers cette nouvelle action.
</Note>
---
**Branche 1 : Étape = Nouveau (première étape)**
Comme il s’agit de la première étape, seul l’horodatage d’entrée est enregistré — il n’y a aucune étape précédente à partir de laquelle effectuer un calcul.
1. Ajoutez un nœud **Filtre** : Étape = Nouveau
2. Ajoutez une action **Code** :
```javascript
export const main = async (): Promise<object> => {
return { now: new Date().toISOString() };
};
```
3. Ajoutez une action **Mettre à jour l'enregistrement** :
* Enregistrement : l'opportunité déclenchante
* Champ : Dernière entrée Nouveau
* Valeur : `now` depuis le nœud Code
---
**Branche 2 : Étape = Qualifiée**
Lors du passage à Qualifiée, enregistrez l'heure d'entrée ET calculez les jours passés dans Nouveau.
1. Ajoutez un nœud **Filtre** : Étape = Qualifiée
2. Ajoutez une action **Code** :
```javascript
export const main = async (params: {
lastEnteredPreviousStage: Date;
}): Promise<object> => {
const { lastEnteredPreviousStage } = params;
const now = new Date();
const entryDate = new Date(lastEnteredPreviousStage);
const diffTime = Math.abs(now.getTime() - entryDate.getTime());
const daysInPreviousStage = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
return {
now: now.toISOString(),
daysInPreviousStage: daysInPreviousStage
};
};
```
3. Configurez l'entrée du nœud Code : associez `lastEnteredPreviousStage` au champ **Dernière entrée Nouveau**
4. Ajoutez une action **Mettre à jour l'enregistrement** :
* Enregistrement : l'opportunité déclenchante
* Champs à mettre à jour:
* Dernière entrée Qualifiée = `now`
* Jours dans Nouveau = `daysInPreviousStage`
---
**Branche 3 : Étape = Réunion**
Lors du passage à Réunion, enregistrez l'heure d'entrée ET calculez les jours passés dans Qualifiée.
1. Ajoutez un nœud **Filtre** : Étape = Réunion
2. Ajoutez une action **Code** :
```javascript
export const main = async (params: {
lastEnteredPreviousStage: Date;
}): Promise<object> => {
const { lastEnteredPreviousStage } = params;
const now = new Date();
const entryDate = new Date(lastEnteredPreviousStage);
const diffTime = Math.abs(now.getTime() - entryDate.getTime());
const daysInPreviousStage = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
return {
now: now.toISOString(),
daysInPreviousStage: daysInPreviousStage
};
};
```
3. Configurez l'entrée du nœud Code : associez `lastEnteredPreviousStage` au champ **Dernière entrée Qualifiée**
4. Ajoutez une action **Mettre à jour l'enregistrement** :
* Enregistrement : l'opportunité déclenchante
* Champs à mettre à jour:
* Dernière entrée Réunion = `now`
* Jours dans Qualifiée = `daysInPreviousStage`
---
**Continuez pour les étapes restantes :**
| Étape | Enregistrements | Calcule |
| --------------- | ------------------------------- | ---------------------- |
| Proposition | Dernière entrée Proposition | Jours dans Réunion |
| Négociation | Dernière entrée Négociation | Jours dans Proposition |
| Clôturée gagnée | Dernière entrée Clôturée gagnée | Jours dans Négociation |
| Clôturée perdue | Dernière entrée Clôturée perdue | Jours dans Négociation |
Les branches n'ont pas besoin de se rejoindre — chacune s'exécute indépendamment lorsque sa condition d'étape est remplie.
## Étape 3 : Analyser le temps par étape
Avec les horodatages et les comptages de jours enregistrés, vous pouvez désormais analyser la vélocité des affaires.
### Créez une vue "Affaires lentes"
1. Créez une vue Tableau des Opportunités
2. Ajoutez des colonnes : Nom, Étape, Jours dans [étape précédente], Montant
3. Triez par le champ "Jours dans" (décroissant)
4. Filtrez par Étape pour vous concentrer sur une étape à la fois
Les affaires en haut ont passé le plus de temps dans l'étape précédente.
### Utilisez les agrégations
Dans votre vue Kanban du pipeline :
1. Cliquez sur le nombre à côté du nom d'une étape
2. Sélectionnez **Moyenne**
3. Choisissez un champ "Jours dans"
Cela affiche le temps moyen que les affaires passent à chaque étape.
## Résumé
| Composant | Objectif |
| ------------------------------ | -------------------------------------------------------------------------- |
| **Champs « Dernière entrée »** | Stockent le moment où l'opportunité est entrée dans chaque étape |
| **Champs « Jours dans »** | Stockent le nombre de jours passés dans chaque étape |
| **Workflow** | Enregistre l'horodatage ET calcule les jours en un seul passage |
| **Vues et agrégations** | Analysez la vélocité des affaires et identifiez les goulots d'étranglement |
## Connexes
* [Workflows](/l/fr/user-guide/workflows/overview) — principes de l'automatisation
* [Comment créer des champs personnalisés](/l/fr/user-guide/data-model/how-tos/create-custom-fields) — configuration des champs
* [Vues Kanban](/l/fr/user-guide/views-pipelines/capabilities/kanban-views) — agrégations

View File

@@ -0,0 +1,132 @@
---
title: Vues et Pipelines
description: Découvrez comment créer et gérer des vues dans Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Comprendre les vues
Les vues sont des configurations enregistrées qui déterminent la façon dont vos données sont affichées. Chaque vue peut avoir ses propres :
* **Disposition** : Tableau, Kanban ou Calendrier
* **Filtres** : Quels enregistrements afficher
* **Tri** : Comment les enregistrements sont classés
* **Champs** : Quelles colonnes sont visibles
## Types de vue
### Vue Tableau
La vue par défaut de type tableur affichant les enregistrements en lignes avec des colonnes personnalisables.
### Vue Kanban
Une vue tableau visuelle où les enregistrements apparaissent sous forme de cartes organisées par étapes. Idéal pour :
* Pipelines de vente
* Suivi de projets
* Tout flux de travail avec des étapes définies
### Vue Calendrier
Une vue de calendrier qui affiche les enregistrements avec des champs de date. Parfait pour :
* Réunions et événements
* Échéances et dates limites
* Planification basée sur le temps
## Création d'une Vue
Il y a deux manières de créer une nouvelle vue.
### Utilisez le menu déroulant de la vue
1. Accédez à n'importe quel objet (Personnes, Entreprises, etc.)
2. Cliquez sur le nom de la vue en haut à gauche (affiche la vue actuelle avec une flèche déroulante)
3. Cliquez sur **+ Ajouter une vue**
4. Nommez votre vue et cliquez sur **Créer**
5. Choisissez une disposition (Tableau, Kanban ou Calendrier) sous **Options**
6. Ajoutez des filtres et un tri selon vos besoins
7. Sélectionnez les champs à afficher et réorganisez-les
8. Cliquez sur **Enregistrer**
<VimeoEmbed videoId="1145648745" title="Démonstration vidéo" />
### Commencez par modifier une vue existante
1. Accédez à n'importe quel objet (Personnes, Entreprises, etc.)
2. Choisissez une disposition (Tableau, Kanban ou Calendrier) sous **Options**, puis ajoutez des filtres et un tri selon vos besoins
3. Cliquez sur **Enregistrer comme nouvelle vue**
4. Nommez votre vue et cliquez sur **Créer**
5. Continuez à modifier votre nouvelle vue
6. Cliquez sur **Mettre à jour la vue** pour enregistrer vos configurations supplémentaires
<VimeoEmbed videoId="1145654005" title="Démonstration vidéo" />
## Gérer les vues
### Modifier une vue
1. Sélectionnez la vue dans le menu déroulant
2. Apportez vos modifications (filtres, tri, colonnes)
3. Cliquez sur **Enregistrer** pour mettre à jour la vue
### Renommer une vue ou changer son icône
1. Ouvrez le menu déroulant de la vue
2. Cliquez sur le menu **⋮** à côté du nom de la vue
3. Sélectionnez **Modifier**
4. Modifiez le nom ou l'icône
5. Cliquez sur **Enregistrer**
### Réorganiser les vues
1. Ouvrez le menu déroulant de la vue
2. Cliquez et faites glisser une vue par sa poignée
3. Déposez-la à l'emplacement souhaité
4. Le nouvel ordre est enregistré automatiquement
### Ajouter aux favoris
Épinglez les vues fréquemment utilisées pour un accès rapide :
1. Ouvrez le menu déroulant de la vue
2. Cliquez sur le menu **⋮** à côté d'une vue
3. Sélectionnez **Ajouter aux favoris**
4. La vue apparaît dans votre section Favoris
### Supprimer une vue
1. Sélectionnez la vue à supprimer
2. Cliquez sur le menu déroulant de la vue
3. Cliquez sur le menu **⋮** à côté de la vue
4. Sélectionnez **Supprimer**
5. Confirmez la suppression
<Warning>
Les vues supprimées ne peuvent pas être récupérées. Assurez-vous de vouloir la supprimer avant de confirmer.
</Warning>
## Visibilité de la vue
Chaque vue (sauf les vues par défaut "Tous les [Nom de l'objet]") possède son propre paramètre de visibilité.
Pour modifier la visibilité :
1. Ouvrez la vue
2. Cliquez sur **Options → Visibilité**
3. Choisissez :
* **Espace de travail** : Visible par tous les membres de l'espace de travail
* **Non répertoriée** : Visible uniquement par vous
<Note>
La visibilité des vues par défaut "Tous les [Nom de l'objet]" ne peut pas être modifiée.
</Note>
## Prochaines étapes
* [Vues de Tableau](/l/fr/user-guide/views-pipelines/capabilities/table-views)
* [Vues Kanban](/l/fr/user-guide/views-pipelines/capabilities/kanban-views)
* [Filtres et tri](/l/fr/user-guide/views-pipelines/capabilities/filters-and-sorting)
* [Paramètres de la vue](/l/fr/user-guide/views-pipelines/capabilities/view-settings)

View File

@@ -0,0 +1,167 @@
---
title: Envoi d'e-mails via les workflows
description: Envoyez automatiquement des e-mails personnalisés en utilisant des actions de workflows.
---
Envoyez automatiquement des e-mails lorsque des événements spécifiques se produisent dans votre CRM—accueillez les nouveaux contacts, assurez le suivi des opportunités ou informez les membres de l'équipe.
## Prérequis
Avant de pouvoir envoyer des e-mails depuis des workflows :
1. Connectez un compte e-mail dans **Paramètres → Comptes**
2. Assurez-vous que les autorisations d'envoi sont activées pour le compte
## Workflow d'e-mails de base
### Exemple : E-mail de bienvenue pour les nouveaux contacts
**Objectif** : Envoyer un e-mail de bienvenue lorsqu'une nouvelle personne est ajoutée au CRM.
**Installation**:
1. **Créer un workflow** : Allez dans **Paramètres → Workflows** et cliquez sur **+ Nouveau workflow**
2. **Ajouter un déclencheur** : Sélectionnez **Enregistrement créé** → **Personnes**
3. **Ajouter l'action Envoyer un e-mail** :
* Cliquez sur **+** pour ajouter une action
* Sélectionnez **Envoyer un e-mail**
* Configurez l'e-mail :
| Champ | Valeur |
| -------------------- | -------------------------------------- |
| **À** | `{{trigger.object.email}}` |
| **Objet** | `Bienvenue sur {{Your Company Name}}` |
| **Corps du message** | `Hi {{trigger.object.firstName}}, ...` |
4. **Tester et activer** : Testez avec un enregistrement d'exemple, puis activez
## Utiliser des variables dans les e-mails
Faites référence aux données des étapes précédentes en utilisant la syntaxe `{{variable}}` :
```text
Hi {{trigger.object.firstName}},
Thank you for connecting with us!
Your company, {{trigger.object.company.name}}, is now in our system.
Best regards,
The Team
```
### Variables disponibles à partir des déclencheurs
| Type de déclencheur | Variables courantes |
| ---------------------------------- | -------------------------------------- |
| **Enregistrement créé/mis à jour** | `{{trigger.object.fieldName}}` |
| **Manuel** | `{{trigger.selectedRecord.fieldName}}` |
| **Webhook** | `{{trigger.body.fieldName}}` |
## Avancé : E-mails conditionnels
### Exemple : Différents e-mails selon la source du prospect
**Objectif** : Envoyer différents e-mails de bienvenue selon l'origine du prospect.
**Installation**:
1. **Déclencheur** : Enregistrement créé (Personnes)
2. **Ajouter l'action Filtre** :
* Condition : `{{trigger.object.source}}` est égal à `"Website"`
* Si vrai → continuer vers l'e-mail de bienvenue du site web
3. **Branche pour les autres sources** :
* Créez des branches parallèles pour différentes sources
* Chaque branche a sa propre action Envoyer un e-mail
## Envoi d'e-mails à plusieurs destinataires
### Exemple : Avertir l'équipe lorsqu'une opportunité est gagnée
**Objectif** : Envoyer un e-mail au commercial et à son responsable lorsqu'une opportunité est gagnée.
**Installation**:
1. **Déclencheur** : Enregistrement mis à jour (Opportunités, Étape = "Fermé Gagné")
2. **Rechercher des enregistrements** : Trouver le responsable du propriétaire de l'opportunité
3. **Envoyer l'e-mail #1** : Au propriétaire de l'opportunité
* À : `{{trigger.object.owner.email}}`
* Objet : `Congratulations on closing {{trigger.object.name}}!`
4. **Envoyer l'e-mail #2** : Au responsable
* À : `{{searchRecords.manager.email}}`
* Objet : `Deal Won: {{trigger.object.name}}`
## E-mails de suivi planifiés
### Exemple : Relancer 3 jours après la réunion
**Objectif** : Envoyer un e-mail de relance 3 jours après l'enregistrement d'une réunion.
**Installation**:
1. **Déclencheur** : Enregistrement créé (Activités, Type = "Réunion")
2. **Action de délai** : Attendre 3 jours
3. **Envoyer l'e-mail** :
* À : Participant à la réunion
* Objet : Suite à notre conversation
* Corps : Faites référence aux détails de la réunion depuis le déclencheur
## Pièces jointes aux e-mails
Vous pouvez joindre des fichiers aux e-mails envoyés à partir de workflows. La pièce jointe est un fichier statique que vous téléversez lors de la configuration du workflow.
### Comment ajouter une pièce jointe
1. Dans l'action **Envoyer un e-mail**, cliquez sur le bouton **Pièces jointes**
2. Cliquez pour téléverser un fichier depuis votre ordinateur
3. Le fichier sera joint à tous les e-mails envoyés par cette action
### Cas d'utilisation courants
| Cas d'utilisation | Fichier d'exemple |
| ------------------------------ | -------------------------------------- |
| **E-mails de bienvenue** | Brochure de l'entreprise (PDF) |
| **Séquences d'intégration** | Guide de prise en main |
| **Suivis des ventes** | Catalogue de produits ou liste de prix |
| **Confirmations d'événements** | Détails de l'événement ou programme |
<Note>
Les pièces jointes sont statiques — le même fichier est envoyé à tous les destinataires. Pour les documents dynamiques (comme des devis personnalisés), générez et joignez des fichiers à l'aide d'une [Logic Function](/l/fr/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty).
</Note>
## Meilleures pratiques
### Contenu de l'e-mail
* Conservez des lignes d'objet concises et pertinentes
* Personnalisez avec le nom du destinataire
* Incluez un appel à l'action clair
* Testez les e-mails avant l'activation
### Délivrabilité
* N'envoyez pas trop d'e-mails trop rapidement
* Utilisez des signatures d'e-mail professionnelles
* Évitez les mots déclencheurs de spam
* Assurez-vous de proposer des options de désabonnement pour les e-mails marketing
### Résolution des problèmes
* Vérifiez que le compte e-mail est connecté et actif
* Vérifiez que l'adresse e-mail du destinataire est valide
* Examinez les exécutions de workflows pour les messages d'erreur
* Testez d'abord avec votre propre adresse e-mail
## Articles connexes
* [Déclencheurs de workflows](/l/fr/user-guide/workflows/capabilities/workflow-triggers)
* [Actions de workflows](/l/fr/user-guide/workflows/capabilities/workflow-actions)

View File

@@ -0,0 +1,88 @@
---
title: Utiliser les branches dans les flux de travail
description: Comprendre le fonctionnement des branches et comment contrôler le chemin exécuté.
---
## Fonctionnement des branches
Dans l'éditeur de flux de travail, vous pouvez créer plusieurs chemins (branches) partant d'un seul nœud. Cela vous permet de créer des automatisations complexes avec des résultats différents.
**Important** : Lorsqu'un flux de travail s'exécute, **toutes les branches s'exécutent en parallèle par défaut**. Il n'existe pas de logique "if/else" intégrée pour choisir une branche plutôt qu'une autre — chaque chemin s'exécutera simultanément.
## Contrôler quelle branche s'exécute
Pour exécuter une seule branche selon des conditions spécifiques, **ajoutez un nœud Filter au début de chaque branche**.
### Exemple de configuration
1. Créez votre flux de travail avec plusieurs branches à partir d'un seul nœud
2. Ajoutez un nœud **Filter** comme première étape de chaque branche
3. Définissez des conditions sur chaque Filter pour déterminer quand cette branche doit continuer
4. Seules les branches dont les conditions du Filter sont satisfaites continueront
### Fonctionnement des nœuds Filter
* Si la condition du Filter est **remplie** : La branche continue son exécution
* Si la condition du Filter **n'est pas remplie** : La branche s'arrête au nœud Filter
Cela crée effectivement une logique conditionnelle où seule la branche appropriée s'exécute en fonction de vos données.
## Exemple : Routage selon le montant de l'affaire
**Scénario** : Lorsqu'une affaire est conclue, envoyez différentes notifications selon le montant de l'affaire.
1. **Déclencheur** : Opportunité mise à jour (Étape = Fermée gagnée)
2. **Branche 1** : Filter pour Montant > 10 000 $ → Envoyer un message Slack dans #big-deals
3. **Branche 2** : Filter pour Montant ≤ 10 000 $ → Envoyer un e-mail au responsable commercial
Les deux branches démarrent, mais seule celle qui correspond au montant de l'affaire continuera au-delà de son Filter.
## Création de branches
<Note>
Pour créer une nouvelle branche à partir d'une étape existante, cliquez sur le bouton **+** sur l'étape et ajoutez votre action. Vous pouvez ajouter plusieurs branches en cliquant plusieurs fois sur **+**.
</Note>
1. Dans l'éditeur de flux de travail, sélectionnez l'étape à partir de laquelle vous souhaitez créer une branche
2. Cliquez sur le bouton **+** pour ajouter une action
3. Cela crée une branche
4. Cliquez de nouveau sur **+** sur la même étape pour créer d'autres branches
5. Chaque branche peut avoir sa propre séquence d'actions
## Fusionner les branches
Une fois que les branches parallèles ont terminé leur travail, vous pouvez les fusionner de nouveau en un seul chemin :
1. Terminez vos actions dans les branches
2. Ajoutez une nouvelle étape qui doit s'exécuter après toutes les branches
3. Faites glisser une connexion depuis la dernière étape de chaque branche vers cette nouvelle étape
4. L'étape fusionnée attend que toutes les branches connectées soient terminées avant de s'exécuter
### Exemple : Traiter puis notifier
```
Trigger
│
├── Branch A: Update Customer Record
│
└── Branch B: Create Support Ticket
↘ ↙
Merged Step: Send Confirmation Email
```
L'e-mail de confirmation n'est envoyé qu'après la mise à jour du client et la création de tickets.
## Meilleures pratiques
* Utilisez toujours des **nœuds Filter** au début des branches lorsque vous souhaitez une exécution conditionnelle
* Gardez des conditions de branche **mutuellement exclusives** pour éviter les actions en double
* Testez vos flux de travail avec différentes données pour vous assurer que les bonnes branches s'exécutent
* **Renommez les étapes de branche** de manière descriptive afin qu'il soit clair ce que fait chaque chemin
* **Fusionnez les branches** lorsque vous avez besoin d'une action finale après un traitement en parallèle
## Articles connexes
* [FAQ sur les flux de travail](/l/fr/user-guide/workflows/how-tos/need-more-help/workflows-faq) — réponses concernant l'exécution parallèle
* [Actions de workflows](/l/fr/user-guide/workflows/capabilities/workflow-actions) — actions disponibles pour les branches

View File

@@ -0,0 +1,183 @@
---
title: Utiliser l'itérateur
description: Parcourez des tableaux d'enregistrements pour exécuter des actions sur chaque élément.
---
L'itérateur vous permet de parcourir un tableau d'enregistrements et d'exécuter des actions sur chacun. Il est essentiel pour les workflows qui doivent traiter plusieurs enregistrements renvoyés par Rechercher des enregistrements ou reçus via des webhooks.
## Quand utiliser l'itérateur
| Scénario | Exemple |
| -------------------------------------- | ------------------------------------------------------------------ |
| **Traiter les résultats de recherche** | Envoyer un e-mail à chaque personne trouvée |
| **Gérer les tableaux de webhooks** | Créer des enregistrements pour chaque élément, dans l'ordre |
| **Mises à jour en masse** | Mettre à jour plusieurs enregistrements avec des valeurs calculées |
| **Notifications** | Avertir plusieurs personnes d'un événement |
## Comprendre l'itérateur
L'itérateur attend un **tableau** en entrée. Il va ensuite :
1. Prend le premier élément du tableau
2. Exécute toutes les actions à l'intérieur de l'itérateur avec cet objet
3. Passe à l'élément suivant
4. Répète jusqu'à ce que tous les éléments soient traités
### Sélection du tableau à parcourir
La plupart des sources de tableaux (Search Records, un champ de tableau de webhook, un déclencheur manuel Bulk) peuvent être sélectionnées directement dans le sélecteur de variables.
Lorsqu’une étape **Code** ou **Logic Function** renvoie un *tableau de premier niveau*, sa sortie apparaît dans le sélecteur de variables sous forme d’entrées indexées (`0`, `1`, `2`, …). Pour effectuer une boucle sur le tableau dans son ensemble, sélectionnez l’option **Whole list** pour cette étape — l’Iterator en déduit alors automatiquement la structure de chaque élément à partir de la liste.
## Configuration de base
### Exemple : envoyer un e-mail à toutes les personnes dans les résultats de recherche
**Objectif** : Trouver tous les contacts d'une entreprise spécifique et envoyer à chacun un e-mail personnalisé.
### Étape 1 : Rechercher des enregistrements
1. Ajoutez l'action **Rechercher des enregistrements**
2. Objet : **Personnes**
3. Filtre : Entreprise égale à "Acme Inc"
4. Cela renvoie un tableau de personnes
### Étape 2 : Vérifier que des résultats existent
1. Ajoutez l'action **Filtre**
2. Condition : `{{searchRecords.length}}` est supérieur à 0
3. Cela évite les erreurs de l'itérateur sur des résultats vides
### Étape 3 : Ajouter un itérateur
1. Ajoutez une action **Itérateur**
2. Entrée du tableau : sélectionnez `{{searchRecords}}`
3. Cela crée une boucle
### Étape 4 : Ajouter des actions dans l'itérateur
Les actions placées dans l'itérateur s'exécutent pour chaque élément :
1. Ajouter l'action **Envoyer Email** (à l'intérieur de l'itérateur)
2. À : `{{iterator.currentItem.email}}`
3. Objet : Bonjour `{{iterator.currentItem.firstName}}` !
4. Corps : Message personnalisé utilisant les champs de l'élément en cours
### Résultat
Si l'action Rechercher des enregistrements renvoie 5 personnes, l'itérateur :
* Envoie un e-mail à la personne 1
* Envoie un e-mail à la personne 2
* ... continue pour les 5
## Accéder aux données de l'élément en cours
Dans l'itérateur, utilisez `{{iterator.currentItem}}` pour accéder à l'enregistrement en cours :
| Variable | Description |
| --------------------------------------- | --------------------------------------------------------- |
| `{{iterator.currentItem}}` | L'objet de l'enregistrement en cours dans son intégralité |
| `{{iterator.currentItem.id}}` | ID de l'enregistrement |
| `{{iterator.currentItem.email}}` | Champ e-mail |
| `{{iterator.currentItem.company.name}}` | Nom de l'entreprise associée |
| `{{iterator.index}}` | Position actuelle dans le tableau (indexé à partir de 0) |
Dans le sélecteur de variables, vous pouvez soit explorer un champ spécifique de l’élément courant, soit choisir **Use the whole item** pour référencer l’intégralité de l’élément courant (`{{iterator.currentItem}}`). Sélectionner l’élément entier est pratique lorsque vous voulez transmettre un enregistrement complet directement à une étape en aval plutôt que de le reconstruire champ par champ.
## Modèles courants
### Mettre à jour plusieurs enregistrements
**Objectif** : Marquer toutes les tâches en retard comme "En retard"
```
1. Search Records (Tasks, Due Date < Today, Status ≠ Completed)
2. Filter (length > 0)
3. Iterator (searchRecords)
└── Update Record
- Object: Tasks
- Record: {{iterator.currentItem.id}}
- Status: Late
```
### Créer des enregistrements à partir d'un tableau
**Objectif** : Le webhook reçoit une commande avec plusieurs éléments, créer un enregistrement pour chacun
```
1. Webhook Trigger (receives items array)
2. Filter (items.length > 0)
3. Iterator (trigger.body.items)
└── Create Record
- Object: Order Items
- Name: {{iterator.currentItem.name}}
- Quantity: {{iterator.currentItem.qty}}
- Related Order: {{trigger.body.orderId}}
```
### Traitement conditionnel dans la boucle
**Objectif** : N'envoyer un e-mail qu'aux contacts avec des adresses valides
```
1. Search Records (People)
2. Iterator (searchRecords)
└── Filter (currentItem.email is not empty)
└── Send Email
- To: {{iterator.currentItem.email}}
```
## Résolution des problèmes
### "L'itérateur attend un tableau"
**Cause** : Vous avez passé un seul enregistrement au lieu d'un tableau.
**Correctif** : Assurez-vous de passer le résultat de Rechercher des enregistrements ou un champ de type tableau, pas un seul enregistrement.
```
✅ Correct: {{searchRecords}}
❌ Wrong: {{searchRecords[0]}}
```
### L'itérateur ne s'exécute pas
**Cause** : Le tableau est vide.
**Correctif** : Ajoutez un filtre avant l'itérateur pour vérifier la longueur du tableau :
```
Filter: {{searchRecords.length}} > 0
```
### Les actions s'exécutent trop de fois
**Cause** : Rechercher des enregistrements a renvoyé plus d'enregistrements que prévu.
**Correctif** :
* Ajoutez des filtres plus spécifiques à Rechercher des enregistrements
* Définissez une limite sur Rechercher des enregistrements (max 200)
* Ajoutez un filtre dans l'itérateur pour des conditions supplémentaires
## Considérations relatives aux performances
* **Utilisation de crédits** : Chaque itération consomme des crédits pour ses actions
* **Temps** : Les grands tableaux prennent plus de temps à traiter
* **Limites** : Envisagez de traiter par lots les opérations très volumineuses
* **Limites de débit** : Les appels d'API externes peuvent atteindre des limites de débit avec de nombreuses itérations
## Meilleures pratiques
1. **Vérifiez toujours la longueur du tableau** avant l'itérateur pour éviter les erreurs
2. **Ajoutez des filtres dans les boucles** quand tous les éléments n'ont pas besoin d'être traités
3. **Renommez votre étape Itérateur** pour décrire ce qu'elle parcourt
4. **Testez avec de petits tableaux** avant de traiter de grands ensembles de données
5. **Surveillez l'exécution des workflows** pour vous assurer que les itérations se terminent comme prévu
## Articles connexes
* [Actions de workflows](/l/fr/user-guide/workflows/capabilities/workflow-actions)
* [Comment utiliser les branches](/l/fr/user-guide/workflows/capabilities/use-branches-in-workflows)
* [FAQ sur les workflows](/l/fr/user-guide/workflows/how-tos/need-more-help/workflows-faq)

View File

@@ -0,0 +1,332 @@
---
title: Actions de flux de travail
description: Découvrez les actions disponibles dans les workflows de Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## À propos des actions
Les actions définissent ce qui se passe après le déclenchement d'un déclencheur. Vous pouvez enchaîner plusieurs actions pour créer des automatisations complexes.
<Tip>
* Utilisez le sélecteur de variables (cliquez sur l'icône `(x+)`) pour parcourir les données disponibles provenant des étapes précédentes
* Survolez n'importe quel champ de saisie pour voir de quelle étape provient une variable — utile lorsque le même champ (par ex., ID) existe dans plusieurs étapes précédentes
* Donnez à chaque action un nom explicite pour faciliter la maintenance
</Tip>
## Actions sur les enregistrements
<img src="/images/user-guide/workflows/workflow_actions.png" style={{width:'100%'}} />
### Créer un enregistrement
Ajoute un nouvel enregistrement à un objet sélectionné.
**Configuration**:
* Sélectionnez l'objet cible
* Remplissez les champs requis et optionnels
* Utilisez les données des étapes précédentes ou saisissez des valeurs manuellement pour remplir les champs
**Sortie**: Les données de l'enregistrement nouvellement créé sont disponibles pour une utilisation dans les étapes suivantes.
### Mettre à jour un enregistrement
Modifie un enregistrement existant dans un objet sélectionné.
<img src="/images/user-guide/workflows/update_record.png" style={{width:'100%'}} />
**Configuration**:
* Sélectionnez l'objet cible
* Choisissez l'enregistrement spécifique à mettre à jour.
* Vous pouvez choisir un enregistrement fixe, à l'aide du menu déroulant affichant tous les enregistrements disponibles.
* Ou vous pouvez sélectionner l'enregistrement de façon dynamique, en désignant un enregistrement trouvé lors d'une étape précédente, à l'aide du `(x+)`. Vous ne pouvez pas rechercher l'enregistrement selon différents critères à ce stade. Si vous n'avez pas encore identifié l'enregistrement, ajoutez une étape `Search Record` avant cette étape `Update Record`.
* Sélectionnez les champs à modifier et entrez de nouvelles valeurs
**Sortie**: Les données de l'enregistrement mis à jour sont disponibles pour une utilisation dans les étapes suivantes.
### Supprimer un enregistrement
Supprime un enregistrement d'un objet sélectionné.
**Configuration**:
* Sélectionnez l'objet cible
* Choisissez l'enregistrement spécifique à supprimer
**Sortie**: Les données de l'enregistrement supprimé restent disponibles pour une utilisation dans les étapes suivantes.
### Rechercher des enregistrements
Trouve des enregistrements dans un objet sélectionné en utilisant des conditions de filtre.
**Configuration**:
* Sélectionnez l'objet à rechercher
* Définissez les critères de filtre pour restreindre les résultats
* Configurez le tri et les limites
**Sortie**: Renvoie les enregistrements correspondants qui peuvent être utilisés dans les étapes suivantes.
<Note>
**Limite**: Search Records renvoie un maximum de **200 enregistrements**. Si vous devez en traiter davantage, ajoutez des filtres spécifiques pour réduire les résultats ou utilisez des workflows planifiés pour traiter par lots.
</Note>
**Meilleure pratique**: Utilisez [branches](/l/fr/user-guide/workflows/capabilities/workflow-branches) après Search Records pour gérer les scénarios "trouvé" vs "non trouvé".
### Créer ou mettre à jour un enregistrement
Crée un nouvel enregistrement ou met à jour un enregistrement existant en fonction de critères de correspondance. C'est utile lorsque vous n'êtes pas certain qu'un enregistrement existe déjà.
<img src="/images/user-guide/workflows/upsert_double_identifier.png" style={{width:'100%'}} />
**Configuration**:
* Sélectionnez l'objet cible
* Notez quels champs peuvent être utilisés pour la correspondance : adresse e-mail pour les Contacts, domaine pour les Entreprises, ID pour tout objet, ou tout champ marqué comme unique. Vous devrez renseigner au moins l'un des éléments ci-dessous.
* Renseignez les valeurs des champs. N'oubliez pas de renseigner au moins un des identifiants uniques.
<Note>
**La correspondance fonctionne généralement encore mieux lorsque vous n'ajoutez qu'un seul identifiant unique.** Par exemple, la capture d'écran ci-dessous fera correspondre les entreprises en fonction de leur domaine. L'ID n'est pas forcément nécessaire.
</Note>
<img src="/images/user-guide/workflows/upsert_simple_identifier.png" style={{width:'100%'}} />
* Utilisez les données des étapes précédentes pour remplir les champs
**Comment ça marche**:
1. Recherche un enregistrement correspondant à vos critères
2. S'il est trouvé → met à jour l'enregistrement existant
3. S'il n'est pas trouvé → crée un nouvel enregistrement
**Sortie**: Les données de l'enregistrement créé ou mis à jour sont disponibles pour une utilisation dans les étapes suivantes.
## Actions de flux de travail
### Itérateur
**Parcourt un tableau d'enregistrements** renvoyé par une étape précédente, vous permettant d'effectuer des actions sur chaque enregistrement individuellement.
**Configuration**:
* Sélectionnez le tableau des enregistrements à partir d'une étape précédente (par exemple, les résultats de la recherche d'enregistrements, à partir d'un déclencheur manuel avec disponibilité en vrac à partir d'un noeud de Code). Lorsqu’une étape Code ou fonction logique renvoie un tableau de premier niveau, sélectionnez l’option **Whole list** pour itérer sur l’intégralité de la sortie.
* Définissez les actions à effectuer sur chaque enregistrement dans la boucle.
<Note>
- Vous pouvez ajouter plusieurs actions dans un itérateur.
- Lorsque vous utilisez des branches à l'intérieur d'un itérateur, assurez-vous que la dernière étape de chaque branche se connecte à l'itérateur pour fermer la boucle.
</Note>
* Accéder aux champs `Current Item`: pour utiliser les champs de l'enregistrement en cours de traitement, cliquez sur l'étape **Iterator**, puis sélectionnez **Current item**. La liste des champs disponibles de cet enregistrement s'affichera et pourra être sélectionnée pour une utilisation dans les actions suivantes. Vous pouvez également sélectionner **Use the whole item** pour transmettre l’intégralité de l’élément en cours à une étape en aval.
<VimeoEmbed videoId="1146577247" title="Démonstration vidéo" />
### Filtre
Filtre les enregistrements selon des conditions spécifiées, ne laissant passer que ceux qui répondent aux critères.
**Configuration**:
* Sélectionnez l'enregistrement à filtrer
* Définissez les conditions de filtre et les critères
* Configurez quels enregistrements doivent passer aux étapes suivantes
<Note>
1. **Sortie**: Les nœuds de filtre ne renvoient pas de données — ils agissent comme des portes. Si les conditions sont remplies, le flux de travail continue. Sinon, le flux de travail s'arrête à cette branche.
2. L'opérateur `IS` peut être utilisé avec des champs numériques. Il équivaut à `EQUAL`.
</Note>
### Délai
Met en pause l'exécution du flux de travail pendant une durée spécifiée ou jusqu'à une date/heure spécifique.
**Types de délai**:
| Type | Description |
| ------------------ | ---------------------------------------------------------------- |
| **Durée** | Attendre une durée spécifique (jours, heures, minutes, secondes) |
| **Date planifiée** | Attendre jusqu'à une date et une heure spécifiques |
**Configuration pour la durée**:
* Définissez des jours, des heures, des minutes et/ou des secondes
* Combinez plusieurs unités (par ex., 2 jours et 4 heures)
**Configuration pour la date planifiée**:
* Sélectionnez une date et une heure
* Peut référencer un champ de date d'une étape précédente (par ex., relancer 3 jours après une réunion)
**Cas d'utilisation**:
* Attendre 24 heures avant d'envoyer un e-mail de relance
* Mettre en pause jusqu'à la date de clôture d'une opportunité
* Planifier des actions pendant les heures ouvrées
<Note>
La date planifiée ne peut pas être dans le passé. Si un champ de date d'une étape précédente est utilisé et que la date est déjà passée, le flux de travail échouera.
</Note>
**Limites et crédits**:
* **Aucune limite de durée maximale** — vous pouvez définir des délais de quelques minutes, jours, semaines, ou plus
* **1 crédit consommé** lorsque le nœud Délai s'exécute, quelle que soit la durée
* **Aucun crédit consommé** pendant l'attente — un délai de 5 minutes coûte autant qu'un délai de 5 jours
## Actions de communication
### Envoyer l'email
Envoie un e-mail à partir de votre flux de travail. Idéal pour des e-mails groupés basés sur des modèles. Les e-mails auront l'apparence de ceux que vous envoyez depuis votre boîte aux lettres.
Il ne convient pas aux lettres d'information (qui nécessitent un formatage plus riche) ou aux séquences automatiques de courriel.
**Prérequis**: Ajoutez un compte de messagerie dans Paramètres → Comptes
**Configuration**:
* Sélectionnez le compte e-mail de l'expéditeur
<Note>
Vous pouvez uniquement envoyer des e-mails à partir de boîtes aux lettres synchronisées avec votre propre compte Twenty. L'envoi depuis les boîtes aux lettres d'autres membres de l'équipe (par ex., l'e-mail du propriétaire du compte) est sur la feuille de route.
</Note>
Pour toutes les étapes suivantes, vous pouvez référencer des variables des étapes précédentes pour la personnalisation.
* Entrez l'adresse e-mail du destinataire.
<Note>
Un seul destinataire est possible pour le moment.
</Note>
* Définissez la ligne d'objet.
* Rédigez le corps du message. Vous pouvez formater des liens, créer des listes numérotées, des listes de puces et ajouter des pièces jointes.
<Note>
L'ajout de signatures HTML n'est pas possible pour le moment.
</Note>
### Formulaire
Affiche un formulaire lors de l'exécution du flux de travail pour recueillir les saisies de l'utilisateur. Les réponses peuvent ensuite être utilisées dans les étapes suivantes pour créer des enregistrements, envoyer des e-mails ou exécuter toute autre action selon la saisie.
<Warning>
**Les formulaires sont conçus uniquement pour les déclencheurs manuels**. Pour les flux de travail avec d'autres déclencheurs (Enregistrement créé, mis à jour, etc.), les formulaires ne sont accessibles que via l'interface de l'exécution de flux de travail, ce qui n'est pas l'expérience utilisateur attendue. Un centre de notification sera publié en 2026 pour prendre en charge correctement les formulaires dans les flux de travail automatisés.
</Warning>
**Configuration**:
* Configurez les champs que les utilisateurs devront remplir. Pour chaque champ, choisissez
* un type parmi texte, nombre, date, un enregistrement donné, un champ de sélection. Les champs de tous les objets sont disponibles pour la sélection.
* une étiquette
* une valeur par défaut sous `Placeholder` (facultatif)
* Modifiez le titre du formulaire
**Sortie**: Les réponses au formulaire sont disponibles pour une utilisation dans les étapes suivantes.
**Exemple**: Le workflow "Lancer rapide" est disponible par défaut dans tous les espaces de travail, disponible n'importe où dans le menu de commande `Cmd+K`.
**Comment remplir le formulaire**:
* Déclenchez votre workflow manuel depuis le menu de commande `Cmd+K`
* Remplissez le formulaire affiché dans le panneau latéral et cliquez sur `Submit`.
<Note>
Les champs ne peuvent pas être rendus obligatoires.
</Note>
<VimeoEmbed videoId="1147277989" title="Démonstration vidéo" />
## Actions d'intégration
### Code
Exécute du JavaScript personnalisé dans votre flux de travail.
En arrière-plan, chaque action de code est prise en charge par sa propre **fonction logique** — une fonction TypeScript côté serveur qui s’exécute sur la plateforme Twenty. Lorsque vous ajoutez une action de code, Twenty crée une fonction logique dédiée pour cette étape et affiche son éditeur en ligne, de sorte que le code que vous écrivez soit associé au workflow.
**Configuration**:
* Accédez aux variables des étapes précédentes. Vous pouvez modifier les noms des variables de façon dynamique.
<VimeoEmbed videoId="1147281795" title="Démonstration vidéo" />
* Écrivez le code JavaScript dans l'éditeur
* Retournez des variables pour une utilisation dans les étapes suivantes
* Testez le code directement dans l'étape
<Note>
Si vous devez utiliser des clés d'API externes dans votre code, vous devez les saisir directement dans le corps de la fonction. Vous ne pouvez pas configurer des clés d'API ailleurs et les référencer dans la fonction logique.
</Note>
<Tip>
**Vous travaillez avec des tableaux ?** Les tableaux provenant de systèmes externes ou d'étapes précédentes peuvent arriver sous forme de chaînes de caractères. Voir [Gérer les tableaux dans les actions Code](/l/fr/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions) pour la solution.
</Tip>
<Tip>
Cliquez sur l'icône carrée en haut à droite de l'éditeur de code pour l'afficher en plein écran — utile car la largeur par défaut de l'éditeur est limitée.
</Tip>
#### Réutiliser une fonction logique dans plusieurs workflows
L’action de code en ligne est idéale pour de la logique ponctuelle, mais le code qu’elle contient est propre à cette seule étape. Lorsque vous voulez partager la même logique entre plusieurs workflows — ou la maintenir comme code source versionné dans une application — définissez une **fonction logique réutilisable** au lieu de copier-coller du code dans chaque action de code.
Une fonction logique est définie une seule fois dans une application (à l’aide de `defineLogicFunction` du SDK) et exposée au concepteur de workflows en ajoutant `workflowActionTriggerSettings`. Une fois votre application installée, cette fonction apparaît comme une action à part entière dans le concepteur de workflows, à côté des actions intégrées. La sélectionner affiche les champs d’entrée que vous avez déclarés (avec des sélecteurs de variables, comme pour les autres actions) et exécute votre code mutualisé — aucun JavaScript en ligne n’est requis.
| | Action de code | Fonction logique réutilisable |
| ------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------- |
| **Où le code est stocké** | Éditeur en ligne, lié à une étape de workflow | Définie dans une application, versionnée dans un système de contrôle de version |
| **Réutilisation** | Copié-collé par étape | Ajoutée comme action dans n’importe quel workflow |
| **Entrées** | Variables connectées dans l’éditeur | Champs générés à partir de votre schéma d’entrée déclaré |
| **Idéal pour** | Logique rapide, spécifique à un workflow | Logique partagée utilisée dans plusieurs workflows |
Les deux s’exécutent sur le même environnement d’exécution des fonctions logiques, de sorte qu’une action de code que vous avez prototypée en ligne peut ensuite être promue en fonction logique réutilisable avec des modifications minimales.
<Tip>
Pour la documentation destinée aux développeurs sur la définition des fonctions logiques et leur exposition dans le concepteur de workflows, consultez [Logic Functions](/l/fr/developers/extend/apps/logic/logic-functions) — en particulier la section **Exposing a function as an AI tool or workflow action** et `workflowActionTriggerSettings`.
</Tip>
### Requête HTTP
Envoie une requête à une API externe dans le cadre de votre flux de travail.
<img src="/images/user-guide/workflows/http_action.png" style={{width:'100%'}} />
**Configuration**:
* Entrez l'URL du point de terminaison de l'API. Il est possible d'utiliser des paramètres issus des étapes précédentes.
* Sélectionnez la méthode HTTP (GET, POST, PUT, PATCH, DELETE)
* Ajoutez les en-têtes et valeurs requis
* Fournissez un exemple de réponse pour l'aperçu de la structure
## Actions d'IA
### Agent IA - Bientôt disponible
Exécute un agent IA au sein de votre flux de travail pour effectuer des tâches intelligentes.
**Configuration**:
* **Agent**: Sélectionnez un agent IA existant ou utilisez l'agent par défaut
* **Prompt**: Écrivez l'instruction pour l'agent IA
* Référencez des variables des étapes précédentes dans le prompt
**Ce que les agents IA peuvent faire**:
* Analyser et résumer des données
* Classer ou catégoriser des enregistrements
* Générer du contenu textuel
* Prendre des décisions basées sur des données
* Interagir avec vos données CRM à l'aide d'outils
**Sortie**: La réponse de l'agent IA est disponible pour une utilisation dans les étapes suivantes. Si l'agent a un schéma de sortie structuré, la réponse suivra ce format.
<Note>
Les actions d'agent IA consomment des crédits de flux de travail en fonction du modèle d'IA utilisé. Voir [Crédits de flux de travail](/l/fr/user-guide/workflows/capabilities/workflow-credits) pour plus de détails.
</Note>
<Note>
Les agents IA respectent les autorisations basées sur les rôles. Vous pouvez attribuer des rôles spécifiques aux agents dans **Paramètres → Membres → Rôles** pour contrôler les données auxquelles ils peuvent accéder. Voir [Autorisations](/l/fr/user-guide/permissions-access/capabilities/permissions) pour plus de détails.
</Note>

View File

@@ -0,0 +1,66 @@
---
title: Branches de flux de travail
description: Créez des chemins parallèles et une logique conditionnelle dans vos flux de travail.
---
Les branches vous permettent de scinder votre flux de travail en plusieurs chemins pouvant s’exécuter simultanément ou de façon conditionnelle selon vos données.
<img src="/images/user-guide/workflows/branches.png" style={{width:'100%'}} />
## Fonctionnement des branches
Lorsque vous créez plusieurs connexions à partir d’un seul nœud, chaque chemin devient une branche. Par défaut, **toutes les branches s’exécutent en parallèle** — elles ne s’attendent pas les unes les autres.
## Création de branches
### Ajouter une nouvelle branche
1. **Cliquez avec le bouton droit sur la zone de travail principale** du flux de travail (et non sur un nœud existant)
2. Cliquez sur **Ajouter un nœud**
3. Choisissez le type de nœud pour votre nouvelle branche
4. Faites glisser une flèche depuis le bas de l’étape précédente vers le haut de cette nouvelle action
5. Répétez pour ajouter d’autres branches à partir du même nœud
<Note>
Chaque branche est indépendante. L’ajout d’une branche n’affecte pas les autres chemins existants à partir de ce nœud.
</Note>
### Disposition visuelle
Les branches apparaissent comme des chemins parallèles dans l’éditeur de flux de travail. Vous pouvez faire glisser les nœuds pour réorganiser la disposition visuelle sans affecter l’exécution.
## Branches conditionnelles
Puisque toutes les branches s’exécutent par défaut, utilisez des nœuds **Filtre** pour contrôler quels chemins s’exécutent réellement :
| Branche | Condition de filtre | Action |
| ------- | --------------------- | ---------------------------------- |
| A | Étape = "Gagnée" | Envoyer un e-mail de félicitations |
| B | Étape = "Perdue" | Créer une tâche de suivi |
| C | Étape = "Négociation" | Notifier le responsable |
1. Créez des branches à partir de votre déclencheur ou action
2. Ajoutez un nœud **Filtre** comme première étape de chaque branche
3. Configurez chaque filtre avec des conditions mutuellement exclusives
4. Ajoutez vos actions après chaque filtre
Seules les branches pour lesquelles la condition du filtre est remplie poursuivront l’exécution.
## Fusion de branches
**Les branches ne fusionnent pas automatiquement.** Chaque branche s’exécute indépendamment jusqu’à sa fin. Vous avez toute latitude quant à la manière de gérer cela :
* **Option 1 : Garder les branches séparées**
Chaque branche gère ses propres actions de suivi de manière indépendante. C’est l’approche la plus simple lorsque les branches n’ont pas besoin de converger.
* **Option 2 : Fusionner les branches manuellement**
Lors de la création de votre flux de travail, vous pouvez connecter manuellement plusieurs branches à la même action en aval. Il suffit de faire glisser des flèches depuis la fin de chaque branche vers un nœud commun.
<Note>
Bien que vous puissiez utiliser un nœud [Delay](/l/fr/user-guide/workflows/capabilities/workflow-actions#delay) pour mettre l’exécution en pause, il n’est pas actuellement configurable pour attendre "jusqu’à ce qu’une autre branche se termine".
</Note>
## Contenus associés
* [Comment utiliser les branches dans les flux de travail](/l/fr/user-guide/workflows/capabilities/use-branches-in-workflows) - Guide étape par étape
* [Actions de flux de travail](/l/fr/user-guide/workflows/capabilities/workflow-actions) - Actions disponibles, y compris Filtre

View File

@@ -0,0 +1,75 @@
---
title: Crédits de flux de travail
description: Comprendre la consommation et la gestion des crédits de flux de travail.
---
Les crédits de flux de travail alimentent vos automatisations dans Twenty. Comprendre comment ils fonctionnent vous aide à optimiser les coûts et gérer efficacement votre budget d'automatisation.
## Allocation des crédits
Les crédits de flux de travail sont alloués en fonction de votre cycle de facturation, et non de votre niveau de forfait :
| Cycle de facturation | Crédits |
| ---------------------- | ------------------ |
| **Abonnement mensuel** | 5 crédits par mois |
| **Abonnement annuel** | 50 crédits par an |
<Note>
5 crédits mensuels suffisent largement pour les automatisations standard. La plupart des équipes ne dépasseront pas cette limite avec une utilisation typique des flux de travail. Des crédits supplémentaires sont principalement nécessaires pour les actions de Code avancées et les flux de travail alimentés par l'IA.
</Note>
## Comment fonctionne la consommation de crédits
Les crédits sont consommés lors de l'exécution des flux de travail, et non lors de leur création. Chaque action du flux de travail consomme des crédits en fonction de sa complexité :
### Consommation de crédits par type d'action
* **Opérations internes de base** : Très faible consommation de crédits
* Rechercher des enregistrements
* Créer un enregistrement
* Mettre à jour un enregistrement
* Supprimer un enregistrement
* Actions de formulaire
* **Opérations complexes** : Consommation de crédits plus élevée
* Actions de code (exécution JavaScript)
* Requêtes HTTP vers des services externes
* **Fonctionnalités d'IA** : Consommation de crédits plus élevée
* Les actions de l'agent IA consomment des crédits en fonction du modèle d'IA utilisé
* Des requêtes plus complexes et des réponses plus longues utilisent davantage de crédits
* **Actions de type Delay** : Consommation de crédits minimale
* Le nœud Delay consomme **1 crédit** lors de son exécution
* **Aucun crédit n'est consommé** pendant la période d'attente
* Un délai de 5 minutes coûte autant qu'un délai de 5 jours
### Déduction en temps réel
Les crédits sont déduits en temps réel au fur et à mesure des exécutions des flux de travail. Cela signifie :
* Les flux de travail en brouillon ne consomment pas de crédits
* Seuls les flux de travail actifs et en cours d'exécution utilisent votre allocation de crédits
* Les flux de travail échoués consomment tout de même des crédits pour les étapes complétées
## Gestion des crédits
### Vérifier l'utilisation des crédits
1. Allez dans **Paramètres → Facturation**
2. Consultez votre consommation actuelle de crédits et votre solde restant
3. Surveillez les habitudes d'utilisation pour optimiser vos flux de travail
### Achat de crédits supplémentaires
Si vous avez besoin de plus de crédits que votre allocation de plan :
1. Allez dans **Paramètres → Facturation**
2. Cliquez sur l'option pour acheter des crédits supplémentaires. Des forfaits de différentes tailles sont disponibles.
3. Les crédits sont ajoutés à votre solde actuel
## Meilleures pratiques
* **Traitement par lots** : Utilisez les opérations de masse et les actions Iterator efficacement pour réduire les appels d'action individuels
* **Optimisation du déclencheur manuel** : Pour les déclencheurs manuels, choisissez `Bulk` pour traiter plusieurs enregistrements en une seule exécution de flux de travail
* Optimisez les actions de code pour l'efficacité

View File

@@ -0,0 +1,93 @@
---
title: Exécutions de workflows
description: Surveiller et gérer les exécutions de flux de travail.
---
## À propos des Exécutions
Une **Exécution** est un enregistrement de l'exécution du flux de travail. Chaque fois qu'un flux de travail est déclenché — qu'il s'agisse d'un événement d'enregistrement, d'une planification, d'une action manuelle ou d'un webhook — une nouvelle exécution est créée.
## Visualisation des exécutions
### Depuis l'éditeur de flux de travail
1. Ouvrez le flux de travail que vous souhaitez surveiller
2. Cliquez sur le panneau **Exécutions** à droite
3. Affichez une liste des exécutions récentes avec leur statut
### Depuis la vue Exécutions de flux de travail
1. Accédez à **Exécutions de flux de travail** dans la barre latérale
2. Affichez les exécutions dans l'ensemble des flux de travail
3. Filtrez par statut, flux de travail ou date
## Statuts des exécutions
| Statut | Description |
| ---------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Exécution en cours** | Le flux de travail est en cours d'exécution |
| **Terminé** | Le flux de travail s'est terminé avec succès |
| **Échec** | Le flux de travail a rencontré une erreur et s'est arrêté |
| **En attente** | Le flux de travail est en pause (par exemple, en attente d'une action Delay ou de l'envoi d'un formulaire) |
## Détails de l'exécution
Cliquez sur une exécution pour voir :
* **Statut** : État actuel de l'exécution
* **Heure de début** : Moment où l'exécution a commencé
* **Durée** : Temps nécessaire à l'exécution
* **Données du déclencheur** : Les données qui ont déclenché le flux de travail
* **Résultats des étapes** : Données renvoyées par chaque étape
* **Messages d'erreur** : Si l'exécution a échoué, ce qui s'est mal passé
## Exécution étape par étape
Chaque exécution montre la progression au sein de votre flux de travail :
1. Voir quelles étapes se sont terminées avec succès
2. Identifier où les échecs se sont produits
3. Afficher les données transmises entre les étapes
4. Déboguez les problèmes en examinant les entrées et sorties des étapes
## Gestion des erreurs
Lorsqu'une exécution échoue :
1. Ouvrez l'exécution échouée
2. Trouvez l'étape à l'origine de l'échec
3. Consultez le message d'erreur pour plus de détails
Problèmes courants:
* Champs obligatoires manquants
* Format de données invalide
* Erreurs de l'API externe
* Problèmes d'autorisation
## Ré-exécution des Workflows
Si un run échoue, vous pouvez:
* Corriger le problème sous-jacent et attendre le prochain déclenchement
* Pour les flux de travail manuels, déclenchez à nouveau avec les mêmes données ou mises à jour
* Examinez la logique du workflow pour éviter les échecs futurs
## Conseils de performance
### Gestion de l'historique des courses
* Les courses sont conservées pour référence historique
* Les exécutions très anciennes peuvent être archivées automatiquement
* Exporter les données d'exécution si vous avez besoin de conserver les enregistrements
### Suivi des meilleures pratiques
* Vérifier les exécutions régulières après l'activation des nouveaux workflows
* La revue a échoué pour identifier les patrons
## Articles connexes
* [Déclencheurs de workflows](/l/fr/user-guide/workflows/capabilities/workflow-triggers)
* [Actions de workflows](/l/fr/user-guide/workflows/capabilities/workflow-actions)
* [Dépannage du workflow](/l/fr/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting)

View File

@@ -0,0 +1,137 @@
---
title: Déclencheurs de flux de travail
description: Découvrez les différents déclencheurs qui démarrent vos flux de travail.
---
## À propos des déclencheurs
Les flux de travail commencent toujours par un seul déclencheur qui définit quand l’automatisation doit s’exécuter.
<img src="/images/user-guide/workflows/workflow_triggers.png" style={{width:'100%'}} />
<Tip>
**Des objets avancés sont pris en charge !** Au-delà des objets CRM standard (Personnes, Entreprises, Opportunités), vous pouvez aussi déclencher des flux de travail et effectuer des actions sur :
* Membres de l'espace de travail
* Événements de calendrier
* Messages (e-mails)
* Tâches, notes et de nombreux autres objets système
Cela permet des automatisations puissantes, comme avertir les membres de l'équipe lorsque des événements de calendrier sont créés, ou traiter automatiquement les e-mails entrants.
</Tip>
## Un enregistrement est créé
Démarre le flux de travail lorsqu'un nouvel enregistrement est créé dans un objet sélectionné (Personnes, Entreprises, Opportunités, ou tout objet personnalisé).
**Configuration**: Sélectionnez le type d'objet à surveiller pour les nouveaux enregistrements.
<Note>
* Ce déclencheur est idéal pour les enregistrements créés par CSV, boîte aux lettres et synchronisation de calendrier, ou API.
* **Il n'est pas recommandé pour les enregistrements créés manuellement** : avec ce déclencheur, les flux de travail démarrent dès que l'enregistrement est créé. Puisque 20 UI propose l'enregistrement automatique à la volée (il n'y a pas de mode d'édition, puis une validation pour enregistrer les enregistrements), le workflow sera déclenché avant que l'utilisateur ne saisisse tous les champs.
Pour déclencher ce flux de travail sur des enregistrements créés manuellement, il est recommandé d'utiliser plutôt le déclencheur `Record is created or updated`.
</Note>
## Un enregistrement est mis à jour
Démarre le flux de travail lorsque des modifications sont apportées à un enregistrement existant.
**Configuration**:
* Sélectionnez le type d'objet
* Spécifiez éventuellement quels champs surveiller pour les changements
## Un enregistrement est mis à jour ou créé
Démarre le flux de travail lorsqu'un enregistrement est soit créé soit mis à jour dans un objet sélectionné.
**Pourquoi est-ce important**: Ce déclencheur est particulièrement utile car les enregistrements créés par différentes méthodes se comportent différemment :
* **Importations API/CSV** : Les enregistrements sont créés avec tous les champs remplis immédiatement
* **Création manuelle** : Les enregistrements sont créés d'abord, puis les champs sont ajoutés lors de mises à jour ultérieures
**Configuration**:
* Sélectionnez le type d'objet à surveiller
* Spécifiez éventuellement quels champs surveiller pour les changements
* Le flux de travail se déclenchera à la fois lors de la création initiale et lors de mises à jour ultérieures
## Un enregistrement est supprimé
Démarre le flux de travail lorsqu'un enregistrement est supprimé d'un objet.
**Configuration**: Sélectionnez le type d'objet à surveiller pour les suppressions.
## Déclencheur manuel
Démarre le flux de travail lorsqu'il est déclenché par une action de l'utilisateur. Ce déclencheur est accessible via le menu `Cmd+K` ou via un bouton personnalisé qui s'affichera dans la barre de navigation supérieure après avoir sélectionné un ou plusieurs enregistrements.
<img src="/images/user-guide/workflows/add_to_newsletter_button.png" style={{width:'100%'}} />
**Configuration de disponibilité**:
Choisissez comment le flux de travail doit gérer la sélection des enregistrements :
* **Global** : Aucun enregistrement n'est requis pour déclencher ce flux de travail. Le workflow est déclenché depuis le menu de commande `Cmd+K` n'importe où (depuis n'importe quel objet) et n'utilise pas d'enregistrement(s) en entrée.
Pour une disponibilité **simple** et **en bloc**, le(s) enregistrement(s) sélectionné(s) seront passés à votre flux de travail. Ceci est configuré pour un objet donné, et plusieurs enregistrements peuvent être sélectionnés avant de déclencher le workflow.
* **Single**: Le workflow s'exécutera du début à la fin autant de fois qu'il y a des enregistrements sélectionnés.
<Note>
**Limite souple : 100 exécutions/minute**. Au-delà de cela, les flux de travail restent au statut "Not Started" et sont traités progressivement — soit par une tâche en arrière-plan, soit lorsqu'un autre flux de travail entre dans la file d'attente. Cela signifie que vous pouvez sélectionner plus de 100 enregistrements avec un déclencheur unique ; l'exécution sera simplement plus lente.
</Note>
* **En vrac** : Le workflow s'exécutera une fois, fournissant la liste complète des enregistrements en entrée. Cela signifie que le flux de travail doit contenir une [Action d'itération](/l/fr/user-guide/workflows/capabilities/workflow-actions#iterator).
<Note>
C'est plus avancé, et idéal pour les personnes qui souhaitent optimiser le nombre d'exécutions de flux de travail.
</Note>
<img src="/images/user-guide/workflows/manual_trigger.png" style={{width:'100%'}} />
**Configuration supplémentaire**:
* Sélectionnez l'objet cible (pour disponibilité Unique et en masse)
* Choisissez une icône de commande pour le déclencheur de flux de travail
* Configurez le placement dans la barre de navigation (Épinglé ou Non épinglé)
**Méthodes d'accès**:
* Menu `Cmd+K` pour trouver et lancer des flux de travail manuels
* Bouton personnalisé dans la barre de navigation supérieure (si configuré)
## Déclencheur basé sur le temps : sur un planning
Démarre le flux de travail sur une base récurrente que vous définissez.
**Configuration**:
* Sélectionnez l'unité de temps (minutes, heures, jours)
* Entrez une valeur ou utilisez des expressions cron personnalisées pour une planification avancée
<Note>
**Fuseau horaire** : Les flux de travail planifiés s'exécutent en **UTC**. Lors de la définition des heures pour les plannings quotidiens, convertissez votre heure locale en UTC.
</Note>
## Déclencheur externe : Webhook
Démarre le flux de travail lorsqu'une requête GET ou POST est reçue d'un service externe.
<img src="/images/user-guide/workflows/webhook_trigger.png" style={{width:'100%'}} />
**Configuration**:
* Le flux de travail fournit une URL de webhook unique — copiez-la et ajoutez-la à votre système externe comme point de terminaison à appeler.
* Pour les requêtes POST, définissez la structure attendue du corps afin que Twenty sache quelles données attendre. Ajoutez ici les champs que vous recevrez et qui seront nécessaires plus bas dans votre flux de travail.
* Configurez l'authentification (bientôt disponible).
## Choisir le bon déclencheur
| Cas d'utilisation | Déclencheur recommandé |
| ------------------------------------------------------------ | ---------------------------------------- |
| Les nouveaux prospects doivent être traités | Un enregistrement est créé |
| Les modifications de données nécessitent une synchronisation | Un enregistrement est mis à jour |
| Import/gestion manuelle des données | Un enregistrement est mis à jour ou créé |
| Nettoyage après suppression | Un enregistrement est supprimé |
| Action initiée par l'utilisateur | Lancer manuellement |
| Rapports récurrents | À une heure programmée |
| Intégration externe | Webhook ou sur un planning |

View File

@@ -0,0 +1,84 @@
---
title: Versions de Workflow
description: Gérer les versions et les brouillons de workflows.
---
## À propos des versions
Chaque fois que vous activez un workflow, une nouvelle version est créée. Cela vous permet de suivre les modifications dans le temps et de revenir aux configurations précédentes si nécessaire.
## Statuts des versions
| Statut | Description |
| ------------- | ------------------------------------------------- |
| **Brouillon** | En cours d'édition, pas encore publié |
| **Actif** | Version active répondant aux déclencheurs |
| **Désactivé** | Auparavant actif, mais arrêté manuellement |
| **Archivé** | Versions antérieures conservées pour l'historique |
## Travailler avec des brouillons
Lorsque vous modifiez un workflow actif, vos modifications sont enregistrées en tant que **brouillon**. La version active continue de s'exécuter pendant que vous travaillez sur des mises à jour.
Une fois vos modifications terminées, vous pouvez :
* **Activer** : Publier le brouillon comme nouvelle version active (la version précédente est archivée)
* **Abandonner** : Supprimer le brouillon et conserver la version active actuelle
## Historique des versions
### Afficher les versions précédentes
1. Ouvrez le workflow
2. Cliquez sur l'onglet **Versions**
3. Affichez toutes les versions précédentes avec leurs horodatages
### Restaurer une version
1. Trouvez la version que vous souhaitez restaurer
2. Cliquez sur **Utiliser comme brouillon**
3. La version est copiée dans un nouveau brouillon
4. Effectuez les mises à jour nécessaires
5. Activez lorsque vous êtes prêt
## Meilleures pratiques
### Gestion des versions
* N'activez que lorsque vous êtes prêt pour la mise en production
* Conservez des modifications significatives d'une version à l'autre.
* Documentez les modifications majeures dans les noms ou les descriptions de workflows
* Testez en mode brouillon avant d'activer
### Annulation des modifications
* Si une nouvelle version pose des problèmes, restaurez la version précédente
* Utilisez l'historique des versions pour suivre ce qui a changé
* Testez toujours les versions restaurées avant de les activer
## Workflows courants
### Modification rapide
1. Apportez des modifications mineures à un workflow actif
2. Testez en mode brouillon
3. Activez la nouvelle version
### Révision majeure
1. Utilisez la version précédente comme point de départ
2. Apportez des modifications importantes dans un brouillon
3. Testez minutieusement tous les scénarios
4. Activez lorsque vous êtes confiant
### Retour en arrière
1. Identifiez le problème avec la version actuelle
2. Trouvez la dernière version fonctionnelle dans l'historique
3. Cliquez sur **Utiliser comme brouillon**
4. Activez pour rétablir l'ancien comportement
## Articles connexes
* [Prise en main des workflows](/l/fr/user-guide/workflows/overview)
* [Exécutions de workflows](/l/fr/user-guide/workflows/capabilities/workflow-runs)

View File

@@ -0,0 +1,82 @@
---
title: Gérer les tableaux dans les actions Code
description: Apprenez à gérer correctement les entrées de type tableau dans les actions Code des workflows.
---
Lorsque vous travaillez avec des tableaux dans les actions Code, vous pouvez rencontrer deux difficultés courantes :
1. **Tableaux passés sous forme de chaînes** — les données provenant de systèmes externes ou d'étapes précédentes arrivent sous forme de chaîne plutôt que sous forme de véritable tableau
2. **Impossible de sélectionner des éléments individuellement** — vous ne pouvez sélectionner que le tableau entier, pas des champs spécifiques à l'intérieur
Les deux peuvent être résolus avec un nœud Code.
## Analyse des tableaux à partir de chaînes
Les tableaux sont souvent transmis entre les étapes d'un workflow sous forme de chaînes ou de JSON plutôt que comme tableaux natifs. Cela se produit lorsque :
* Réception de données depuis des API externes via HTTP Request
* Traitement des charges utiles des webhooks
* Transmission de données entre les étapes du workflow
**Solution** : Ajoutez ce modèle au début de votre action Code :
```javascript
export const main = async (params: {
users: any;
}): Promise<object> => {
const { users } = params;
// Handle input that may come as a string or an array
const usersFormatted = typeof users === "string" ? JSON.parse(users) : users;
// Now you can safely work with usersFormatted as an array
return {
users: usersFormatted.map((user) => ({
...user,
activityStatus: String(user.activityStatus).toUpperCase(),
})),
};
};
```
La ligne clé `typeof users === "string" ? JSON.parse(users) : users` vérifie si l'entrée est une chaîne, l'analyse si nécessaire, ou l'utilise directement si c'est déjà un tableau.
## Extraction de champs individuels à partir de tableaux
Un webhook peut renvoyer un tableau comme `answers: [...]`, mais dans les étapes de workflow suivantes vous ne pouvez sélectionner que le tableau entier — pas des éléments individuels à l'intérieur.
**Solution** : Ajoutez un nœud Code pour extraire des champs spécifiques et les renvoyer sous forme d'objet structuré :
```javascript
export const main = async (params: {
answers: any;
}): Promise<object> => {
const { answers } = params;
// Handle input that may come as a string or an array
const answersFormatted = typeof answers === "string"
? JSON.parse(answers)
: answers;
// Extract specific fields from the array
const firstname = answersFormatted[0]?.text || "";
const name = answersFormatted[1]?.text || "";
return {
answer: {
firstname,
name
}
};
};
```
Le nœud Code renvoie un objet structuré au lieu d'un tableau. Dans les étapes suivantes, vous pouvez maintenant sélectionner des champs individuels comme `answer.firstname` et `answer.name` à partir du sélecteur de variables.
<Tip>
**Vous voulez parcourir le tableau au lieu d'extraire des champs ?** Lorsqu'une étape de fonction Code ou Logic renvoie un tableau de premier niveau, vous pouvez l'envoyer directement dans un [Iterator](/l/fr/user-guide/workflows/capabilities/use-iterator) : sélectionnez l'option **Whole list** de l'étape comme entrée de l'Iterator, puis référencez chaque élément avec `{{iterator.currentItem}}` à l'intérieur de la boucle. Dans ce cas, vous n'avez pas besoin de restructurer le tableau en un objet.
</Tip>
<Tip>
Cliquez sur l'icône carrée en haut à droite de l'éditeur de code pour l'afficher en plein écran — utile car la largeur par défaut de l'éditeur est limitée.
</Tip>

Some files were not shown because too many files have changed in this diff Show More