Incorporare corsi e webinar interattivi nella tua app

I tuoi utenti finali sono tuoi, non di MailInApp — l'Embed API permette al tuo backend di iscriverli o registrarli in un corso o webinar e incorporare il vero visualizzatore nella tua app, mentre la tua stessa fatturazione decide il diritto di accesso e MailInApp gestisce l'hosting, il video e le email del ciclo di vita attorno ad esso.

Oggetto

You're registered — here's your link

L'Embed API permette al tuo stesso backend di registrare o iscrivere i tuoi utenti finali in un corso o webinar MailInApp e di incorporare il visualizzatore nella tua app — senza che quell'utente tocchi mai un account dashboard MailInApp.

I tuoi utenti finali sono tuoi, non di MailInApp — non dovrebbero doversi creare un account separato solo per guardare un corso che stai ospitando per loro conto.

Il tuo backend, il tuo diritto di accesso

POST /api/v1/courses/[id]/enroll concede o revoca l'accesso al corso per un indirizzo email, e POST /api/v1/webinars/[id]/register registra un partecipante al webinar — entrambi autenticati con la stessa chiave API bearer della Send API. Il tuo stesso sistema di fatturazione o checkout decide chi ne ha diritto; MailInApp si limita a renderizzare il risultato.

Incorpora il vero visualizzatore

Una volta iscritto, POST /api/v1/courses/[id]/embed-token genera un token firmato di breve durata. Reindirizza l'iframe o la finestra della tua app all'URL restituito, e questo avvia un accesso deterministico dietro le quinte — l'utente finale vede la tua app per tutto il tempo, mai un login MailInApp.

Email interattive attorno alla registrazione, se le vuoi

Le lifecycleBindings di un corso o webinar possono puntare gli eventi registered/reminder/enrolled/completed a un progetto dello studio — un Link della riunione con il vero pulsante di partecipazione, un Conto alla rovescia verso l'orario di inizio. Ricade automaticamente sul testo semplice predefinito quando nulla è collegato, così attivare questa opzione non rompe mai una configurazione esistente.

Stessa chiave, quota propria

L'Embed API condivide il limite di 60 richieste al minuto per chiave della Send API, più una propria quota mensile di chiamate dedicata in base al piano — zero su Free/Starter, come l'accesso alla Send API stessa su quei livelli.

Per iniziare

Genera una chiave API sotto Sviluppatori, chiama l'endpoint di registrazione o iscrizione dal tuo backend, poi genera un token di incorporazione e reindirizza a esso — vedi la Guida rapida dell'Embed API per le forme complete di richiesta.

Una tipica sequenza di creazione e invio

  1. 1

    Genera una chiave API

    L'Embed API condivide la stessa chiave API bearer della Send API transazionale — una sola chiave autentica ogni rotta del tuo account.

  2. 2

    Registra o iscrivi il tuo utente finale

    POST /api/v1/webinars/[id]/register per un webinar a registrazione, oppure POST /api/v1/courses/[id]/enroll per l'accesso a un corso — il tuo stesso backend lo chiama, nessun modulo o account MailInApp coinvolto.

  3. 3

    Incorpora il visualizzatore

    POST /api/v1/courses/[id]/embed-token genera un token firmato di breve durata; reindirizza l'iframe o la finestra della tua app all'URL restituito per passare all'effettiva esperienza del corso/webinar.

  4. 4

    Collega le email del ciclo di vita, facoltativamente

    Le lifecycleBindings di un corso o webinar possono puntare gli eventi registered/reminder/enrolled/completed a un progetto dello studio, così quelle email portano veri blocchi interattivi invece del testo semplice predefinito — ricadendo automaticamente sul comportamento predefinito se nulla è collegato.

Domande frequenti

L'utente finale ha bisogno di un account dashboard MailInApp?

No — è proprio questo il punto dell'Embed API. Un token di incorporazione firmato avvia un accesso deterministico dietro le quinte, così l'utente finale vede solo la tua app, mai un login o una dashboard MailInApp.

Chi decide se un utente ha diritto ad accedere a un corso?

Tu — il tuo stesso backend chiama l'endpoint di iscrizione per concedere o revocare l'accesso in base al tuo sistema di fatturazione o checkout. MailInApp si limita a renderizzare il corso; non è la fonte di verità su chi ha pagato.

Le email di registrazione/promemoria possono includere blocchi interattivi come una campagna normale?

Sì, una volta che un corso o webinar ha una voce lifecycleBindings che punta quell'evento a un progetto dello studio — viene renderizzata attraverso la stessa pipeline di qualsiasi altro invio, motore di fallback incluso. Senza un collegamento, l'evento invia comunque via email il testo semplice del ciclo di vita esistente, quindi nulla si rompe se non attivi questa opzione.

C'è un limite o una quota separata per l'Embed API?

Condivide il limite di 60 richieste al minuto per chiave con la Send API, più una propria quota mensile di chiamate dedicata in base al piano — zero su Free/Starter, come l'accesso alla Send API transazionale su quei livelli.

Funziona anche per un webinar con iscrizione pubblica, non solo uno incorporato nell'app?

Entrambi — un webinar può restare aperto a chiunque voglia registrarsi tramite la pagina ospitata di MailInApp, usare l'Embed API per la registrazione incorporata nell'app, oppure entrambe le cose insieme; l'API si limita a forzare la modalità di registrazione invece dell'accesso libero.

Costruiscilo nello studio

Inizia con il piano gratuito — ogni blocco interattivo e il motore di fallback completo sono inclusi in tutti i piani.