Webhooks: CourseKit mit anderen Werkzeugen verbinden

Ein Webhook ist eine Nachricht, die CourseKit selbst verschickt: Sobald etwas passiert – jemand wird freigeschaltet, eine Lektion ist fertig, ein Zugang läuft ab – schicken wir eine Nachricht an eine Adresse deiner Wahl. Was dort damit passiert, entscheidest du: eine Zeile in einer Tabelle, ein Eintrag in deinem Newsletter-Werkzeug, eine Nachricht in dein Team-Chat.

Damit lässt sich anschließen, was CourseKit selbst nicht eingebaut hat. Du brauchst kein Programmieren, wenn du Zapier oder Make benutzt: Beide nehmen Webhooks entgegen und bauen daraus den nächsten Schritt.

1. 1In Zapier oder Make einen Ablauf mit dem Auslöser „Webhook“ anlegen und die Adresse kopieren, die dort angezeigt wird.
2. 2In CourseKit unter „Einstellungen“ → „Integrationen“ auf „Ziel hinzufügen“ gehen und die Adresse einsetzen.
3. 3Auswählen, welche Ereignisse du bekommen willst – nichts auswählen heißt: alle.
4. 4Den Signaturschlüssel kopieren, der danach einmal angezeigt wird. Danach siehst du ihn nicht mehr; mit „Schlüssel erneuern“ erzeugst du einen neuen, der alte gilt dann sofort nicht mehr.
5. 5Eine Testfreischaltung machen und im Reiter „Zustellungen“ prüfen, dass sie zugestellt wurde.

Hinweis: Die Adresse muss mit https:// beginnen. Adressen, die in ein internes Netz zeigen, lehnen wir ab. Es sind bis zu zehn Ziele möglich.

Hinweis: Ausgehende Webhooks gibt es in den Tarifen Growth und Pro und in der Testphase. Vor einem Wechsel in den Tarif Starter entfernst du deine Ziele – die Seite „Tarif & Abrechnung“ sagt dir das beim Wechsel.

• Mitglied neu angelegt – jemand bekommt zum ersten Mal Zugang
• Kurs freigeschaltet – ein Zugang ist entstanden, durch Kauf oder von Hand
• Lektion abgeschlossen – jemand hat eine Lektion abgehakt oder ein Quiz bestanden
• Kurs abgeschlossen – alle Lektionen eines Kurses sind abgehakt
• Zugang läuft bald ab – 14 und 3 Tage vorher
• Zugang abgelaufen – am Tag danach
• Zertifikat ausgestellt – automatisch oder von dir

Eine Verlängerung ist keine Freischaltung: „Kurs freigeschaltet“ kommt nur, wenn ein Zugang neu entsteht.

Antwortet dein Ziel nicht mit einem Erfolg, versuchen wir es sechs Mal über etwa 36 Stunden erneut – nach einer Minute, fünf Minuten, einer halben Stunde, zwei, sechs und 24 Stunden. Danach steht die Zustellung auf „aufgegeben“ und du kannst sie mit „Erneut schicken“ von Hand wiederholen.

Wir schalten ein Ziel nie von selbst ab. Fehlversuche stehen an dem Ziel, damit du siehst, dass etwas klemmt.

Hinweis: Pausierst du ein Ziel, bekommt es nichts mehr – auch nichts nachträglich, wenn du es wieder einschaltest.

Jede Anfrage ist eine POST-Anfrage mit JSON und trägt die Kopfzeile ck-signature im Format t=<Zeitstempel>,v1=<Signatur>. Die Signatur ist ein HMAC-SHA256 über die Zeichenfolge „<Zeitstempel>.<Rohkörper>“ mit deinem Schlüssel.

Prüfe die Signatur gegen den Rohkörper, bevor du das JSON auswertest, und lehne Anfragen ab, deren Zeitstempel älter als ein paar Minuten ist. Antworte mit einem Statuscode zwischen 200 und 299, sonst wiederholen wir.

Jede Anfrage trägt außerdem eine Ereignis-Kennung (ck-event-id). Kommt dieselbe Kennung zweimal an, ist es dieselbe Nachricht – verarbeite sie nur einmal.