Documentation menu

n8n

Die MailInApp-Nodes für n8n starten Workflows, wenn in MailInApp etwas passiert, und lassen Workflows Kontakte hinzufügen, Deals verschieben, Kontakte in Journeys aufnehmen und transaktionale E-Mails senden. Sie sind auf npm als n8n-nodes-mailinapp veröffentlicht.

Installieren

Gehen Sie in n8n zu Settings → Community Nodes → Install und geben Sie n8n-nodes-mailinapp ein. Details stehen in n8ns Anleitung zu Community Nodes.

Auf selbst gehostetem n8n können Sie das Paket jetzt installieren. n8n Cloud bietet nur Community Nodes an, die n8n verifiziert hat, und dieses Paket ist noch nicht verifiziert. Es erfüllt n8ns Verifizierungsregeln, die Unterstützung in der Cloud folgt also, sobald n8n es freigibt.

Ihr Konto verbinden

  1. Gehen Sie in MailInApp zu Entwickler und erstellen Sie einen API-Schlüssel. Er beginnt mit mia_live_ und wird nur einmal angezeigt.
  2. Legen Sie in n8n eine Anmeldeinformation MailInApp API an und fügen Sie den Schlüssel ein. Lassen Sie Base URL auf https://mailinapp.com.

Der Schlüssel handelt für Ihr gesamtes MailInApp-Konto, behandeln Sie ihn also wie ein Passwort. Wenn Sie ihn in MailInApp widerrufen, werden auch alle damit eingerichteten Auslöser abgeschaltet.

Der Node MailInApp Trigger

Wählen Sie ein oder mehrere Ereignisse. Beim Aktivieren des Workflows abonniert der Node sie in MailInApp. Beim Deaktivieren wird das Abonnement entfernt. Sie sehen diese Abonnements unter Entwickler → Webhooks, markiert mit n8n.

Die Ereignisse sind die zwölf Konto-Ereignisse: Interaction Received, Form Submitted, Contact Created, Contact Updated, Lead Turned Hot, New Lead, Meeting Booked, Meeting Cancelled, Deal Created, Deal Stage Changed, Purchase Completed und Journey Completed.

Jeder Lauf erhält das Ereignis so, wie MailInApp es gesendet hat, mit id, type, createdAt und data. Die id ist bei jeder Zustellung desselben Ereignisses gleich, damit können Sie Duplikate überspringen. Jede Zustellung ist signiert. Der Node weist jede Anfrage ohne gültige Signatur oder mit einem Zeitstempel, der älter als 5 Minuten ist, ab: Die Webhook-URL zu kennen reicht nicht, um Ihren Workflow zu starten.

Der Node MailInApp

RessourceOperationen
ContactCreate or Update einer Adresse in einer Kontaktliste. MailInApp prüft sie beim Speichern. Get liefert den Kontakt der Adresse in jeder Liste oder in einer.
Contacts ListGet Many Listen mit ihren Feldern und Kontaktzahlen.
DealCreate einen Deal für einen Kontakt, per E-Mail-Adresse. Setzen Sie einen Idempotency Key (etwa eine Bestellnummer), damit ein wiederholter Lauf keinen zweiten Deal anlegt. Update einen Deal: in eine andere Phase verschieben, gewonnen und verloren eingeschlossen, oder Titel, Wert oder Währung ändern.
EmailSend Transactional: eigener Betreff und HTML oder Text, oder ein Studio-Projekt mit Merge-Daten. Ein fehlgeschlagener Versand ist ein Fehler. Ein Ergebnis suppressed (die Adresse ist gebounct oder ungültig) ist ein normales Ergebnis, auf das Sie verzweigen können.
JourneyEnroll Contact in eine Journey mit dem Auslöser API-Aufruf, und Get Many Journeys.
PipelineGet Many Pipelines mit ihren Phasen.

Auswahllisten zeigen Ihre Listen, Listenfelder, Journeys, Pipelines und Phasen. Der Node unterstützt n8ns Continue On Fail.

Marketing-E-Mails werden nicht angeboten: Ein Workflow kann nicht belegen, dass der Empfänger zugestimmt hat. Senden Sie Marketing aus MailInApp oder nehmen Sie den Kontakt in eine Journey auf.

Mit einem KI-Agenten

Der Node MailInApp lässt sich als Tool von n8ns AI Agent nutzen. Für eine größere Werkzeugauswahl verbinden Sie den Agenten zusätzlich über einen Node MCP Client Tool mit dem MCP-Server von MailInApp: Endpunkt https://mailinapp.com/api/mcp, mit Ihrem API-Schlüssel als Bearer-Anmeldeinformation.

Das Paket enthält einen fertigen Beispiel-Workflow (examples/ai-agent-mcp.workflow.json im Paket). Sein Agent kann Kontakte, Ergebnisse, Formularantworten, Segmente und Journeys lesen und neue Journeys entwerfen, hat aber kein Tool, das E-Mails sendet. Von einem Agenten gebaute Journeys werden immer ausgeschaltet gespeichert, damit ein Mensch sie prüft und einschaltet.

Ohne die Nodes

Jeder n8n-Workflow kann MailInApp auch über den generischen Auslöser Webhook nutzen, gespeist von einem Webhook, den Sie unter Entwickler → Webhooks anlegen, und über den Node HTTP Request, der die API aufruft.