So richten Sie WebinarGeek ein

Um den Token zu erhalten, gehen Sie zu den Kontoeinstellungen auf WebinarGeek. Sie finden ihn in der oberen rechten Ecke des Bildschirms. Nachdem Sie auf das Wort „Account“ klicken, öffnet sich ein Dropdown-Menü, in dem Sie die erste Option auswählen müssen:

Wählen Sie dann im Menü auf der linken Seite „API“ aus

Danach öffnet sich die Seite mit der API

Wenn Sie den Schlüssel nicht erhalten haben, müssen Sie den Kundensupport kontaktieren und einen anfordern.

Nachdem Sie den Token erhalten haben, öffnen Sie Einstellungen -> Projektkonstanten und fügen Sie ihn in die Variable webinargeek_token ein:

So erhalten Sie die Liste der Webinare über den Chat-Bot

Um die Liste zu erhalten, reicht es aus, die Funktion webinargeek_get_webinar_list() aufzurufen:

Als Ergebnis erhalten Sie eine Liste der Webinare in diesem Format:

['{"id":1455034,"date":"11-05-2022 18:00","name":"Zweites Webinar"}',
'{"id":1455046,"date":"11-05-2022 18:00","name":"Mein Webinar"}',
'{"id":1453081,"date":"04-05-2022 18:00","name":"Mein erstes Webinar"}']

wobei

id - die ID der Übertragung (broadcast_id) ist, der Wert ist für alle anderen Aktionen mit diesem
Webinardatum - das Datum und die Uhrzeit dieser Übertragung
name - der Webinarname

Wenn Sie der Funktion ein beliebiges Symbol übergeben (am besten '1' einfügen), zeigt die Funktion nur die Webinare an, die noch nicht beendet sind. Wenn Sie nichts übergeben, werden auch die beendeten Webinare angezeigt.

So registrieren Sie sich über den Chat-Bot für ein Webinar

Für die Registrierung benötigen Sie die Funktion webinargeek_get_webinar_list(broadcast_id, name, email), wobei

broadcast_id - die ID der Übertragung, für die der Kunde registriert werden muss
name - der Name des Kunden, der im Chat angezeigt wird
email - die E-Mail-Adresse, an die die Einladung zum Webinar mit dem Link gesendet wird

Ohne diese Parameter können Sie einen Kunden nicht über den Bot registrieren.

Beispiel:
url = webinargeek_add_subscriber(1455046, 'Max Mustermann', '[email protected]')

Als Ergebnis enthält diese Variable den Link zum Webinar, über den sich der Benutzer nicht mehr registrieren muss. Alle Benutzerdaten werden in dieser Variable festgelegt.

Außerdem werden nach der Ausführung der Funktion zwei Variablen zur Kundenkarte hinzugefügt:

webinargeek_broadcast_id - die ID der Übertragung, für die der Benutzer registriert wurde
webinargeek_email - die bei der Registrierung angegebene E-Mail

Diese Variablen sind nützlich, um die Teilnahme des Benutzers am Webinar zu überprüfen.

So überprüfen Sie die Teilnahme am Webinar über den Chat-Bot

Um die Teilnahme zu überprüfen, benötigen Sie diese Funktion webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email), wobei

webinargeek_broadcast_id - die ID der Übertragung, für die der Benutzer registriert wurde
webinargeek_email - die bei der Registrierung angegebene E-Mail
watch_minimum - (optionaler Parameter) die Mindestanzahl an Minuten, anhand derer die Funktion feststellt, ob die Teilnahme als eine gewertet wird oder nicht

watch = webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email)

In die Variable wird eine Antwort eingefügt:

  • Wenn das Webinar noch nicht beendet ist, wird dieser Text als Antwort eingefügt: „Webinar noch nicht beendet“;
  • Wenn der Kunde das Webinar nicht angesehen hat, wird dies als Antwort eingefügt: „False“;
  • Wenn der Kunde das Webinar angesehen hat und der Parameter watch_minimum nicht verwendet wurde, wird dies als Antwort eingefügt: „True“;
    Wenn der Parameter watch_minimum verwendet wurde, überprüft die Funktion die Zeitdauer, die der Kunde es angesehen hat, und:
    • Wenn der Kunde es kürzer angesehen hat als die festgelegte Mindestdauer, wird dies als Antwort eingefügt: „False“;
    • Wenn die Zeitdauer, die der Kunde das Webinar angesehen hat, gleich oder größer als die angegebene Dauer ist, wird dies als Antwort eingefügt: „True“.

So erhalten Sie broadcast_id anhand des Webinarnamens ab einem bestimmten Datum und einer bestimmten Uhrzeit

Um die broadcast_id eines bestimmten Webinars zu erhalten, benötigen Sie die Funktion webinargeek_search_broadcast_id() mit diesen Parametern:

webinar_list - hier müssen Sie die Variable übergeben, die das Ergebnis der Funktion webinargeek_get_webinar_list() enthält
webinar_name - der Name des Webinars, dessen broadcast_id Sie finden müssen
webinar_date - das Datum der Übertragung im Format dd.mm.yyyy. Sie können auch curret_date verwenden
webinar_time - die Uhrzeit der Übertragung im Format hh:mm, wobei hh = Stunden und mm = Minuten

Beispiel:
webinar_list = webinargeek_get_webinar_list()
broadcast_id = webinargeek_search_broadcast_id(webinar_list, 'Zweites Webinar', current_date-4, '18:00'

Hier versuchen wir, die ID der Übertragung zu finden, die 4 Tage vor dem aktuellen Datum um 18:00 Uhr stattfand und „Zweites Webinar“ hieß.

Wenn das Webinar, das den Parametern entspricht, in der Liste vorhanden war, gibt die Funktion die ID des gefundenen Webinars an die Variable broadcast_id zurück.

Wenn ein solches Webinar nicht gefunden wurde, wird stattdessen dieser Text eingefügt: „Kein Webinar mit diesen Parametern“.