Webservices

In diesem Artikel:

 

Über Integration von QUESTIONSTAR mit Webservices

Mit Webservices können Sie Ihre Umfragen mit anderen Systemen verknüpfen und automatisierte Prozesse anstoßen. QUESTIONSTAR bietet Ihnen die Möglichkeit, Webservice-Aufrufe direkt aus dem Fragebogen heraus zu starten – ganz ohne Programmierung. So lassen sich Daten in Echtzeit an externe Systeme übertragen oder bestimmte Aktionen automatisch auslösen.

Ein Webservice kann in folgenden Situationen aufgerufen werden:

• Nach Beendigung der Umfrage
  → Ideal für automatisierte Nachbearbeitung: Z. B. einen Eintrag im CRM-System anlegen, einen Bonus freischalten oder einen Gutschein per E-Mail verschicken.
• Bei Erreichen einer Quote oder Screenout
  → Perfekt, um bei Quotensteuerung direkt externe Systeme zu informieren, etwa zur Umleitung in andere Panels, für Incentivierungslogiken oder zur Steuerung von Kampagnen.
• Im Rahmen von Benachrichtigungen über bestimmte Ereignisse
  → So können z. B. bei einer bestimmten Antwort oder Punktzahl automatisch Prozesse im Hintergrund angestoßen werden – wie das Öffnen eines Support-Tickets, das Versenden eines Alerts oder das Starten eines Workflows in einem Marketing-Automation-Tool.

Typische Anwendungsfälle aus dem Business-Alltag:

• Ein Lead füllt einen kurzen Qualifizierungsfragebogen aus – die Daten werden direkt an Ihr CRM-System gesendet.
• Ein Kunde bewertet den Support negativ – automatisch wird ein Task im Ticket-System erstellt.
• Eine interne Schulungsumfrage ergibt einen Wissensstand < 70 % – automatisch wird ein Reminder zur Nachschulung versendet.
• Nach erfolgreicher Teilnahme an einer Kampagne – wird automatisiert ein Gutschein erzeugt und verschickt.

Mit der Webservice-Funktion in QUESTIONSTAR lassen sich solche Szenarien elegant und automatisiert abbilden. In diesem Artikel zeigen wir Ihnen, wie Sie Webservice-Aufrufe konfigurieren und optimal einsetzen.

 

Webservice-Aufruf konfigurieren

Beim Einrichten eines Webservice-Aufrufs in QUESTIONSTAR können Sie folgende Einstellungen vornehmen:

1. Ziel-URL (Endpoint) Geben Sie die URL des Webservices ein, an den die Daten gesendet werden sollen.
2. Anfragemethode Wählen Sie aus, mit welcher HTTP-Methode die Parameter an den Endpoint übermittelt werden sollen. Verfügbare Methoden sind:
   • GET – Parameter werden in der URL übergeben. Eignet sich z. B. für einfache Tracking-Zwecke oder Aufrufe, bei denen keine sensiblen Daten übertragen werden.
   • POST – Parameter werden im Body der Anfrage übermittelt. Geeignet für strukturierte Datenübergaben, z. B. zur Übergabe von Antworten oder Kundendaten.
   • PUT – Wird meist verwendet, um vorhandene Ressourcen zu aktualisieren.
3. Anfragetyp (Content Type) Wenn Sie POST oder PUT verwenden, können Sie zusätzlich festlegen, in welchem Format die Daten gesendet werden:
   • application/json – Parameter werden als JSON-Objekt übergeben. Ideal für moderne APIs, die strukturierte Daten erwarten.
   • application/x-www-form-urlencoded – Klassisches Webformular-Format. Wird häufig bei älteren oder einfacheren APIs verwendet.
     

     Tipp: Verwenden Sie application/json, wenn Ihr Webservice ein JSON-Objekt erwartet, z. B.:
     { "email": "john@example.com", "score": 5 }
     Nutzen Sie x-www-form-urlencoded, wenn der Webservice einfache Schlüssel-Wert-Paare in der Form email=john@example.com&score=5 benötigt.

4. Parameter hinzufügen Fügen Sie für jede Information, die Sie an den Webservice senden möchten, einen eigenen Parameter hinzu. Für jeden Parameter definieren Sie:
   • Parameternamen – also den Namen, den Ihr Webservice erwartet.
   • Wertquelle – d.h. woher der Parameterwert stammen soll.
   • Wert – welcher Wert gesendet wird (je nach Wertquelle statisch definierbar oder dynamisch wählbar).

   Als Quellen für Parameterwerte stehen Ihnen folgende Optionen zur Verfügung:

   • Text – Für statische Werte wie z. B. feste Umfragekennungen, Kampagnen-IDs oder API-Tokens (Vorsicht bei GET, da Tokens sichtbar übermittelt werden!).
   • Antwort auf Frage – Um eine konkrete Teilnehmerantwort an den Webservice zu übergeben.
   • Benutzerdefinierte Variable – Zum Beispiel eine berechnete Skala oder ein Score aus einem psychologischen Test (z. B. „BurnoutIndex“, „TeamFitScore“).
   • A/B-Test-Variante – Die Variante (A, B, C, …), die ein Teilnehmer im A/B-Test erhalten hat. Hilfreich für die Auswertung von Testeffekten.
   • URL-Parameter – Werte, die beim Aufruf des Fragebogens über die URL übergeben wurden (z. B. Teilnehmer-ID, Kampagne, Tracking-Code).
   • Feld aus der Kontaktliste – z. B. Name, Vorname, E-Mail-Adresse oder individuelle Felder wie Abteilung, Region, Kundenstatus etc.
5. Antworten senden als – Für Parameter vom Typ „Antwort auf Frage“ können Sie festlegen, wie die Antworten übermittelt werden:
   • Codierte Werte (Standard) – z. B. 5 für „Sehr zufrieden“
   • Textwerte – z. B. „Sehr zufrieden“
6. Parameter entfernen – Sie können beliebig viele Parameter hinzufügen oder bestehende löschen und jederzeit neu anordnen.
7. Speichern – Klicken Sie auf „Speichern“, um den Webservice-Aufruf zu sichern. Der Webservice wird dann bei dem entsprechenden Ereignis (z. B. Umfrageende, Quotenereignis, Bedingung für Benachrichtigung) automatisch aufgerufen.

 

Antworten als JSON oder als Formdaten senden – was ist der Unterschied?

Wenn Sie POST- oder PUT-Anfragen über Webservices senden, haben Sie in QUESTIONSTAR die Wahl, in welchem Format die Daten übermittelt werden. Diese Auswahl treffen Sie über den sogenannten Anfragetyp (Content Type):

 

1. application/json

Die Daten werden als strukturierter JSON-Block gesendet – das ist der moderne Standard für die meisten Web-APIs. Ideal, wenn Ihr Zielsystem (z. B. ein internes Tool oder ein Cloud-Service) JSON versteht und sauber strukturierte Daten erwartet.

Beispiel:

{ "email": "jane.doe@example.com", "score": 7, "region": "Nord" }

1 2 3 4 5

{       "email": "jane.doe@example.com",       "score": 7,       "region": "Nord"     }

✅ Vorteile:

• Sehr gut lesbar und strukturierbar
• Ideal für Systeme mit komplexeren Datenstrukturen
• Weniger fehleranfällig bei der Verarbeitung

🔧 Typische Einsatzgebiete:

• RESTful APIs
• Integration in interne Tools oder Middleware
• Weitergabe von kompletten Datensätzen

 

2. application/x-www-form-urlencoded

Die Daten werden als klassische Schlüssel-Wert-Paare in einer URL-kodierten Form gesendet – wie bei HTML-Formularen. Dieses Format ist mit nahezu allen Systemen kompatibel, auch mit älteren oder einfachen APIs.

Beispiel:
email=jane.doe%40example.com&score=7&region=Nord

✅ Vorteile:

• Breite Kompatibilität mit vielen Webservices
• Gut geeignet für einfache Parameterübergaben

🔧 Typische Einsatzgebiete:

• Anbindung an ältere Webservices
• Systeme, die Formularverarbeitung erwarten
• Einfache Integrationen ohne strukturierte Daten

 

Wann welches Format?

Situation	Empfehlung
Ihr Webservice verwendet moderne REST-Standards	JSON
Sie übermitteln mehrere strukturierte Datenobjekte	JSON
Sie binden ein älteres oder externes System ein	Formdaten
Der Webservice erwartet Daten wie aus einem HTML-Formular	Formdaten

Tipp: Falls Sie sich unsicher sind, welches Format Ihr Webservice benötigt, prüfen Sie die technische Dokumentation des Zielsystems oder testen Sie beide Formate – QUESTIONSTAR unterstützt beide flexibel.