Intégration Google Contacts n8nAutomatiser Google Contacts avec n8n.
Un carnet d'adresses tenu à la main finit toujours par mentir. L'intégration Google Contacts n8n s'appuie sur une seule ressource, Contact, et 5 opérations : créer, lire, lister, mettre à jour, supprimer. Aucun trigger n'existe ici, donc le workflow démarre ailleurs. Utile dès qu'une équipe partage l'annuaire.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert vraiment l'intégration Google Contacts n8n ?
L'intégration Google Contacts n8n, c'est un nœud livré avec n8n qui parle à l'API Google People au nom d'un compte Google précis. Il travaille sur une ressource unique, Contact, et propose 5 opérations : créer une fiche, en lire une par son identifiant, en lister plusieurs avec une recherche, en modifier une, en supprimer une. Le carnet d'adresses arrête d'être ce fichier que quelqu'un met à jour entre deux réunions.
Premier cas, l'entrée en base. Un formulaire remplit un tableur, un workflow lit les nouvelles lignes et crée la fiche correspondante avec le nom, l'email et le téléphone. Avec Google Sheets en porte d'entrée, Google Contacts devient la version propre, celle qui se synchronise sur le téléphone de toute l'équipe.
Deuxième cas, l'annuaire d'équipe. Chaque début de mois, un Schedule Trigger, le nœud n8n qui lance un workflow à intervalle fixe, exécute contact.getAll, trie les fiches par dernière modification et envoie le récapitulatif par Gmail aux personnes concernées. Personne n'a plus besoin d'y penser.
Troisième cas, le ménage. La recherche par préfixe de l'opération getAll sort les fiches qui se ressemblent, le workflow compare, complète l'adresse manquante avec contact.update, et poste la liste des cas douteux dans un canal Slack pour arbitrage humain. Le même enchaînement répare des numéros mal formatés ou réaffecte un groupe.
Quand le nœud s'arrête, le nœud HTTP Request prend le relais. Il appelle n'importe quel endpoint de l'API Google People en réutilisant le même credential via l'authentification prédéfinie, donc tout ce que les 5 opérations n'exposent pas reste faisable. Ce détour n'a rien d'un bricolage, c'est le fonctionnement prévu.
Deux limites à connaître avant de construire. Il n'existe pas de nœud trigger Google Contacts : rien ne surveille le carnet d'adresses, le déclenchement vient toujours d'ailleurs. Et une mise à jour écrit ce que tu lui donnes, d'où le champ Etag relevé lors d'une lecture précédente, qui protège une fiche modifiée entre-temps par quelqu'un d'autre.
Si le choix de la plateforme n'est pas encore fait, l'Avis n8n détaille l'hébergement et le modèle de coût, et la Formation n8n reprend la construction de ce type de workflow depuis une page blanche.
Comment connecter Google Contacts à n8n ?
- 01
Créer le projet Google Cloud et activer l'API
Ouvre la Google Cloud Console et choisis un projet, existant ou tout neuf. Active l'API nécessaire depuis la bibliothèque, puis passe par APIs and Services, puis OAuth consent screen, pour renseigner App name et User support email. Internal si tout reste dans ton Google Workspace, External pour n'importe quel compte Google. Dans Branding, ajoute
n8n.cloudcomme domaine autorisé sur n8n Cloud, ou le domaine de ta propre instance en auto-hébergé. - 02
Générer les identifiants OAuth client
Va dans Credentials, puis Create credentials, puis OAuth client ID. Le type d'application à sélectionner est Web application, avec un nom que tu reconnaîtras plus tard. Copie l'OAuth Redirect URL affichée dans l'écran du credential n8n et colle-la dans Authorized redirect URIs. Sur une instance locale, ni domaine public ni certificat : Google accepte une adresse localhost du type
http://localhost:5678/rest/oauth2-credential/callback. - 03
Terminer le credential dans n8n
Retour dans n8n, menu Credentials, credential Google OAuth2 pour ce service. Colle le Client ID et le Client Secret récupérés dans la console, puis lance la connexion. Sur n8n Cloud, le Managed OAuth2 évite toute la configuration côté Google pour les nœuds Google qui le supportent : un clic sur Sign in with Google suffit, et le menu déroulant bascule sur Custom OAuth2 au besoin. Le credential se crée une fois et réapparaît dans chaque workflow.
Les 5 opérations du nœud Google Contacts
Le nœud Google Contacts expose 5 opérations sur 1 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
Contact
5 opérationsCreate a contact
contact.createCe que tu vois dans n8n
Notes & cas d'usage
Ajoute une fiche dans le compte Google rattaché au credential et renvoie la fiche créée, avec l'identifiant que les autres opérations attendent.
Paramètres clés
- Given Name et Family Name : les deux champs de nom posés directement sur le nœud, alimentés en général depuis l'item entrant avec
{{ $json.givenName }}. - Additional Fields : une collection de 14 champs optionnels où Emails, Phone et Addresses s'ajoutent une entrée à la fois, et où Group Names or IDs range la fiche dans un groupe existant.
Delete a contact
contact.deleteCe que tu vois dans n8n
Notes & cas d'usage
Retire définitivement une personne du carnet d'adresses. Côté Google, rien ne revient en arrière, donc le workflow a intérêt à trancher avant d'appeler le nœud.
Paramètres clés
- Contact ID : l'identifiant requis de la fiche, repris d'une lecture précédente plutôt que saisi, le plus souvent
{{ $json.contactId }}depuis l'item sorti d'une liste.
Get a contact
contact.getCe que tu vois dans n8n
Notes & cas d'usage
Lit une seule personne et ne renvoie que les parties de la fiche demandées.
Paramètres clés
- Contact ID : requis, désigne la fiche à lire.
- Fields : le masque de champs qui restreint la réponse, de
namesouemailAddressesseuls jusqu'à*pour tout ramener. Plusieurs valeurs se cochent ensemble. - RAW Data : activé, l'item garde la forme exacte renvoyée par l'API au lieu de la version simplifiée.
Get many contacts
contact.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les contacts du compte, avec une recherche par début de mot quand tu ne veux qu'une partie du carnet.
Paramètres clés
- Return All : coché, n8n enchaîne les pages de l'API jusqu'au bout de la liste ; décoché, Limit fixe le nombre de fiches ramenées.
- Use Query et Query : la requête compare le début des champs, donc
foo ntrouve la personne foo name, là oùoo nne trouve rien. - Sort Order : classe le résultat par prénom, par nom, ou par date de modification.
Update a contact
contact.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie une fiche existante et n'écrit que les champs que tu renseignes.
Paramètres clés
- Contact ID : requis, pointe la fiche à corriger.
- Update Fields : une collection de 17 champs qui couvre les noms, Emails, Phone, Notes, Birthday et le reste.
- Etag : la valeur relevée sur la fiche lors d'une lecture, qui confirme que personne ne l'a modifiée depuis. L'oublier, c'est laisser deux workflows s'écraser en silence.
Besoin d'aide pour automatiser Google Contacts avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
Google Contacts et n8n : les questions qui suivent
01L'intégration Google Contacts n8n est-elle gratuite ?
02Quel credential faut-il pour Google Contacts dans n8n ?
03Quelles sont les limites du nœud Google Contacts dans n8n ?
04Peut-on réagir en temps réel à un nouveau contact Google Contacts ?
05n8n ou Make pour Google Contacts ?
Reçois nos tips intégration chaque semaine.
Pas de spam. Désinscription à tout moment.
