> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/automatisierung/workflows/quiz-ergebnisse-im-workflow-verarbeiten.md).

# Quiz-Ergebnisse im Workflow verarbeiten

Der Auslöser **Quiz abgeschickt** startet einen Workflow, sobald ein Kontakt ein veröffentlichtes Quiz vollständig absendet. So kannst du auf ein Ergebnis reagieren, ohne Antworten einzeln auszuwerten: etwa mit einer passenden Rückmeldung, einer Aufgabe für dein Team oder einem nächsten Lernschritt.

Der Workflow startet erst nach der vollständigen Abgabe. Das Öffnen eines Quiz oder das Beantworten einzelner Fragen genügt nicht.

## Wofür der Auslöser geeignet ist

Nutze ihn, wenn das Quiz einen klaren Zweck hat und das Ergebnis eine nachvollziehbare Folge auslösen soll.

| Ziel                   | Beispiel für einen passenden Folgeweg                                          |
| ---------------------- | ------------------------------------------------------------------------------ |
| Wissensstand begleiten | Je nach Ergebnis eine Wiederholung oder eine weiterführende Lektion empfehlen. |
| Anfrage einordnen      | Antworten nach Themenbereich trennen und passend weiterleiten.                 |
| Team informieren       | Bei einer bestimmten Auswertung eine interne Aufgabe erzeugen.                 |
| Persönlich nachfassen  | Eine Rückmeldung senden, die zum Ergebnis und zum nächsten Schritt passt.      |

Lege vor der Einrichtung fest, was jedes mögliche Ergebnis bedeutet. Ein Workflow kann zuverlässig ausführen, was du definierst – er bewertet aber nicht selbst, ob eine Schlussfolgerung sinnvoll ist.

## Voraussetzungen vor dem Start

1. Das Quiz ist veröffentlicht.
2. Die Fragen, Kategorien und Ergebniswerte sind im Quiz vollständig eingerichtet.
3. Du weißt, für welches Quiz der Workflow gelten soll.
4. Für jede wichtige Ergebnisgruppe ist eine passende Folgeaktion vorbereitet.
5. Du hast mindestens zwei Testwege geplant: einen passenden und einen nicht passenden.

> **Wichtig:** Ein nicht veröffentlichtes Quiz löst keinen Workflow aus. Prüfe deshalb erst die Veröffentlichung und danach den Workflow.

## Auslöser Schritt für Schritt einrichten

1. Öffne **Automatisierung > Workflows**.
2. Erstelle einen neuen Workflow oder öffne einen bestehenden Entwurf.
3. Klicke auf **Auslöser hinzufügen**.
4. Suche nach **Quiz abgeschickt** und wähle den Auslöser.
5. Gib dem Auslöser einen klaren Namen, zum Beispiel **Wissensquiz nach Abgabe prüfen**.
6. Lege die passenden Filter fest.
7. Speichere den Auslöser.
8. Ergänze danach die Aktionen für die einzelnen Ergebniswege.
9. Teste den gesamten Ablauf mit Testkontakten.
10. Aktiviere den Workflow erst nach der Ergebnisprüfung.

Der Auslöser kann alle veröffentlichten Quizze berücksichtigen. In den meisten Fällen ist es sicherer, ihn auf ein konkretes Quiz einzugrenzen.

## Filter verständlich einsetzen

Filter entscheiden, welche Abgabe den Workflow starten darf. Du kannst mehrere Filter kombinieren, um nur die passenden Ergebnisse weiterzuführen.

| Filter                | Was er prüft                                        | Praktischer Einsatz                                                                       |
| --------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| **Quizname**          | Welches Quiz abgeschickt wurde.                     | Ein bestimmtes Quiz auswählen, alle Quizze zulassen oder einzelne Quizze ausschließen.    |
| **Gesamtergebnis**    | Die Gesamtpunktzahl des Quiz.                       | Einen Mindestwert, Höchstwert oder einen Wertebereich festlegen.                          |
| **Kategorieergebnis** | Das Ergebnis in einem bestimmten Quizbereich.       | Zum Beispiel nur dann weiterführen, wenn ein bestimmtes Thema noch Unterstützung braucht. |
| **Eigenes Feld**      | Ein Ergebniswert, den du beim Quiz hinterlegt hast. | Einen individuell gespeicherten Wert als Bedingung verwenden.                             |

### Wertebereiche korrekt festlegen

Für einen Bereich verwendest du den Operator **zwischen**:

1. Trage zuerst den unteren Wert ein.
2. Trage danach den oberen Wert ein.
3. Beide Grenzwerte gehören zum Bereich.
4. Der untere Wert darf nicht höher als der obere Wert sein.

Beispiel: Soll ein Ablauf bei einem Ergebnis von 30 bis 60 starten, zählen 30 und 60 mit. Ein Ergebnis von 29 oder 61 startet diesen Ablauf nicht.

Verwende eindeutige Bereiche. Überschneiden sich mehrere Ergebniswege, kann ein Kontakt in einen unerwarteten Ablauf geraten.

## Ergebniswege sinnvoll aufbauen

Nach dem Auslöser bestimmst du, was im Workflow passiert. Häufige nächste Schritte sind:

* eine E-Mail oder SMS mit einer passenden Rückmeldung senden;
* eine interne Aufgabe für das Team anlegen;
* Informationen am Kontakt ergänzen;
* mit einer Wenn/Dann-Entscheidung unterschiedliche Ergebniswege bilden;
* eine Wartezeit einbauen;
* den Kontakt an einen weiteren passenden Workflow übergeben.

Beginne mit einer einfachen Struktur:

Quiz abgeschickt → Quizname prüfen → Ergebnisbereich prüfen → passende Rückmeldung oder Teamaufgabe → Ergebnis kontrollieren.

Je klarer die Ergebnisse voneinander getrennt sind, desto einfacher kann dein Team später verstehen, warum ein Kontakt eine bestimmte Nachricht oder Aufgabe erhalten hat.

## Praxisbeispiel: Wissensquiz mit zwei Folgewegen

Ein Kurs endet mit einem Quiz. Das Team möchte Lernenden abhängig vom Ergebnis helfen, ohne alle Antworten einzeln prüfen zu müssen.

1. Der Workflow startet mit **Quiz abgeschickt**.
2. Ein Filter begrenzt ihn auf das Quiz **Grundlagen prüfen**.
3. Eine erste Bedingung prüft, ob das Ergebnis zwischen 0 und 59 liegt.
4. In diesem Weg erhält der Kontakt eine freundliche Wiederholungsempfehlung.
5. Ein zweiter Weg prüft Ergebnisse ab 60.
6. Dort wird eine interne Aufgabe erzeugt, damit das Team eine weiterführende Einladung prüfen kann.
7. Zwei Testkontakte reichen das Quiz mit unterschiedlichen Ergebnissen ein.
8. Das Team prüft jeweils Workflow-Verlauf, Nachricht und Aufgabe.

So erhält jeder Kontakt einen nachvollziehbaren nächsten Schritt, ohne dass der Workflow unklare Ergebnisse erraten muss.

## Das Quiz auf einer Seite einbetten

Ein Quiz kann auf einer Website- oder Funnel-Seite eingebunden werden:

1. Öffne das gewünschte Quiz und wähle **Einbetten**.
2. Kopiere den bereitgestellten Einbindungscode.
3. Öffne die Seite, auf der das Quiz erscheinen soll.
4. Füge ein Element für eigenen Code ein.
5. Hinterlege dort den Einbindungscode.
6. Öffne die Vorschau.
7. Teste eine vollständige Abgabe auf der veröffentlichten Seite – nicht nur im Editor.

Wenn der Workflow später nicht startet, prüfe zuerst, ob wirklich das veröffentlichte Quiz auf der veröffentlichten Seite abgegeben wurde.

## Vollständig testen – sechs Pflichtfälle

| Testfall                       | Einrichtung                                                | Erwartetes Ergebnis                                        |
| ------------------------------ | ---------------------------------------------------------- | ---------------------------------------------------------- |
| **Passendes Quiz**             | Das vorgesehene veröffentlichte Quiz abgeben.              | Der Workflow startet.                                      |
| **Anderes Quiz**               | Ein ausgeschlossener oder anderer Quizname wird abgegeben. | Der Workflow startet nicht, wenn der Filter es verhindert. |
| **Unterer Grenzwert**          | Ergebnis entspricht genau dem unteren Bereichswert.        | Der Kontakt folgt dem vorgesehenen Ergebnisweg.            |
| **Oberer Grenzwert**           | Ergebnis entspricht genau dem oberen Bereichswert.         | Der Kontakt folgt ebenfalls dem vorgesehenen Ergebnisweg.  |
| **Außerhalb des Bereichs**     | Ergebnis liegt knapp unter oder über dem Bereich.          | Der zugehörige Weg startet nicht.                          |
| **Veröffentlichte Einbettung** | Quiz auf der veröffentlichten Seite vollständig abgeben.   | Quizabgabe und Workflow sind am Kontakt nachvollziehbar.   |

Prüfe nach jedem Test:

1. Wurde das richtige Quiz erkannt?
2. Traf der erwartete Filter zu?
3. Startete nur der vorgesehene Ergebnisweg?
4. Sind Nachricht, Aufgabe oder Datenänderung verständlich und richtig?
5. Bleibt ein nicht passender Testkontakt ohne unerwünschte Folgeaktion?

## Typische Fehler und die passende Lösung

| Beobachtung                                            | Wahrscheinliche Ursache                                                     | Sichere Lösung                                                                       |
| ------------------------------------------------------ | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Der Workflow startet nicht.                            | Das Quiz ist nicht veröffentlicht oder wurde nicht vollständig abgeschickt. | Quiz veröffentlichen und eine vollständige Testabgabe durchführen.                   |
| Der falsche Ablauf startet.                            | Quizname oder Ergebnisbereich ist zu weit gefasst.                          | Filter auf ein konkretes Quiz eingrenzen und Bereiche ohne Überschneidung festlegen. |
| Ein Bereich lässt sich nicht speichern.                | Unterer Wert ist höher als oberer Wert.                                     | Die beiden Grenzwerte in die richtige Reihenfolge bringen.                           |
| Die Nachricht passt nicht zum Ergebnis.                | Es gibt keinen klar getrennten Ergebnisweg.                                 | Für jede relevante Gruppe einen eigenen, getesteten Folgeweg anlegen.                |
| Das Quiz funktioniert im Editor, aber nicht im Alltag. | Nur die Vorschau wurde geprüft.                                             | Die vollständige Abgabe auf der veröffentlichten Seite testen.                       |

Wenn Quiz, Filter und Folgewege klar getrennt sind, erhalten Kontakte eine passende Rückmeldung und dein Team kann jede automatische Entscheidung zuverlässig prüfen.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/automatisierung/workflows/quiz-ergebnisse-im-workflow-verarbeiten.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.