Dokumentationsmenü

Zapier

Verbinden Sie MailInApp mit den Tausenden Apps auf Zapier: Neue Leads landen in einer Tabelle, gebuchte Termine in Slack, ein gewonnener Deal öffnet einen CRM-Datensatz, oder ein Kontakt wird in MailInApp angelegt, wenn anderswo etwas passiert.

Video auf Englisch

Die MailInApp-App für Zapier

MailInApp ist im App-Verzeichnis von Zapier gelistet: zapier.com/apps/mailinapp/integrations. Sie verbinden sie mit einem API-Schlüssel und wählen Auslöser und Aktionen aus Menüs, ganz ohne URLs zu kopieren:

  • Auslöser: einer pro Konto-Ereignis, darunter New Lead, Lead Turned Hot, Meeting Booked, Deal Stage Changed, Form Submitted, Purchase Completed, Journey Completed und Response Completed.
  • Aktionen: Create or Update Contact, Trigger Journey, Create Deal, Update or Move Deal und Send Transactional Email.
  • Suche: Find Contact, kombiniert mit dem Anlegen als „Find or Create Contact“.

MailInApp mit Zapier verbinden

  1. Gehen Sie in MailInApp zu Entwickler und klicken Sie auf Schlüssel erstellen. Benennen Sie ihn nach der Integration, etwa „Zapier“. Kopieren Sie den Schlüssel, der mit mia_live_ beginnt. Er wird nur einmal angezeigt. Ist Schlüssel erstellen gesperrt, enthält Ihr Tarif noch keine API-Schlüssel. Wie Schlüssel funktionieren, steht unter API-Schlüssel.
  2. Legen Sie in Zapier einen Zap an und wählen Sie MailInApp als Auslöser- oder Aktions-App.
  3. Wenn Zapier Sie bittet, ein Konto zu verbinden, fügen Sie den Schlüssel in das Feld API Key ein.
  4. Wählen Sie einen Auslöser oder eine Aktion. Menüs wie Listen, Journeys, Deals und Pipelines füllen sich aus Ihrem Konto.
  5. Klicken Sie auf Test trigger bzw. Test action und schalten Sie den Zap ein.

Der Schlüssel handelt im Namen Ihres gesamten MailInApp-Kontos, behandeln Sie ihn also wie ein Passwort. Widerrufen Sie ihn unter Entwickler, wird Zapier getrennt und die Auslöser, die er eingerichtet hat, stoppen.

Einen Zap in MailInApp starten

Sie können auch beginnen, ohne MailInApp zu verlassen. Unter Entwickler zeigt die Karte Zapier unterhalb Ihrer API-Schlüssel:

  • fertige Vorlagen für MailInApp, etwa neue Leads in Google Sheets eintragen oder gebuchte Termine in Slack posten;
  • ein Feld, in dem Sie in eigenen Worten beschreiben, was Sie automatisieren möchten, und Zapier schlägt einen Zap vor;
  • eine Möglichkeit, einen Zap von Grund auf zu erstellen;
  • sobald Sie bei Zapier angemeldet sind, Ihre Zaps, die MailInApp nutzen.

Die Zapier-Karte auf der Seite Entwickler mit den Zap-Vorlagen für MailInApp

Wählen Sie eine Vorlage, und Zapier öffnet sich über der Seite. Melden Sie sich bei Zapier an oder legen Sie ein Zapier-Konto an. Dann öffnet sich der Zap-Editor mit der ausgefüllten Vorlage. Wenn er Sie bittet, MailInApp zu verbinden, fügen Sie einen API-Schlüssel ein wie in Schritt 3 oben. Testen Sie den Zap danach und schalten Sie ihn ein.

Alles in der Karte kommt von Zapier: Die Vorlagen, die Anmeldung und der Editor verwenden die Texte von Zapier. MailInApp gibt weder Ihre E-Mail-Adresse noch andere Angaben an Zapier weiter. Sie melden sich selbst bei Zapier an.

Enthält Ihr Tarif keine API-Schlüssel, weist die Karte darauf hin. Sie können die Vorlagen trotzdem ansehen, aber ein Zap lässt sich erst nach einem Upgrade verbinden. Meldet die Karte, dass die Zapier-Vorlagen nicht geladen werden konnten, blockiert sie vielleicht eine Browsererweiterung. Öffnen Sie MailInApp dann über den Link in der Karte direkt auf Zapier.

Ohne die MailInApp-App (fortgeschritten)

Für Zapier mit MailInApp brauchen Sie die App nicht. Die integrierte App Webhooks by Zapier funktioniert mit denselben Ereignissen. Sie ist die richtige Wahl, wenn Sie nur die Interaktionen einer einzigen E-Mail wollen, etwa jede Antwort auf eine bestimmte Umfrage, oder die URLs lieber selbst verwalten.

MailInApp-Ereignisse an einen Zap senden

  1. Legen Sie in Zapier einen Zap mit Webhooks by Zapier als Auslöser und Catch Hook als Ereignis an. Kopieren Sie die URL, die Zapier Ihnen gibt.
  2. Gehen Sie in MailInApp zu Entwickler → Webhooks. Fügen Sie die URL als Endpunkt-URL ein, wählen Sie die Ereignisse für diesen Zap und klicken Sie auf Webhook hinzufügen. Bewahren Sie das Signatur-Secret auf, wenn Sie Signaturen später prüfen möchten.
  3. Klicken Sie beim neuen Webhook auf Test senden und dann in Zapier auf Test trigger. Sie sehen das Beispielereignis mit seinem type und jedem Feld in data, etwa der E-Mail-Adresse des Kontakts oder der Phase des Deals.
  4. Fügen Sie Ihre Aktionsschritte hinzu, ordnen Sie die nötigen Felder zu und schalten Sie den Zap ein.

Jedes Ereignis hat dieselbe Form: eine id, einen type, einen Zeitpunkt createdAt und ein Objekt data. Die Webhook-Seite listet jedes Ereignis und seine Felder. Erhält ein Catch Hook mehrere Ereignistypen, fügen Sie einen Schritt Filter by Zapier auf type hinzu oder legen Sie einen Webhook pro Zap an.

Sie wollen nur die Interaktionen einer einzigen E-Mail? Dann fügen Sie die Catch-Hook-URL stattdessen in den Projekt-Webhook dieser E-Mail unter Insights › Einstellungen ein.

Aus einem Zap heraus in MailInApp handeln

Verwenden Sie eine Aktion Webhooks by Zapier → Custom Request, um die MailInApp-API mit Ihrem API-Schlüssel in einem Header Authorization: Bearer mia_live_… aufzurufen. Zum Beispiel:

  • Einen Kontakt anlegen oder aktualisieren, wenn anderswo ein Formular ausgefüllt wird: POST /api/v1/contacts.
  • Einen Deal anlegen, wenn ein Lead in einem anderen Tool einen Termin bucht: POST /api/v1/deals. Setzen Sie einen Header Idempotency-Key, etwa die Datensatz-ID des anderen Tools, damit eine Zap-Wiederholung keinen zweiten Deal anlegt.
  • Einen Kontakt in eine Journey aufnehmen, deren Auslöser API-Aufruf ist: POST /api/v1/journeys/{id}/trigger.
  • Eine Quittung oder Benachrichtigung senden: POST /api/v1/send mit "type": "transactional". Senden Sie keine Marketing-E-Mails aus einem Zap: Ein Zap kann nicht belegen, dass der Empfänger zugestimmt hat.

Wenn eine Zustellung fehlschlägt

Ein pausierter oder gelöschter Zap oder ein Zapier-Ausfall gilt als fehlgeschlagene Zustellung. MailInApp wiederholt sie automatisch über mehrere Stunden. Das Ereignis selbst wird immer zuerst in MailInApp gespeichert, auf MailInApp-Seite geht also nichts verloren.

Hilfe erhalten

  • Ein Zap funktioniert nicht, etwa ein Schritt mit Fehler oder ein Auslöser, der in Zapier nicht feuert: Hilfe gibt es bei Zapier unter zapier.com/app/get-help. Zapier sieht den Task-Verlauf des Zaps, wir nicht.
  • In MailInApp selbst stimmt etwas nicht, etwa ein Schlüssel, der sich nicht erstellen lässt, ein Webhook mit fehlgeschlagenen Zustellungen oder ein Ereignis, das nie ankommt: Wenden Sie sich an den MailInApp-Support.