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

# Twenty

> Connectez Twenty Cloud ou un CRM Twenty auto-hébergé à Allo, synchronisez vos personnes et entreprises, et enregistrez chaque appel et SMS en note sur la personne et l'entreprise

Allo enregistre chaque appel en note sur la personne Twenty correspondante et sur son entreprise, et regroupe les SMS échangés avec une personne dans une note par jour. Vos personnes et entreprises Twenty se synchronisent dans Allo toutes les 5 minutes. L'intégration fonctionne avec Twenty Cloud comme avec une instance Twenty auto-hébergée.

## Comment connecter

L'intégration Twenty se connecte avec une clé API Twenty. Pour une instance auto-hébergée, saisissez aussi l'adresse de l'instance dans le même formulaire. La connexion doit être faite par un admin ou un manager Allo.

### Créer votre clé API Twenty

**1. Ouvrir les paramètres développeur**

Dans Twenty, allez dans **Settings** > **Developers** > **API** et cliquez sur **+ Create key**.

**2. Nommer la clé API**

Donnez un nom à la clé API (par exemple **Allo**) et choisissez la durée d'expiration la plus longue proposée par Twenty. Allo arrête de synchroniser quand la clé API expire.

**3. Garder le rôle par défaut**

Laissez la clé API sur le rôle admin par défaut : Allo peut ainsi lire vos personnes et entreprises et écrire des notes.

**4. Copier la clé API**

Copiez la clé API tout de suite. Twenty ne l'affiche qu'une seule fois.

### Connecter dans Allo

Le même formulaire connecte Twenty Cloud et Twenty auto-hébergé : renseignez l'adresse de l'instance uniquement si vous faites tourner votre propre serveur Twenty.

**1. Ouvrir les intégrations**

Allez sur [**web.withallo.com**](https://web.withallo.com), puis dans **Settings** > **Integrations**.

**2. Trouver Twenty**

Trouvez **Twenty** dans la liste et cliquez sur **Connect**.

**3. Coller la clé API**

Collez la clé API copiée depuis Twenty.

**4. Auto-hébergé uniquement : saisir l'adresse de l'instance**

Si votre espace de travail est hébergé par Twenty, sur `app.twenty.com`, laissez **Adresse de l'instance auto-hébergée** vide et passez à l'étape suivante.

Si votre entreprise fait tourner son propre serveur Twenty, saisissez uniquement le nom d'hôte de votre instance, par exemple `crm.votreentreprise.com`. N'ajoutez ni `https://`, ni chemin après l'hôte, ni port.

> [!WARNING]
>
> Allo accède à une instance auto-hébergée par Internet. L'instance doit être publique et répondre en HTTPS sur le port 443. Allo ne peut pas se connecter à `localhost`, à une adresse IP, à un port personnalisé comme `:3000`, ni à une instance accessible uniquement sur un réseau privé ou un VPN. Utilisez une version récente de Twenty.

**5. Enregistrer et connecter**

Cliquez sur **Save & Connect**. Allo importe vos personnes et entreprises Twenty.

## Ce qui est synchronisé

**De Twenty vers Allo :**

* Personnes, avec leur prénom et nom, leur email principal, tous leurs numéros de téléphone (principal et additionnels), leur fonction, le nom et le site web de leur entreprise, et un lien vers la personne dans Twenty
* Entreprises, avec leur nom, leur site web, leur adresse et leur responsable de compte, et un lien vers l'entreprise dans Twenty

Dans Twenty, une personne n'a pas de propriétaire. Allo utilise le **Account owner** de l'entreprise de la personne comme propriétaire du contact.

**D'Allo vers Twenty :**

* Appels et SMS, enregistrés en notes sur la personne correspondante et sur son entreprise
* Nouvelles personnes, uniquement lorsque **Create lead for unknown calls** est activé. Allo crée la personne avec le nom, l'email, le numéro de téléphone et la fonction connus dans Allo.

Sur une personne existante, Allo remplit uniquement les champs vides et ajoute les emails et numéros que la personne n'a pas encore. Allo n'écrase jamais ce qui est déjà renseigné dans Twenty.

Les personnes et entreprises se synchronisent toutes les 5 minutes, en ne reprenant que les fiches modifiées. Les opportunités ne sont pas synchronisées. Supprimer une personne ou une entreprise dans Twenty ne la retire pas d'Allo. Les personnes sans numéro de téléphone ne sont pas synchronisées dans Allo.

Lors d'un appel entrant ou sortant, Allo retrouve la personne Twenty à partir de n'importe lequel de ses numéros, principal ou additionnel.

## Comment les appels sont synchronisés

Après chaque appel, Allo crée une **Note** dans Twenty, rattachée à la personne correspondante et à son entreprise s'il y en a une. La note apparaît dans l'onglet **Notes** et dans la timeline des deux fiches. Elle est datée du moment de l'appel, et non du moment où Allo l'a envoyée.

Le titre de la note indique le sens de l'appel, son résultat, l'utilisateur Allo et la durée, par exemple `Allo Appel Sortant - Répondu - Jean Dupont (5:12)`. La note contient :

* Qui a appelé qui, et sur quelle ligne Allo
* La durée de l'appel
* Les tags de l'appel
* Le résumé de l'appel
* Un lien **Listen in Allo** vers l'appel dans Allo

La transcription de l'appel n'est pas ajoutée à la note.

Si vous modifiez le résumé, les tags ou le résultat d'un appel dans Allo, Allo met à jour la même note dans Twenty.

Twenty affiche la clé API comme auteur de la note, car Twenty ne permet pas à une intégration de choisir l'auteur. Le nom de l'utilisateur Allo figure dans le titre de la note.

## Comment les SMS sont synchronisés

Allo regroupe les SMS dans une note par personne et par jour, intitulée par exemple `Message texte - Jean Testeur - 9 nov. 2026`. Chaque message est ajouté à la note du jour avec son heure, son sens et l'utilisateur Allo. La note est rattachée à la personne et à son entreprise.

## Click-to-call

Cliquez sur n'importe quel numéro de téléphone dans Twenty pour lancer l'appel directement dans l'application Allo. L'application Allo doit être installée sur votre appareil.

## Troubleshooting

Vérifiez le statut de synchronisation de n'importe quel appel depuis la **liste des appels sur [web.withallo.com](https://web.withallo.com)**. Chaque appel affiche un indicateur d'intégration avec son état de synchronisation.

> [accordion] Je ne peux pas connecter mon intégration
>
> Seuls les **admins** et **managers** d'un espace de travail Allo peuvent connecter des intégrations. Si vous ne voyez pas l'option, demandez à l'admin ou au manager de votre espace de travail de la configurer.
>
> Côté Twenty, vérifiez ces points :
>
> * **Clé API** : collez la clé API en entier, et vérifiez dans Twenty qu'elle n'a pas expiré ou n'a pas été supprimée.
> * **Format d'adresse incorrect (auto-hébergé)** : saisissez uniquement l'hôte, comme `crm.votreentreprise.fr`. Retirez `https://`, tout chemin comme `/settings` et tout port comme `:3000`.
> * **Instance injoignable (auto-hébergé)** : l'instance doit être publique et répondre en HTTPS sur le port 443. Vérifiez que votre pare-feu laisse passer la plateforme d'intégration d'Allo. Une adresse IP, `localhost` ou une instance derrière un VPN ne peuvent pas se connecter.
> * **Ancienne version de Twenty (auto-hébergé)** : mettez votre instance à jour vers une version récente de Twenty, puis reconnectez-vous.

> [accordion] Appel non synchronisé avec mon intégration
>
> Vérifiez l'indicateur d'intégration sur l'appel dans l'application web. L'erreur sera l'une des suivantes :
>
> * **Contact introuvable** : le contact n'existe pas dans votre CRM. Par défaut, Allo ne synchronise les appels qu'avec des contacts existants. Pour créer automatiquement les contacts, allez dans les paramètres de votre intégration et activez **Create lead for unknown calls**.
> * **Contact supprimé** : le contact a été supprimé de votre CRM. Allo est additif et ne synchronise pas les appels des contacts supprimés. Recréez le contact dans votre CRM, puis relancez la synchronisation.
> * **Intégration déconnectée** : la clé API Twenty a expiré ou a été supprimée. Allo apparaît toujours connecté mais les requêtes échouent. Créez une nouvelle clé API dans Twenty, puis déconnectez et reconnectez l'intégration dans Allo avec cette nouvelle clé.
> * **Appel en attente (icône de chargement)** : Allo est encore en train de faire correspondre le contact. Cela peut prendre jusqu'à 24 heures avant d'être marqué comme une erreur. Une fois le contact présent dans votre CRM, vous pouvez relancer manuellement.
> * **Contact favori** : par défaut, les appels avec un contact favori ne sont pas synchronisés avec votre CRM. Retirez le contact de vos favoris si vous voulez que ces appels soient synchronisés.

> [accordion] Les contacts ne se synchronisent pas
>
> La première synchronisation peut prendre jusqu'à **15 minutes** pour les grandes bases de contacts. Ensuite, les personnes et les entreprises se synchronisent de manière incrémentale toutes les **5 minutes**, pas en temps réel.
>
> Twenty limite le nombre de requêtes d'une intégration : 50 requêtes par minute avec le plan Pro de Twenty Cloud, 100 avec le plan Organization. Sur un gros espace de travail, la première synchronisation attend cette limite et réessaie, ce qui peut ajouter quelques minutes.
>
> Allo ne synchronise que les personnes ayant au moins un numéro de téléphone. Les personnes sans numéro de téléphone n'apparaîtront pas dans Allo.
>
> Si les contacts n'apparaissent toujours pas après 15 minutes, déconnectez et reconnectez l'intégration.

> [accordion] SMS non synchronisés
>
> Les SMS sont ajoutés à une note par personne et par jour. Cherchez sur la personne, dans Twenty, la note `Message texte` datée du jour du SMS.
>
> Si la note est absente, vérifiez que l'intégration est connectée dans **Settings** > **Integrations** et consultez l'indicateur d'intégration dans la liste des appels sur [web.withallo.com](https://web.withallo.com) pour le détail de l'erreur. Si les SMS n'apparaissent toujours pas, déconnectez et reconnectez l'intégration.

> [accordion] Contacts en double
>
> Allo reflète exactement votre intégration. Si votre CRM contient des contacts en double avec le même numéro de téléphone, ils apparaissent comme des contacts distincts dans Allo.
>
> Nettoyez les doublons dans votre CRM. Allo reflétera le changement lors de la prochaine synchronisation.

> [accordion] Appel synchronisé avec le mauvais contact
>
> Lorsque plusieurs contacts partagent le même numéro de téléphone, Allo enregistre l'appel sur le premier contact correspondant. Avant de signaler une synchronisation manquante, vérifiez tous les contacts qui partagent ce numéro : l'appel est peut-être déjà synchronisé avec un autre. Cliquez sur l'indicateur d'intégration de n'importe quel appel dans l'application web pour voir exactement avec quel contact il a été synchronisé.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.