Automatisierungsplattformen
n8n-Integration
Der arteemis-Community-Node für n8n (n8n-nodes-arteemis) bringt zwei Nodes mit: arteemis Trigger, der bei arteemis-Ereignissen einen Workflow startet, und arteemis, der Kontakte erstellt oder aktualisiert, sie findet, zu Listen hinzufügt, in Kampagnen aufnimmt, in der Pipeline verschiebt und Aufgaben anlegt. Er verbindet sich mit einem Schlüssel Ihres arteemis-Workspaces.
Was sie leistet
arteemis Trigger
- Ein oder mehrere Ereignisse: 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, standardmäßig aktiviert, prüft jeden Aufruf anhand des Secrets, das arteemis für den Webhook zurückgibt, und antwortet auf alles andere mit 401.
arteemis-Node
- Contact: Create or Update: Abgleich über die E-Mail-Adresse, dann über das LinkedIn-Profil; Unternehmen, Liste und benutzerdefinierte Felder optional.
- Contact: Find: nach E-Mail-Adresse oder LinkedIn-Profil-URL.
- List: Add Contact.
- Campaign: Enroll Contact.
- Pipeline: Add or Move Contact: Das Hinzufügen beendet die laufenden Sequenzen des Kontakts.
- Task: Create: ein Anruf oder ein To-do.
arteemis ruft nur https-Adressen auf einem öffentlichen Host auf: Ein n8n unter http://localhost kann keine Ereignisse empfangen. Verwenden Sie n8n Cloud oder ein selbst gehostetes n8n mit einer öffentlichen https-Adresse (WEBHOOK_URL).
Voraussetzungen
- Eine n8n-Instanz, die Community-Nodes installieren kann.
- Ein Workspace-Schlüssel von arteemis, erstellt von einem Inhaber oder Admin unter Einstellungen > MCP & API. Das persönliche Token eines Mitglieds funktioniert für die Aktionen ebenfalls, mit dessen eigener Rolle; der Trigger erfordert einen Workspace-Schlüssel oder die Admin-Rolle.
- Für den Trigger eine öffentliche https-Adresse für Ihr n8n und ein freier Webhook-Slot (ein Workspace fasst 50).
Einrichtung
Node installieren
- 1Öffnen Sie in n8n Settings > Community Nodes, wählen Sie Install und geben Sie n8n-nodes-arteemis ein.
Workspace-Schlüssel erstellen
- 1Melden Sie sich bei arteemis an und öffnen Sie Einstellungen > MCP & API.
- 2Benennen Sie unter API einen Schlüssel und wählen Sie Schlüssel erstellen. Kopieren Sie ihn sofort: Er wird nur einmal angezeigt. Er beginnt mit art_key_.
In n8n verbinden
- 1Legen Sie in n8n Zugangsdaten vom Typ arteemis API an und fügen Sie den Schlüssel als API Key ein. Belassen Sie Base URL bei https://api.arteemis.xyz/api/v1.
- 2Fügen Sie einem Workflow arteemis Trigger oder arteemis hinzu und wählen Sie diese Zugangsdaten. Listen, Kampagnen und Phasen stehen in Auswahlmenüs zur Wahl.
- 3Aktivieren Sie den Workflow: Der Trigger registriert seinen Webhook in arteemis und entfernt ihn, wenn der Workflow deaktiviert wird.
Ausgetauschte Daten
| Daten | Richtung | Details |
|---|---|---|
| Ereignisse | Von arteemis zu n8n | ID, Typ und Zeitpunkt des Ereignisses, der Kontakt (Name, E-Mail-Adresse, LinkedIn-Profil, Position, Unternehmen, Status, Art der Antwort, benutzerdefinierte Felder) und, je nach Ereignis, die Nachricht, die Kampagne, die Aufnahme in die Kampagne, die Aufgabe, die Phase oder der Job. |
| Ergebnisse | Von arteemis zu n8n | Der gefundene oder geschriebene Kontakt, die Liste, die Aufnahme, der Deal oder die Aufgabe. |
| Auswahlmenüs | Von arteemis zu n8n | Namen Ihrer Listen, Kampagnen und Pipeline-Phasen. |
| Kontakte | Von n8n zu arteemis | Vom Node erstellt oder aktualisiert: Name, E-Mail, LinkedIn-Profil, Unternehmen, Position, Telefon, benutzerdefinierte Felder. |
| Listen, Kampagnen, Pipeline, Aufgaben | Von n8n zu arteemis | Ein Kontakt wird einer Liste hinzugefügt, in eine Kampagne aufgenommen, in die Pipeline aufgenommen oder darin verschoben; eine Aufgabe wird angelegt. |
| Webhooks | Von n8n zu arteemis | Die Adresse des Triggers; sie wird gespeichert, solange der Workflow aktiv ist. |
Trennen
- Deaktivieren Sie den Workflow: Sein Webhook wird aus arteemis entfernt.
- Um jeden Zugriff auf einmal zu beenden, widerrufen Sie den Schlüssel unter Einstellungen > MCP & API: Jeder Aufruf damit wird dann abgelehnt.
- arteemis speichert von n8n nichts außer den Webhook-Adressen der aktiven Trigger.
Fehlerbehebung
- Der Trigger empfängt nichts
- Ihr n8n muss per https unter einer öffentlichen Adresse erreichbar sein: Setzen Sie bei einem selbst gehosteten n8n WEBHOOK_URL. arteemis ruft innerhalb einer Minute nach dem Ereignis auf.
- Der Trigger lässt sich nicht aktivieren: Er erfordert die Admin-Rolle
- Die Zugangsdaten enthalten das persönliche Token eines Mitglieds, das kein Admin ist. Verwenden Sie einen Workspace-Schlüssel.
- Dasselbe Ereignis kam zweimal an
- Eine Zustellung wird etwa 21 Stunden lang wiederholt, bis sie gelingt. Nutzen Sie die ID des Ereignisses, um eine Wiederholung zu überspringen.
- Aufrufe antworten mit 401
- Der Schlüssel wurde widerrufen oder falsch eingegeben. Erstellen Sie einen neuen und aktualisieren Sie die Zugangsdaten.
Support
romain@arteemis.xyz
Eine Frage zu dieser Integration oder etwas, das nicht wie hier beschrieben funktioniert: Schreiben Sie uns. Sie erhalten innerhalb eines Werktags eine Antwort, auf Französisch oder Englisch.
E-Mail senden