Intégration n8n

n8n est un outil d’automatisation de workflows que vous pouvez utiliser sur n8n Cloud ou héberger vous-même. Le connecter à Personyze vous permet de construire des workflows sur votre compte — synchronisation des contacts, des segments, des achats et des prospects capturés — avec la possibilité de tout garder dans votre propre infrastructure.

Personyze ne propose pas d’application n8n dédiée — la connexion passe par le module de requête HTTP générique de n8n et une clé API Personyze. C’est moins de travail qu’il n’y paraît : chaque endpoint Personyze est un simple appel HTTPS avec authentification Basic, et une seule connexion configurée vous donne donc accès à toute l’API.

Dans le panneau : Paramètres › Intégrations › n8n.

Obtenir une clé

1. Ouvrez Paramètres › Intégrations et cliquez sur Configurer sur la carte n8n.
2. Cliquez sur Générer une nouvelle clé et conservez la valeur.
3. Gardez-la en lieu sûr — toute personne qui détient une clé peut agir au nom de votre compte. Révoquer une clé ici arrête immédiatement tout ce qui l’utilise encore.

Ce sont les mêmes clés que celles de l’API complète et de Zapier. Une clé générée sur l’une de ces cartes apparaît sur toutes et authentifie n’importe quel endpoint. Il reste utile de générer une clé distincte par automatisation, afin de pouvoir en révoquer une sans casser les autres.

Se connecter dans n8n

Ajoutez un nœud HTTP Request et créez un identifiant Basic Auth :

• Authentification : Basic auth
• Nom d’utilisateur : api
• Mot de passe : la clé que vous avez générée
• URL de base : https://app.personyze.com/rest/

Certains outils préfèrent des identifiants intégrés à l’URL, ce qui fonctionne aussi :

https://api:YOUR_API_KEY@app.personyze.com/rest/users/where/email=john@example.com

Enregistrez-le comme identifiant réutilisable dans n8n pour que chaque nœud HTTP Request du workflow puisse le sélectionner, au lieu de saisir la clé dans chaque nœud.

Remarque sur l’auto-hébergement. Personyze n’a pas besoin d’atteindre votre instance n8n pour ces appels — c’est votre workflow qui appelle Personyze : un n8n auto-hébergé derrière un pare-feu fonctionne donc sans aucun accès entrant. Cela ne change que si vous ajoutez plus tard un webhook Personyze pointant vers n8n, qui nécessite une URL joignable.

Ce que vous pouvez appeler

Tout ce que propose l’API REST. Les schémas d’automatisation courants :

• Envoyer un contact dans Personyze — POST /rest/users avec un email. Renvoyer le même e-mail fusionne au lieu de créer un doublon : un workflow exécuté à répétition reste donc sûr.
• Ajouter une personne à un segment — POST /rest/user_list_users avec user_list_id et user_email.
• Signaler un achat — POST /rest/products_interactions.
• Récupérer les prospects capturés — GET /rest/forms, en paginant sur time.
• Récupérer les résultats des campagnes — GET /rest/summary_actions.

Référence complète : présentation de l’API REST, paramètres de chemin, et erreurs, limites et nouvelles tentatives. Le guide d’intégration couvre les comportements à connaître avant de construire une boucle de synchronisation.

Deux pièges à éviter

• Identifiez vos utilisateurs par email. C’est l’identifiant qui correspond à un profil existant. Un workflow fondé sur votre propre internal_id crée un nouvel utilisateur à chaque exécution.
• Les réponses d’erreur sont en texte brut, pas en JSON. Un module configuré pour analyser chaque réponse comme du JSON plantera sur l’erreur et masquera le vrai message. Vérifiez le code de statut : 400 signifie que la requête est incorrecte et qu’une nouvelle tentative n’y changera rien, 503 mérite une nouvelle tentative avec un délai progressif.

Voir aussi

• Intégration Make
• Intégration Zapier
• API complète