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 Limit der Send API von 60 Anfragen pro Minute und Schlüssel und hat ab dem Tarif Lite ein eigenes monatliches Kontingent an Aufrufen. Siehe Preise.

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.

Video: Unterrichten per E-Mail

Eine kleine Sprachschule baut einen Videokurs mit Lektionsquiz und eigenem Mitgliederportal, dann eine wöchentliche Lektions-E-Mail, die Lernende direkt im Posteingang durcharbeiten: Video, Audio, Karteikarten, ein Quiz und eine Hausaufgabe, die sie aus der E-Mail abgeben. Eine Schülerin wird über die API angemeldet, und die Lehrkraft bewertet die Hausaufgaben in Insights.

Video auf Englisch

Ein typischer Ablauf zum Erstellen und Versenden

  1. 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. 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. 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. 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.

Häufig gestellte Fragen

Braucht der Endnutzer ein MailInApp-Dashboard-Konto?

Ihre Endnutzer bleiben in Ihrer App. Ein signiertes Embed-Token meldet sie im Hintergrund an, sie sehen also die ganze Zeit Ihre App, ohne MailInApp-Login oder 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 Limit der Send API von 60 Anfragen pro Minute und Schlüssel und hat ab dem Tarif Lite ein eigenes monatliches Kontingent an Aufrufen. Die Kontingente pro Tarif finden Sie in der Preisübersicht.

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.

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.