Interaktive Kurse & Webinare in Ihre App einbetten

Ihre Endnutzer gehören Ihnen, nicht MailInApp — die Embed API lässt Ihr Backend sie in einen Kurs oder ein Webinar einschreiben oder registrieren und den eigentlichen Viewer in Ihre App einbetten, wobei Ihre eigene Abrechnung über die Berechtigung entscheidet, während MailInApp das Hosting, das Video und die Lifecycle-E-Mails drumherum übernimmt.

Betreff

You're registered — here's your link

Die Embed API lässt Ihr eigenes Backend Ihre eigenen Endnutzer in einen MailInApp-Kurs oder ein Webinar einschreiben oder registrieren und bettet den Viewer in Ihre App ein — ohne dass dieser Nutzer jemals ein MailInApp-Dashboard-Konto berührt.

Ihre Endnutzer gehören Ihnen, nicht MailInApp — sie sollten kein separates Konto erstellen müssen, nur um einen Kurs anzusehen, den Sie in ihrem Namen hosten.

Ihr Backend, Ihre Berechtigung

POST /api/v1/courses/[id]/enroll gewährt oder entzieht den Kurszugang für eine E-Mail-Adresse, und POST /api/v1/webinars/[id]/register registriert einen Webinar-Teilnehmer — beide authentifiziert mit demselben Bearer-API-Schlüssel wie die Send API. Ihr eigenes Abrechnungs- oder Checkout-System entscheidet, wer berechtigt ist; MailInApp rendert nur das Ergebnis.

Betten Sie den eigentlichen Viewer ein

Sobald eingeschrieben, prägt POST /api/v1/courses/[id]/embed-token einen kurzlebigen signierten Token. Leiten Sie das iframe oder Fenster Ihrer App an die zurückgegebene URL, und sie bootstrappt im Hintergrund eine deterministische Anmeldung — der Endnutzer sieht die ganze Zeit über Ihre App, nie einen MailInApp-Login.

Interaktive E-Mails rund um die Registrierung, falls gewünscht

Die lifecycleBindings eines Kurses oder Webinars können registered-/reminder-/enrolled-/completed-Ereignisse auf ein Studio-Projekt richten — einen Meeting-Link mit dem echten Beitreten-Button, einen Countdown bis zur Startzeit. Fällt automatisch auf reinen Text zurück, wenn nichts gebunden ist, sodass das Opt-in eine bestehende Einrichtung nie kaputtmacht.

Derselbe Schlüssel, sein eigenes Kontingent

Die Embed API teilt sich das 60-Anfragen-pro-Minute-Limit pro Schlüssel der Send API, zusätzlich zu einem eigenen dedizierten monatlichen Aufruf-Kontingent je Tarif — null bei Free/Starter, genau wie die Send API selbst auf diesen Stufen begrenzt ist.

Erste Schritte

Prägen Sie einen API-Schlüssel unter Entwickler, rufen Sie den Registrierungs- oder Einschreibungs-Endpunkt von Ihrem Backend aus auf, prägen Sie dann einen Embed-Token und leiten Sie darauf um — die vollständigen Request-Formen finden Sie im Embed-API-Schnellstart.

Ein typischer Ablauf zum Erstellen und Versenden

1
Prägen Sie einen API-Schlüssel
Die Embed API teilt sich denselben Bearer-API-Schlüssel wie die transaktionale Send API — ein Schlüssel authentifiziert jede Route Ihres Kontos.
2
Registrieren oder schreiben Sie Ihren Endnutzer ein
POST /api/v1/webinars/[id]/register für ein registrierungsgesperrtes Webinar, oder POST /api/v1/courses/[id]/enroll für Kurszugang — Ihr eigenes Backend ruft es auf, kein MailInApp-Formular oder -Konto involviert.
3
Betten Sie den Viewer ein
POST /api/v1/courses/[id]/embed-token prägt einen kurzlebigen signierten Token; leiten Sie das iframe oder Fenster Ihrer App an die zurückgegebene URL, um in das eigentliche Kurs-/Webinar-Erlebnis überzugeben.
4
Binden Sie optional die Lifecycle-E-Mails
Die lifecycleBindings eines Kurses oder Webinars können registered-/reminder-/enrolled-/completed-Ereignisse auf ein Studio-Projekt richten, sodass diese E-Mails echte interaktive Blöcke tragen statt der standardmäßigen reinen Textkopie — fällt automatisch zurück, wenn nichts gebunden ist.

Blöcke, die dafür gebaut wurden

Häufig gestellte Fragen

Braucht der Endnutzer ein MailInApp-Dashboard-Konto?

Nein — das ist der Sinn der Embed API. Ein signierter Embed-Token bootstrappt im Hintergrund eine deterministische Anmeldung, sodass der Endnutzer immer nur Ihre App sieht, nie einen MailInApp-Login oder ein Dashboard.

Wer entscheidet, ob ein Nutzer für einen Kurs berechtigt ist?

Sie — Ihr eigenes Backend ruft den Enroll-Endpunkt auf, um Zugang basierend auf Ihrem eigenen Abrechnungs- oder Checkout-System zu gewähren oder zu entziehen. MailInApp rendert nur den Kurs; es ist nicht die Quelle der Wahrheit dafür, wer bezahlt hat.

Können die Registrierungs-/Erinnerungs-E-Mails interaktive Blöcke wie eine normale Kampagne enthalten?

Ja, sobald ein Kurs oder Webinar einen lifecycleBindings-Eintrag hat, der dieses Ereignis auf ein Studio-Projekt richtet — es rendert durch dieselbe Pipeline wie jeder andere Versand, Fallback-Engine inklusive. Ohne Bindung mailt das Ereignis weiterhin die bestehende reine Textkopie, sodass nichts kaputtgeht, wenn Sie sich nicht dafür entscheiden.

Gibt es ein separates Ratenlimit oder Kontingent für die Embed API?

Sie teilt sich das 60-Anfragen-pro-Minute-Limit pro Schlüssel mit der Send API, zusätzlich zu einem eigenen dedizierten monatlichen Aufruf-Kontingent je Tarif — null bei Free/Starter, genau wie die transaktionale Send API auf diesen Stufen begrenzt ist.

Funktioniert das auch für ein Webinar mit öffentlicher Anmeldung, nicht nur ein in eine App eingebettetes?

Beides — ein Webinar kann für jeden offen bleiben, sich über die eigene gehostete Seite von MailInApp zu registrieren, die Embed API für eingebettete Registrierung nutzen, oder beides gleichzeitig; die API erzwingt lediglich den Registrierungsmodus statt offenen Zugang.

Siehe auch

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.

Kostenlos erstellen Alle Anwendungsfälle ansehen