> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapier

> Notifuse mit Zapier verbinden: Transaktions-E-Mails aus jeder App senden, Zaps bei Kontakt-, Listen- und Segmentereignissen auslösen und Kontakte hinzufügen oder anmelden.

Zapier verbindet Notifuse ohne Code mit Tausenden anderer Anwendungen. Notifuse bietet dafür Trigger und Aktionen:

- **Trigger** starten einen Zap, wenn in Notifuse etwas passiert: Ein Kontakt wird angelegt oder geändert, jemand meldet sich bei einer Liste an oder ab, ein Kontakt kommt in ein Segment oder verlässt es. Notifuse schickt jedes Ereignis sofort an Zapier; Zapier fragt nicht regelmäßig nach.
- **Aktionen** lassen eine andere App in Notifuse handeln. Die wichtigste ist das **Senden**: Ein Zap wählt eine Ihrer Transaktionsbenachrichtigungen, und Notifuse versendet sie mit Ihrer Vorlage, Ihrem Absender und Ihrem E-Mail-Anbieter. Außerdem können Aktionen einen Kontakt anlegen oder aktualisieren oder einen Kontakt bei einer Liste anmelden.

## Bevor Sie beginnen

Sie brauchen einen **API-Schlüssel** und Ihre **API-URL** aus Notifuse. Beides erhalten Sie, wenn Sie Zapier unter **Einstellungen** → **Integrationen** verbinden.

Außerdem brauchen Sie **HTTPS**: Zapier ruft nur Endpunkte auf, die über HTTPS mit einem Zertifikat einer öffentlichen Zertifizierungsstelle erreichbar sind. Eine selbst gehostete Instanz muss aus dem öffentlichen Internet erreichbar sein.

## Schritt 1: Zapier verbinden

Öffnen Sie **Einstellungen** → **Integrationen** in dem Arbeitsbereich, in dem Zapier arbeiten soll. Klicken Sie auf **Integration hinzufügen** und wählen Sie dann **Zapier** unter **Verbundene Apps**. Nur der Inhaber des Arbeitsbereichs kann die Verbindung herstellen.

Das einzige Feld ist eine **Beschriftung**. Sie benennt die Verbindung in Notifuse, sonst hängt nichts von ihr ab. Ein Arbeitsbereich kann mehrere Zapier-Verbindungen haben, also halten Sie in der Beschriftung fest, wofür jede gedacht ist. Der Standardwert „Zapier“ genügt, wenn Sie nur eine brauchen.

Klicken Sie auf **Zapier verbinden**. Notifuse erzeugt einen API-Schlüssel mit genau den Berechtigungen, die diese Integration braucht: Lese- und Schreibrecht für **Transaktional**, **Webhook-Abonnements**, **Kontakte** und **Listen**, dazu Leserecht für **Segmente**. Sie müssen nichts ankreuzen.

Sehen Sie sich **Transaktional** an, bevor Sie verbinden. Damit kann ein Zap senden, aber auch Transaktionsbenachrichtigungen anlegen, bearbeiten und löschen, Vorlagen und Anbieter testen und über die SMTP-Bridge versenden. Ein geleaktes Token könnte über Ihren Anbieter Mails verschicken, auf Ihre Kosten und zulasten Ihrer Absenderreputation. Ihren Nachrichtenverlauf kann es nicht lesen. Wenn eine Zapier-Verbindung nicht senden muss, schränken Sie den Schlüssel ein (siehe _Die Verbindung später verwalten_).

Das Token wird **nur einmal** angezeigt, im Bereich, der das Formular ersetzt. Kopieren Sie es, bevor Sie auf **Fertig** klicken: Kein Bildschirm in Notifuse zeigt es noch einmal an. Im selben Bereich steht auch die **API-URL** für Schritt 2, mit einer Schaltfläche zum Kopieren.

> [!NOTE]
>
> **Notifuse leitet die Adresse des Schlüssels aus Ihrer Beschriftung ab.** Sie hat die Form `zapier-<label>-<random>`: Die Beschriftung wird kleingeschrieben, und alles, was kein Buchstabe, keine Ziffer und kein Unterstrich ist, wird durch einen Bindestrich ersetzt. Haben Sie den Standardwert behalten, lautet sie `zapier-<random>`. Adressen von API-Schlüsseln sind in der gesamten Notifuse-Installation eindeutig, nicht nur pro Arbeitsbereich. Dank des Zufallsteils können zwei Arbeitsbereiche jeweils ein Zapier namens „Marketing“ verbinden, ohne sich in die Quere zu kommen, und Sie müssen nie nach einem freien Namen suchen. Der Verbindungsbereich zeigt die entstandene Adresse an, die Karte der Verbindung später ebenfalls. So ordnen Sie eine Karte ihrer Zeile unter **Einstellungen** → **Team & API-Schlüssel** zu.

> [!NOTE]
>
> **Oder legen Sie den Schlüssel von Hand an** unter **Einstellungen** → **Team & API-Schlüssel** → **Neuer Schlüssel**. Dort vergeben Sie die Berechtigungen selbst (die Tabelle unten zeigt, was Sie ankreuzen müssen). Ein solcher Schlüssel ist ein gewöhnlicher API-Schlüssel ohne zugehörige Verbindung: Unter **Einstellungen** → **Integrationen** erscheint keine Karte, und Sie widerrufen ihn nur, indem Sie seine Zeile unter **Einstellungen** → **Team & API-Schlüssel** entfernen. Geben Sie Zapier einen eigenen Schlüssel, statt einen vorhandenen mitzubenutzen. [Admins und API-Schlüssel](https://www.notifuse.com/de/docs/features/admins-api-keys.md) beschreibt alle Berechtigungen.

### Was der Schlüssel darf

Beim Verbinden von Zapier wird all das automatisch vergeben. Die Tabelle zeigt, worauf das Token in Zapiers Händen zugreifen kann und was Sie ankreuzen, wenn Sie den Schlüssel unter **Einstellungen** → **Team & API-Schlüssel** selbst anlegen oder später einschränken.

| Was Sie nutzen möchten                                                                                                 | Nötige Berechtigungen des Schlüssels                                                                                |
| ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Das Konto verbinden, die Auswahl des Arbeitsbereichs und die Beschriftungen benutzerdefinierter Felder in einer Aktion | Keine: Das kann jeder Schlüssel                                                                                     |
| Jeder Trigger (einen Zap ein- und ausschalten)                                                                         | Lese- und Schreibrecht für **Webhook-Abonnements**                                                                  |
| Die Beispieldaten jedes Triggers (was Zapier Ihnen beim Erstellen eines Zaps zeigt)                                    | Leserecht für **Kontakte**                                                                                          |
| Kontakt-Trigger                                                                                                        | Leserecht für **Kontakte**                                                                                          |
| Listen-Trigger und die Listenauswahl                                                                                   | Leserecht für **Listen** und Leserecht für **Kontakte**                                                             |
| Segment-Trigger und die Segmentauswahl                                                                                 | Leserecht für **Segmente** und Leserecht für **Kontakte**                                                           |
| Die Aktion **Send Transactional Email** und die Auswahl der Benachrichtigung                                           | Lese- **und** Schreibrecht für **Transaktional**                                                                    |
| Beim Senden ausgefüllte Kontaktfelder werden im Kontakt gespeichert                                                    | Schreibrecht für **Kontakte**. Ohne dieses Recht klappt der Versand trotzdem, gespeichert wird aber nur die Adresse |
| CC oder BCC beim Senden                                                                                                | Zusätzlich Leserecht für **Kontakte**, weil der Betreff mit dem Kontakt gerendert wird                              |
| Die Aktion **Create or Update Contact**                                                                                | Schreibrecht für **Kontakte**                                                                                       |
| Die Aktion **Subscribe Contact to List**                                                                               | Lese- **und** Schreibrecht für **Listen**                                                                           |

> [!NOTE]
>
> **Das Leserecht füllt die Auswahllisten, das Schreibrecht führt den Schritt aus.** Jede Auswahl liest die Einträge, aus denen Sie wählen. Mit Schreibrecht allein lässt sich eine Aktion also nicht einrichten. Mit Schreib-, aber ohne Leserecht für **Listen** lässt sich der Schritt **Subscribe Contact to List** nicht speichern: Seine Listenauswahl liefert einen Berechtigungsfehler, und die Liste ist ein Pflichtfeld.
>
> Jeder Trigger braucht Leserecht für **Kontakte**, nicht nur die Kontakt-Trigger: Die Beispieldatensätze, die Zapier beim Erstellen eines Zaps zeigt, stammen aus Ihren Kontakten, egal welchen Trigger Sie gewählt haben. Ein Schlüssel ohne dieses Recht füllt zwar seine Auswahllisten, scheitert aber bei **Test trigger**.

> [!WARNING]
>
> **Schreibrecht für Transaktional, Webhook-Abonnements und Listen reicht weiter, als die Namen vermuten lassen.** Schreibrecht für Transaktional verschickt Mails über Ihren Anbieter und erlaubt außerdem, Ihre Transaktionsbenachrichtigungen zu bearbeiten und zu löschen, Anbieter zu testen und die SMTP-Bridge zu nutzen. Ein Trigger abonniert Ereignisse und lässt deren Inhalte an Zapier liefern. Wer eine Adresse bei einer Liste anmeldet, legt den Datensatz dieses Kontakts an oder überschreibt ihn, und ein Versand an die Adresse tut dasselbe. Schützen Sie diesen Schlüssel wie Ihre Kontaktdatenbank und Ihre Zugangsdaten für den Versand.

## Schritt 2: Ihre API-URL

Das Verbindungsformular von Zapier hat ein Feld **API URL**. Den Wert dafür zeigt der Bereich **Zapier verbinden** an, vor dem Verbinden und danach neben dem Token.

- **Notifuse Cloud**: Das Feld ist bereits mit der Cloud-API `https://v3.notifuse.com` ausgefüllt. Lassen Sie es so.
- **Selbst gehostet**: Fügen Sie die Adresse ein, die der Bereich anzeigt. Es ist die Adresse, unter der Sie die Notifuse-Konsole öffnen, nur Schema und Domain, ohne etwas nach der Domain und ohne abschließenden Schrägstrich. Leeren Sie das Feld nicht: Eine leere API-URL bedeutet Notifuse Cloud, nicht „diese Instanz“.

Ihre Instanz muss aus dem öffentlichen Internet über HTTPS erreichbar sein, mit einem Zertifikat einer öffentlichen Zertifizierungsstelle. Let's Encrypt genügt.

> [!WARNING]
>
> **Reines `http://`, selbstsignierte Zertifikate und interne Zertifizierungsstellen werden nicht unterstützt**, ebenso wenig eine Instanz, die nur aus Ihrem Netzwerk erreichbar ist. Zapier verlangt HTTPS mit einem öffentlich vertrauenswürdigen Zertifikat. Wenn Ihre Instanz hinter einer Firewall steht: Zapier veröffentlicht eine feste Liste ausgehender IP-Adressen für eine Allowlist nur in seinen kostenpflichtigen Tarifen.

## Schritt 3: Ihren Arbeitsbereich verbinden

Erstellen Sie in Zapier einen Zap, suchen Sie nach **Notifuse** und wählen Sie einen Trigger oder eine Aktion. Wenn Zapier Sie auffordert, ein Konto zu verbinden, fügen Sie den API-Schlüssel ein und, falls Sie selbst hosten, Ihre API-URL.

Jeder Trigger und jede Aktion von Notifuse fragt dann in einer Auswahlliste, welcher **Arbeitsbereich** verwendet werden soll.

> [!NOTE]
>
> **Eine Zapier-Verbindung gilt für einen Arbeitsbereich.** Ein Notifuse-API-Schlüssel gehört zu genau einem Arbeitsbereich, deshalb bietet die Auswahlliste nur diesen an und wählt ihn gleich aus. Bei mehreren Arbeitsbereichen verbinden Sie Zapier in jedem unter **Einstellungen** → **Integrationen** und legen für jeden eine eigene Zapier-Verbindung an. Zapier benennt Verbindungen nach Arbeitsbereich und Host, sodass Sie sie leicht unterscheiden können.

## Die Verbindung später verwalten

Die Verbindung erscheint als Karte unter **Einstellungen** → **Integrationen**, mit Ihrer Beschriftung, der Adresse des erzeugten Schlüssels und dem Zeitpunkt der Verbindung. Sie können sie umbenennen oder löschen, mit sehr unterschiedlichen Folgen:

- **Umbenennen** ändert nur die Beschriftung auf der Karte. Der Schlüssel behält die Adresse, unter der er erzeugt wurde. Name und Adresse können danach also voneinander abweichen, deshalb zeigt die Karte beide. In Zapier müssen Sie nichts neu eingeben.
- **Löschen widerruft den Schlüssel.** Jeder Zap, der diesen Schlüssel nutzt, hört auf zu funktionieren, sobald Sie bestätigen. Ein widerrufener Schlüssel lässt sich nicht wiederherstellen, und eine neue Verbindung erzeugt einen neuen Schlüssel, den Sie in Zapier einfügen müssen. Wenn Sie den Arbeitsbereich löschen, werden seine Zapier-Schlüssel genauso widerrufen.

Die Berechtigungen eines Schlüssels ändern Sie unter **Einstellungen** → **Team & API-Schlüssel**. Erweitern oder beschränken Sie den Zapier-Schlüssel dort: Die Änderung gilt ab seiner nächsten Anfrage, und **das Token bleibt gleich**, in Zapier ist also nichts neu einzugeben. Wenn Sie dort die Zeile des Schlüssels entfernen, wird er ebenfalls widerrufen, wie beim Löschen der Karte. Die Karte verweist dann aber auf einen Schlüssel, den es nicht mehr gibt.

## Trigger

| Trigger                            | Wird ausgelöst, wenn                             |
| ---------------------------------- | ------------------------------------------------ |
| **New Contact**                    | ein Kontakt zum Arbeitsbereich hinzukommt        |
| **Updated Contact**                | sich die Daten eines vorhandenen Kontakts ändern |
| **New List Subscriber**            | ein Kontakt aktiver Abonnent einer Liste wird    |
| **Contact Unsubscribed from List** | sich ein Kontakt von einer Liste abmeldet        |
| **Contact Joined Segment**         | ein Kontakt beginnt, auf ein Segment zuzutreffen |
| **Contact Left Segment**           | ein Kontakt nicht mehr auf ein Segment zutrifft  |

Bei Listen- und Segment-Triggern können Sie eine bestimmte Liste oder ein bestimmtes Segment wählen. Tun Sie das: Notifuse schickt Zapier dann nur die Ereignisse dieser Liste oder dieses Segments statt die aller Listen im Arbeitsbereich. Das senkt den Task-Verbrauch Ihres Zaps und die Last auf Ihrer Instanz.

### New List Subscriber erfasst drei Wege

Ein Kontakt kann auf drei Wegen aktiver Abonnent einer Liste werden, und nur der erste ist ein neues Abonnement:

- Er **abonniert** die Liste zum ersten Mal.
- Er **bestätigt** ein Double-Opt-in-Abonnement, das auf Bestätigung wartete.
- Er **meldet sich erneut an**, nachdem er sich abgemeldet hatte, zurückgewiesen wurde oder Spam gemeldet hatte.

**New List Subscriber wird in allen drei Fällen ausgelöst.** Ein zurückkehrender Kontakt erzeugt nie ein Ereignis für eine Erstanmeldung. Ein Zap, der nur auf dieses Ereignis achtet, würde also jeden zurückkehrenden Abonnenten verpassen, ohne einen Fehler zu melden. Jeder Lauf enthält das konkrete Ereignis, sodass Sie in Zapier danach verzweigen und Erstanmeldungen anders behandeln können als Rückkehrer.

### Updated Contact ignoriert Speichern ohne Änderung

**Updated Contact** wird nur ausgelöst, wenn sich die Daten eines Kontakts ändern. Wird ein Kontakt ohne Änderung gespeichert oder berührt ein Hintergrundjob einen Datensatz, entsteht kein Ereignis. Routinemäßige interne Aktualisierungen starten Ihre Zaps also nicht.

### Zapier verwaltet seine Webhook-Abonnements selbst

Wenn Sie einen Notifuse-Zap einschalten, entsteht unter **Einstellungen** → **Webhooks** ein Abonnement, das als von Zapier erstellt gekennzeichnet ist. Schalten Sie den Zap aus, wird es entfernt.

> [!WARNING]
>
> **Löschen Sie ein von Zapier erstelltes Webhook-Abonnement nicht von Hand.** Der zugehörige Zap erhält dann keine Ereignisse mehr und legt das Abonnement nicht von selbst neu an: Sie müssen den Zap in Zapier aus- und wieder einschalten, was auch dann funktioniert, wenn das Abonnement fehlt. Löschen Sie lieber den Zap und lassen Sie ihn selbst aufräumen.

Eine fehlgeschlagene Zustellung wird wiederholt, daher kann ein Zap gelegentlich zweimal für dasselbe Ereignis laufen. Wenn Ihr Zap etwas tut, das nicht doppelt passieren darf, etwa eine Karte belasten oder eine Nachricht senden, fügen Sie einen Zapier-Filter oder einen Schritt zur Deduplizierung hinzu.

## Aktionen

| Aktion                        | Was sie tut                                                                                                       |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Send Transactional Email**  | Sendet eine Ihrer Transaktionsbenachrichtigungen an einen Kontakt und füllt die Variablen der Vorlage aus dem Zap |
| **Create or Update Contact**  | Legt den Kontakt an, wenn die E-Mail-Adresse neu ist, und aktualisiert ihn sonst                                  |
| **Subscribe Contact to List** | Legt den Kontakt an oder aktualisiert ihn **und** meldet ihn in einem Schritt bei den gewählten Listen an         |

Alle drei Aktionen gleichen über die **E-Mail-Adresse** ab. Wenn Sie sie mit derselben Adresse erneut ausführen, wird derselbe Kontakt aktualisiert und kein Duplikat angelegt.

Benutzerdefinierte Kontaktfelder erscheinen in diesen Aktionen unter den Beschriftungen, die Sie ihnen gegeben haben. Benennen Sie sie zuerst unter **Einstellungen** → **Benutzerdefinierte Felder**: Felder ohne Beschriftung werden ausgeblendet. Fehlt ein Feld in Zapier, hat es meist noch keine Beschriftung.

### Beim Senden wählen Sie aus, statt zu schreiben

**Send Transactional Email** enthält nicht die E-Mail selbst. Vorlage, Absender, Tracking und Abmeldung bleiben in Notifuse. Der Zap legt fest, welche Benachrichtigung verschickt wird, wer sie erhält und mit welchen Werten die Vorlage gerendert wird.

Wählen Sie im Schritt eine **Notification** aus der Auswahlliste, ordnen Sie dem Empfänger eine **Email** zu und füllen Sie **Template Data** mit einer Zeile pro `{{ variable }}`, die Ihre Vorlage verwendet. Eine Variable, die Sie nicht liefern, wird ohne Fehler leer gerendert. Kommt eine E-Mail mit einer Lücke an, prüfen Sie also zuerst die Schreibweise dieser Zeile anhand der Vorlage.

Zwei Details zu Template Data:

- **Werte kommen als Text an.** Einen Wert auszugeben funktioniert. Ein Vergleich wie `{% if total > 100 %}` trifft dagegen nicht zu, weil er mit dem Text `"120"` vergleicht, nicht mit der Zahl.
- **`contact` und `notification_center_url` setzt Notifuse**, und sie lassen sich aus dem Zap nicht überschreiben. Zeilen mit diesen Namen werden ignoriert.

Benachrichtigungen ohne E-Mail-Kanal stehen in der Auswahlliste nicht zur Wahl, weil ein Versand nur scheitern könnte.

### Der Versand schreibt auch den Kontakt

Ein Versand legt den Kontakt an, wenn die Adresse neu ist. So können Sie jemandem bei der ersten Bestellung ohne zusätzlichen Schritt schreiben.

**Jedes Kontaktfeld, das Sie ausfüllen, überschreibt den gespeicherten Wert.** Wenn Sie First Name aus einer Quelle zuordnen, die manchmal leer ist, leeren diese Läufe den gespeicherten Vornamen. Ein Feld, das im Zap leer bleibt, lässt den gespeicherten Wert unangetastet; ein zugeordnetes Feld setzt sich durch. Wenn Sie nur senden möchten, füllen Sie nichts außer der E-Mail-Adresse aus.

### Message External ID für alles, was nicht doppelt gesendet werden darf

Zapier wiederholt einen fehlgeschlagenen Schritt, und eine Wiederholung führt die ganze Aktion noch einmal aus. Eine doppelte Versandbenachrichtigung ist ein kleines Ärgernis, ein doppeltes Zurücksetzen des Passworts oder eine doppelte Bestellbestätigung dagegen ein echtes Problem.

Füllen Sie **Message External ID** mit einem stabilen Wert aus dem Trigger, etwa einer Bestellnummer, einer Rechnungs-ID oder der ID des Quelldatensatzes. Ein Versand mit einem Wert, den Notifuse schon kennt, liefert die ursprüngliche Nachricht zurück, statt eine zweite E-Mail zu senden. Bleibt das Feld leer, sendet jeder Lauf.

Der Schritt sagt Ihnen nicht, welcher der beiden Fälle eingetreten ist: Ein deduplizierter und ein neuer Versand sehen in der Zap History gleich aus, beide erfolgreich und mit derselben Nachrichten-ID.

> [!WARNING]
>
> **Das Testen des Schritts sendet eine echte E-Mail.** Die Schaltfläche **Test action** in Zapier sendet wirklich, nicht als Probelauf, genau wie jeder Live-Lauf. Verwenden Sie beim Erstellen des Zaps eine Adresse, die Ihnen gehört.

### Der Abonnementstatus ist nicht immer aktiv

**Subscribe Contact to List** liefert für jede Liste den resultierenden Status zurück. Er ist nicht immer `active`, was wie ein Fehler aussehen kann:

- **Ein Kontakt, der sich früher abgemeldet hat, kommt als `pending` zurück, nicht als `active`**, und erhält die Bestätigungs-E-Mail der Liste. Notifuse erzwingt Double Opt-in für alle, die sich schon einmal abgemeldet haben, unabhängig von den Einstellungen der Liste. Diese Compliance-Regel lässt sich nicht abschalten. Der Zap ist nicht gescheitert: Der Kontakt muss bestätigen, bevor er etwas erhält. Eine Liste ohne Double-Opt-in-Vorlage hat keine Bestätigungs-E-Mail zu versenden, solche Kontakte bleiben also auf Dauer `pending`. Richten Sie eine Vorlage ein, bevor Sie einen Zap zur Reaktivierung auf eine Liste ansetzen.
- **Ein ganz neuer Kontakt wird auch auf einer Double-Opt-in-Liste `active`** und erhält keine Bestätigungs-E-Mail, weil die Anfrage von einem authentifizierten API-Schlüssel kommt und nicht aus einem öffentlichen Anmeldeformular.

> [!WARNING]
>
> Bevor Sie einen Zap zur Lead-Erfassung auf eine Double-Opt-in-Liste ansetzen: Neue Adressen überspringen die Bestätigung. Fügen Sie Personen über Zapier nur mit ihrer Einwilligung zu einer Liste hinzu, wie bei einem Dateiimport.

In drei weiteren Fällen meldet die Aktion Erfolg, ohne einen neuen Abonnenten hinzuzufügen. Sie sehen in der Ausgabe nicht alle gleich aus, was wichtig ist, wenn Sie nach dem Ergebnis filtern:

- **Eine Adresse, die zurückgewiesen wurde oder Spam gemeldet hat, wird nicht erneut angemeldet.** Sie kommt mit ihrem endgültigen Status zurück, `bounced` oder `complained`, den ein Filter-Schritt auf **Status** erkennt.
- **Ein Kontakt, der bereits aktiv auf der Liste steht, bleibt unverändert.** Ein erneuter Lauf des Zaps ändert nichts, und die Mitgliedschaft kommt als `active` zurück.
- **Eine Adresse bei einer Wegwerf-E-Mail-Domain wird stillschweigend verworfen.** Nur in diesem Fall gibt es nichts zu melden: Der Schritt ist erfolgreich, liefert aber **überhaupt keine Mitgliedschaften** und einen leeren **Status**. Weder die Mitgliedschaft noch der Kontakt wird gespeichert.

> [!NOTE]
>
> **Filtern Sie nach dem Wert des Status, nicht danach, ob es einen Status gibt.** _Continue if Status exists_ lässt eine zurückgewiesene Adresse ebenso durch wie eine aktive, da beide einen Status haben, und hält nur den Fall der Wegwerf-Domain auf. Um zu prüfen, ob „der Kontakt jetzt angemeldet ist“, testen Sie, ob **Status** `active` ist, oder ob **Memberships** nicht leer ist, wenn Sie bei mehreren Listen auf einmal anmelden.

## Fehlerbehebung

### Der Verbindungstest schlägt fehl

- Prüfen Sie die API-URL: Sie muss mit `https://` beginnen und darf nach der Domain keinen Pfad haben. Der Verbindungsbereich hat den genauen Wert angezeigt; wenn Sie die Karte erneut öffnen, sehen Sie nur die Beschriftung. Haben Sie den Wert nicht mehr, nehmen Sie Schema und Domain der Adresse, unter der Sie die Notifuse-Konsole öffnen.
- Öffnen Sie `https://your-domain/api/workspaces.list` im Browser. Ein Authentifizierungsfehler ist die erwartete Antwort und beweist, dass die Adresse erreichbar ist. Eine Zeitüberschreitung, ein Verbindungsfehler oder eine Zertifikatswarnung bedeutet, dass auch Zapier sie nicht erreicht.
- Prüfen Sie, ob das Zertifikat von einer öffentlichen Zertifizierungsstelle stammt und nicht selbstsigniert oder intern ist.
- Wurde der Schlüssel in Notifuse widerrufen (durch Löschen der Zapier-Verbindung oder Entfernen seiner Zeile unter **Einstellungen** → **Team & API-Schlüssel**), funktioniert die Verbindung sofort nicht mehr. Zapier meldet einen Authentifizierungsfehler und bietet an, das Konto neu zu verbinden: Verbinden Sie Zapier erneut und fügen Sie das neue Token ein.

### Ein Schritt scheitert mit einem Berechtigungsfehler

Die Meldung nennt die fehlende Berechtigung. Fügen Sie sie dem Schlüssel unter **Einstellungen** → **Team & API-Schlüssel** hinzu. Die Änderung gilt ab der nächsten Anfrage, und das Token bleibt gleich. Verbinden Sie Zapier dafür nicht neu: Eine neue Verbindung erzeugt einen Schlüssel mit denselben Standardrechten, und der Schritt scheitert an derselben Stelle.

Wenn **Send Transactional Email** an **Transaktional** scheitert oder die Auswahl der Benachrichtigung leer ist und einen Berechtigungsfehler meldet, stammt die Verbindung aus der Zeit vor Notifuse 39.1, der Version, die das Senden in die Standardrechte aufgenommen hat. Kreuzen Sie beim Schlüssel unter **Einstellungen** → **Team & API-Schlüssel** Lese- und Schreibrecht für **Transaktional** an. Beim nächsten Lauf funktioniert der Schritt, ohne neue Verbindung und ohne neues Token.

### Ein Zap erhält keine Ereignisse mehr

Öffnen Sie in Notifuse **Einstellungen** → **Webhooks** und sehen Sie sich das Abonnement dieses Zaps an:

- **Ausgeschaltet, mit Angabe eines Grundes.** Notifuse deaktiviert ein Abonnement nach einer langen Reihe fehlgeschlagener Zustellungen automatisch und hält den Grund fest. Schalten Sie es wieder ein, sobald die Ursache behoben ist, oder schalten Sie den Zap in Zapier einfach aus und wieder ein, um es neu anzulegen.
- **Ganz verschwunden.** Jemand hat es von Hand gelöscht, oder der Zap wurde ausgeschaltet. Schalten Sie den Zap aus und wieder ein.

Das Zustellprotokoll jedes Abonnements zeigt jedes gesendete Ereignis, die Antwort von Zapier und die Nutzdaten. So sehen Sie am schnellsten, ob Notifuse überhaupt ein Ereignis gesendet hat.

### Der Trigger-Test findet keine Daten

Zapier sucht für sein Beispiel nach aktuellen passenden Aktivitäten. Hatte eine Liste zuletzt keine neuen Abonnenten oder ein Segment keine neuen Mitglieder, gibt es nichts zu zeigen. Legen Sie einen Testkontakt an, melden Sie ihn bei der Liste an und führen Sie den Test erneut aus.

## Einschränkungen

- **Eine Verbindung gilt für einen Arbeitsbereich.** Mehrere Arbeitsbereiche bedeuten mehrere Verbindungen.
- **Das Löschen eines Kontakts löst keinen Zap aus**, Ereignisse von Kampagnen und Automatisierungen ebenso wenig.
- **Einen Suchschritt gibt es noch nicht**: Einen Kontakt mitten im Zap nachschlagen können Sie nur mit einer Aktion, die schreibt.
- **Benutzerdefinierte Felder brauchen eine Beschriftung**, um in einer Aktion zu erscheinen.
- **Ein Versand kann keine Anhänge enthalten.** Die API nimmt sie an, aber Zapier übergibt einem Schritt nur einen Verweis auf eine Datei, nicht die Datei selbst. Es gibt also nichts anzuhängen.
- **Ein Versand kann keine E-Mail verfassen.** Er versendet eine Benachrichtigung, die Sie in Notifuse eingerichtet haben, und kann keinen eigenen Inhalt mitliefern. Betreff, Vorschautext, Absendername und Antwortadresse können Sie für eine einzelne Nachricht überschreiben.

## Weitere Dokumentation

- [Admins und API-Schlüssel](https://www.notifuse.com/de/docs/features/admins-api-keys.md): was jede Berechtigung erlaubt
- [Webhooks](https://www.notifuse.com/de/docs/features/webhooks.md): die Ereignistypen und Nutzdaten hinter den Triggern
- [Kontakte](https://www.notifuse.com/de/docs/features/contacts.md)
- [Listen](https://www.notifuse.com/de/docs/features/lists.md)
- [Segmente](https://www.notifuse.com/de/docs/features/contacts.md#contact-segmentation-engine)
