Plateformes d'automatisation
Intégration n8n
Le nœud communautaire arteemis pour n8n (n8n-nodes-arteemis) apporte deux nœuds : arteemis Trigger, qui déclenche un workflow sur les événements d'arteemis, et arteemis, qui crée ou met à jour des contacts, les retrouve, les ajoute à des listes, les inscrit dans des campagnes, les déplace dans le pipeline et ouvre des tâches. Il se connecte avec une clé de votre espace arteemis.
Ce qu'elle fait
arteemis Trigger
- Un ou plusieurs événements : New Reply, Contact Status Changed, Lead Entered Campaign, Lead Left Campaign, Message Sent, LinkedIn Invitation Accepted, New Task, Pipeline Stage Changed, Background Job Finished.
- Verify Signature, activé par défaut, vérifie chaque appel avec le secret qu'arteemis renvoie pour le webhook, et répond 401 à tout le reste.
Nœud arteemis
- Contact: Create or Update : rapproché par email, puis par profil LinkedIn ; entreprise, liste et champs personnalisés en option.
- Contact: Find : par email ou URL de profil LinkedIn.
- List: Add Contact.
- Campaign: Enroll Contact.
- Pipeline: Add or Move Contact : l'ajout arrête les séquences en cours du contact.
- Task: Create : un appel ou une tâche.
arteemis n'appelle que des adresses https sur un hôte public : un n8n sur http://localhost ne peut pas recevoir d'événements. Utilisez n8n Cloud, ou un n8n auto-hébergé avec une adresse https publique (WEBHOOK_URL).
Prérequis
- Une instance n8n qui peut installer des nœuds communautaires.
- Une clé d'espace arteemis, créée par un propriétaire ou un administrateur dans Paramètres > MCP & API. Le jeton personnel d'un membre fonctionne aussi pour les actions, avec son propre rôle ; le déclencheur demande une clé d'espace ou le rôle d'administrateur.
- Pour le déclencheur, une adresse https publique pour votre n8n, et un webhook disponible (un espace en compte 50 au plus).
Installation
Installer le nœud
- 1Dans n8n, ouvrez Settings > Community Nodes, choisissez Install et saisissez n8n-nodes-arteemis.
Créer une clé d'espace
- 1Connectez-vous à arteemis et ouvrez Paramètres > MCP & API.
- 2Sous l'API, nommez une clé et choisissez Créer une clé. Copiez-la aussitôt : elle n'est affichée qu'une fois. Elle commence par art_key_.
Connecter dans n8n
- 1Dans n8n, créez un identifiant arteemis API et collez la clé comme API Key. Laissez Base URL sur https://api.arteemis.xyz/api/v1.
- 2Ajoutez arteemis Trigger ou arteemis à un workflow et choisissez cet identifiant. Listes, campagnes et étapes sont proposées dans des menus.
- 3Activez le workflow : le déclencheur enregistre son webhook dans arteemis, et le retire quand le workflow est désactivé.
Données échangées
| Données | Sens | Détails |
|---|---|---|
| Événements | D'arteemis vers n8n | L'identifiant, le type et l'heure de l'événement, le contact (nom, adresse email, profil LinkedIn, poste, entreprise, statut, type de réponse, champs personnalisés) et, selon l'événement, le message, la campagne, l'inscription, la tâche, l'étape ou le traitement. |
| Résultats | D'arteemis vers n8n | Le contact trouvé ou écrit, la liste, l'inscription, l'opportunité ou la tâche. |
| Menus | D'arteemis vers n8n | Noms de vos listes, campagnes et étapes du pipeline. |
| Contacts | De n8n vers arteemis | Créés ou mis à jour par le nœud : nom, email, profil LinkedIn, entreprise, poste, téléphone, champs personnalisés. |
| Listes, campagnes, pipeline, tâches | De n8n vers arteemis | Un contact ajouté à une liste, inscrit dans une campagne, ajouté ou déplacé dans le pipeline ; une tâche ouverte. |
| Webhooks | De n8n vers arteemis | L'adresse du déclencheur, gardée tant que le workflow est actif. |
Déconnexion
- Désactivez le workflow : son webhook est retiré d'arteemis.
- Pour couper tout accès d'un coup, révoquez la clé dans Paramètres > MCP & API : chaque appel fait avec elle est alors refusé.
- arteemis ne garde rien de n8n en dehors des adresses de webhook des déclencheurs actifs.
Dépannage
- Le déclencheur ne reçoit rien
- Votre n8n doit être joignable en https à une adresse publique : renseignez WEBHOOK_URL sur un n8n auto-hébergé. arteemis appelle dans la minute qui suit l'événement.
- Le déclencheur ne s'active pas : il demande le rôle d'administrateur
- L'identifiant contient le jeton personnel d'un membre qui n'est pas administrateur. Utilisez une clé d'espace.
- Le même événement est arrivé deux fois
- Un envoi est retenté pendant environ 21 heures jusqu'à réussir. Servez-vous de l'identifiant de l'événement pour écarter un doublon.
- Les appels répondent 401
- La clé a été révoquée ou mal copiée. Créez-en une nouvelle et mettez à jour l'identifiant.
Support
romain@arteemis.xyz
Une question sur cette intégration, ou quelque chose qui ne fonctionne pas comme décrit ici : écrivez-nous. Vous recevez une réponse sous un jour ouvré, en français ou en anglais.
Envoyer un email