Documentation menu

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.

Die MailInApp-App für Zapier

Die offizielle MailInApp-App für Zapier wird gerade von Zapier geprüft und ist noch nicht im App-Verzeichnis gelistet. Sobald sie verfügbar ist, verbinden Sie 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 und Journey 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“.

Diese Seite verlinkt den Eintrag, sobald er online ist. Bis dahin funktioniert alles unten schon heute mit der integrierten Zapier-App Webhooks by Zapier.

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, etwa jede Antwort auf eine bestimmte Umfrage? Dann fügen Sie die Catch-Hook-URL stattdessen in den Projekt-Webhook dieser E-Mail auf ihrer Antwortseite 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.