Interaktive Transaktions-E-Mails über die Send-API

Belege und Bestätigungen sind die E-Mails, die Kunden am häufigsten öffnen. Gestalten Sie sie einmal im Studio, senden Sie sie über die Send-API aus Ihrem Backend, und jeder Beleg kann fragen, wie die Bestellung war, und das nächste Produkt anbieten.

Betreff

Your order receipt

Belege und Bestätigungen sind die E-Mails, die Kunden am häufigsten öffnen. Senden Sie sie über die Send-API aus Ihrem Backend, mit denselben interaktiven Blöcken wie Ihre Kampagnen, und jeder Beleg kann fragen, wie die Bestellung war, und das nächste Produkt anbieten.

Ein Beleg erreicht fast jeden Kunden, direkt nach dem Kauf. Das macht ihn zum besten Ort für eine schnelle Bewertung, eine Nachfüllung oder einen Code fürs nächste Mal, solange er so leicht zu senden ist wie ein schlichter.

Einmal gestalten, aus Ihrem Backend senden

Bauen Sie den Beleg als normale E-Mail im Studio, mit Merge-Tags wie {{order_number}} und den Blöcken, die Sie wollen:

  • Skalenfrage: „Wie war Ihre Bestellung?“ mit Sternen oder Emoji-Gesichtern. Mit Nachfrage stellen, wenn die Bewertung höchstens ist öffnet eine niedrige Bewertung eine kurze Frage, was schiefging.
  • Produkt: ein passender Artikel oder eine Nachfüllung, aus dem Beleg gekauft mit Jetzt kaufen.
  • Gutschein: ein Code für die nächste Bestellung, mit einem Tippen kopiert.
  • Button: Bestellstatus, Rechnung oder Support.

Dann ruft Ihr Backend POST /api/v1/send mit der projectId der E-Mail und einem mergeData-Objekt mit den Werten dieser Bestellung auf, bis zu 100 Felder. Siehe Vorlage in der API-Referenz.

Jeder Kunde kann aus dem Beleg bewerten, kaufen und klicken, egal in welcher App er ihn liest.

Mit Ihren Kontakten verknüpft

Ist der Kunde schon einer Ihrer Kontakte, wird der Beleg mit ihm verknüpft: Geben Sie eine listId an, oder lassen Sie MailInApp die Adresse in Ihren Listen finden. Seine Bewertung landet dann in seiner Aktivität und seinem Engagement-Score, kann ein Kontaktfeld füllen und eine Journey starten, und eine Terminbuchung bucht mit einem Klick. Siehe die API-Referenz.

Gebaut für den Betrieb

  • type: "transactional", der Standard, erreicht auch Kunden, die sich vom Marketing abgemeldet haben, denn ihren Beleg brauchen sie trotzdem. Adressen mit Bounce werden übersprungen. Siehe Transaktional vs. Marketing.
  • Idempotency-Key: Ein wiederholter Aufruf mit demselben Schlüssel gibt das erste Ergebnis zurück, also bekommt jeder Kunde einen Beleg. Siehe Idempotenz.
  • Limits: Jeder API-Schlüssel hat ein Limit pro Minute, und Ihr Tarif enthält eine monatliche Zahl an Send-API-Aufrufen. Die letzten Aufrufe stehen auf der Seite Entwickler.
  • Ohne Code: Die Aktion Send Transactional Email in Zapier und der n8n-Node senden auf dieselbe Weise.
  • Ein Einmalcode: Senden Sie html oder text statt einer projectId, und die Nachricht geht genau so raus.

Was zurückkommt

Bewertungen, Klicks und Käufe erscheinen in den Insights der E-Mail wie bei jeder Kampagne, und Ihr Webhook übermittelt jedes Ereignis an Ihre Systeme, sobald es eintrifft. Eine Niedrigwert-Benachrichtigung meldet Ihnen, wenn ein Kunde eine Bestellung schlecht bewertet, damit sich noch am selben Tag jemand meldet.

Erste Schritte

Bauen Sie den Beleg im Studio mit einer Skalenfrage, erstellen Sie unter Entwickler einen API-Schlüssel und rufen Sie POST /api/v1/send mit Ihrer projectId und mergeData auf. Der Schnellstart führt durch den ersten Aufruf.

Ein typischer Ablauf zum Erstellen und Versenden

  1. 1

    Den Beleg im Studio gestalten

    Bauen Sie ihn als normale E-Mail mit einer Skalenfrage, einem Produkt oder einem Gutschein und Merge-Tags wie {{order_number}}.

  2. 2

    Einen API-Schlüssel erstellen

    Legen Sie unter Entwickler einen benannten API-Schlüssel an. Jeder Aufruf sendet ihn als Bearer-Token.

  3. 3

    Die Send-API aufrufen

    Ihr Backend sendet einen POST an /api/v1/send mit der projectId der E-Mail und einem mergeData-Objekt mit den Werten dieser Bestellung.

  4. 4

    Lesen, was zurückkommt

    Bewertungen, Klicks und Käufe erscheinen in den Insights der E-Mail, und Ihr Webhook übermittelt jedes Ereignis, sobald es eintrifft.

Häufig gestellte Fragen

Kann eine per API gesendete E-Mail dieselben interaktiven Blöcke tragen wie eine Kampagne?

Ja. Der Vorlagenmodus rendert die genannte Studio-E-Mail mit jedem Block, genau wie ein Versand aus dem Dashboard.

Wie kommen die Daten der Bestellung in die E-Mail?

Über mergeData: ein flaches Objekt mit bis zu 100 Feldern, das die {{field}}-Merge-Tags der E-Mail für diesen einen Aufruf füllt. Geben Sie zusätzlich eine listId an, und wenn der Kunde schon ein Kontakt ist, wird die E-Mail mit ihm verknüpft, sodass seine Bewertung in seiner Aktivität landet.

Was ist der Unterschied zwischen transaktional und Marketing?

Das Feld type wählt die Sperrlisten-Prüfung. Transaktional, der Standard, erreicht auch Kunden, die sich vom Marketing abgemeldet haben, denn ihren Beleg brauchen sie trotzdem. Marketing verhält sich wie eine Kampagne. Beide überspringen Adressen mit Bounce.

Welche Limits gelten für die Send-API?

Jeder API-Schlüssel hat ein Limit pro Minute, Ihr Tarif enthält eine monatliche Zahl an Send-API-Aufrufen (500 im Free-Tarif), und jeder Versand zählt zu den monatlichen E-Mails Ihres Tarifs. Ein Idempotency-Key-Header lässt einen wiederholten Aufruf das erste Ergebnis zurückgeben, also bekommt jeder Kunde einen Beleg.

Kann ich über denselben Endpunkt eigenes HTML senden?

Ja. Senden Sie html oder text statt einer projectId, und die Nachricht geht so raus, wie sie ist. Das passt zu einem Einmalcode; für interaktive Blöcke ist der Vorlagenmodus da.

Bauen Sie das im Studio

Starten Sie mit dem kostenlosen Tarif — jeder interaktive Block und die vollständige Fallback-Engine sind in jedem Tarif enthalten.