eTermin Anbindung an Make.com

Einführung

Mit Make.com können Sie sowohl Daten aus eTermin ziehen oder einen Webpush bei der Erstellung / Änderung / Löschung eines Termins bekommen, sowie Daten über einen Trigger an eTermin übergeben. Somit lassen sich flexible Workflows durch unsere offene API-Schnittstelle mit Make.com abbilden.

Datenübertragung an Make.com via Web Push

In Make.com können Sie ein Szenario erstellen, welches mit unserem Webhook beginnt. Dazu klicken Sie bei der Appauswahl auf den Punkt "Webhooks". Danach klicken Sie auf die Schaltfläche "Custom Webhook".

Anschließend klicken Sie auf den Button "Create new Webhook" und geben dort einen Namen für den Webhook ein (z.B. eTermin). Danach können Sie auf Speichern klicken und bekommen die URL mitgeteilt, die Sie für den Webhook nutzen werden. Diese können Sie schonmal kopieren.

Die URL geben Sie in eTermin über den Menüpunkt "API Schnittstellen > API & Web Push" ein. Hier aktivieren Sie die Option "Web Push senden" und geben in der ersten Zeile "An folgende URL senden" die bereits kopierte Web Push URL von Make.com ein. Das Format stellen Sie bestenfalls dabei auch direkt auf json, damit die Verarbeitung in Make einfacher wird. Bitte speichern Sie die Einstellungen zuerst und schicken dann einen Test Web Push (CREATED) über den entsprechenden Button.

Nun sollte die Anbindung an Make.com bereit sein und Sie können die Weiterverarbeitung entsprechend Ihrer Vorstellungen gestalten.

Datenübertragung an eTermin via REST API Call

Make.com bietet die Möglichkeit einen API Call zu versenden. Hierzu muss ein Trigger vorliegen, der diesen API-Call ausführt, danach ist aber fast alles in eTermin möglich, was man ohnehin über das Backend einstellen kann, da unsere offene API-Schnittstelle sehr umfangreich ist.

Um den API-Call erfolgreich zu erstellen brauchen wir den Endpunkt, den Header und einen Body.

Die Endpunkte finden Sie in unserer API-Dokumentation.

Der Body besteht aus den Parametern, die Sie übergeben möchten.

Der Header besteht aus 3 Werten, die Sie im Menüpunkt "API Schnittstellen > API & Webpush" finden. Hier nutzen Sie die Werte "Öffentlicher API Key", "Salt" und "Signature". Die letzteren Werte können Sie sich generieren lassen, indem Sie auf den Button klicken.

In Make.com können Sie nun bei dem gewünschten Szenario eine HTTP-Aktion hinterlegen. Danach wählen Sie "Make a request". In dem nächsten Fenster müssen wir dann nur noch die Daten hinzufügen.

Zuerst füllen wir die URL und die Methode aus. In meinem Beispiel habe ich einen neuen Lead generiert und möchte somit einen neuen Kontakt in eTermin anlegen. Darum nutze ich den Endpunkt "/api/contact" und die Methode "POST".

Danach setzen wir die Header. Diese haben wir ja bereits erstellt und wissen, welche Werte eingefügt werden müssen. Also klicken wir auf "Add a Header" um entsprechend die 3 Werte anzulegen. Das gleiche machen wir dann im Body-Bereich auch nochmal. Als Body-Type empfiehlt sich "Application/x-www-form-urlencoded". Auch hier können dann über "Add item" die Parameter übergeben werden. Das sieht dann ungefähr so aus:

Damit ist auch alles schon vorbereitet und Sie können den ersten Test durchführen. Nachdem in eTermin alles wie vorgegeben angekommen ist, können Sie das Szenario speichern und die Anbindung ist fertig.