Passer au contenu principal
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, 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.
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. Chaque appel affiche un indicateur d’intégration avec son état de synchronisation.
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.
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.
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.
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 pour le détail de l’erreur. Si les SMS n’apparaissent toujours pas, déconnectez et reconnectez l’intégration.
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.
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é.