# Die fünf Kanäle

Source: https://docs.rooquiz.com/de/connectors/channels

> Die fünf Connector-Kanäle – E-Mail über Ihren eigenen SMTP-Server, Webhook, Slack, Zapier und Kit: was jeder zustellt, welche Empfänger und Formate Sie festlegen und warum es einen Connector pro Kanal gibt.

Webhook, Slack, Zapier und Kit erlauben **einen Connector pro Team** – um einen bestehenden zu ersetzen, löschen Sie ihn zuerst. E-Mail erlaubt **bis zu 3**, sodass verschiedene Teams oder Ereignisse jeweils eine eigene Benachrichtigung erhalten können.

## E-Mail

In jedem Tarif verfügbar. Versendet über einen der eigenen Versanddienste Ihres Teams – einen SMTP-Server oder ein verbundenes Gmail-Konto, eingerichtet unter [E-Mail-Versand](https://docs.rooquiz.com/de/connectors/email-smtp).

* **Versanddienst** – wählen Sie, welcher Ihrer Versanddienste die E-Mails dieses Connectors zustellt.
* **Empfänger** – geben Sie eine Adresse ein und drücken Sie die Eingabetaste, **bis zu 10**. Sie können auch den dynamischen Empfänger „E-Mail des Teilnehmers" hinzufügen, um die Person selbst zu benachrichtigen.
* **Betreff** – bis zu 200 Zeichen; keine Zeilenumbrüche, kein HTML.
* **Inhalt** – bis zu 10.000 Zeichen; kein HTML.
* **Wann senden** – **Jedes Mal** oder **Nur bei bestimmten Ergebnissen**: Wählen Sie ein Quiz und eine oder mehrere seiner Stufen oder Ergebnistypen (die Ergebnis-Tags eines KI-Quiz zählen ebenfalls), z. B. ein Follow-up nur für die Stufe „Einsteiger“. Bedingungen gelten für neue Einreichungen und neue Leads; Buchungsereignisse erfüllen sie nie. Da das Ergebnis beim ersten Entstehen eines Leads womöglich noch nicht vorliegt (in einem KI-Quiz nie), lösen Sie ergebnisabhängige E-Mails über **Neue Einreichung** aus.

Am schnellsten richten Sie ergebnisabhängige E-Mails für ein einzelnes Quiz unter **Einstellungen → Follow-up der Ergebnisseite → E-Mails nach Ergebnis** in diesem Quiz ein – siehe [Quiz-Einstellungen](https://docs.rooquiz.com/de/editor/settings#follow-up-der-ergebnisseite).

Betreff und Inhalt unterstützen beide das **Einfügen von Variablen**, in zwei Gruppen:

* **Systemvariablen** – Lead-Name, Name und E-Mail des Teilnehmers, Quiz-Name, Datensatznummer, Eingereicht am, Punktzahl, maximale Punktzahl, Ergebnisstufe, Ergebnistyp, Berichtslink, Link zur Lead-Seite, Teamname sowie bei Buchungsereignissen Name und E-Mail der teilnehmenden Person, Beginn und Ende der Buchung und der vorherige Beginn.
* **Quiz-Fragen** – verweisen auf die Antwort zu einer bestimmten Frage.

## Webhook

Sendet jedes Ereignis per POST an Ihre eigene URL, die **HTTPS** verwenden muss.

<Callout type="warning">
  Ein **Signaturschlüssel wird bei der Erstellung genau einmal angezeigt** – schließen Sie den Dialog, ist er weg. Kopieren Sie ihn sofort.
</Callout>

Jede Zustellung enthält einen `X-Rooquiz-Signature`-Header: einen **HMAC-SHA256** des Request-Bodys mit diesem Schlüssel. Ihr Server sollte ihn prüfen, um sicherzustellen, dass die Anfrage tatsächlich von RooQuiz stammt.

## Slack

Klicken Sie auf **Slack verbinden**, um den OAuth-Ablauf zu starten, und wählen Sie dann einen Channel.

<Callout type="warning">
  Der Bot wird Channels **nicht** automatisch hinzugefügt. Führen Sie zuerst `/invite @rooquiz` im Ziel-Channel aus – **bei privaten Channels zwingend erforderlich** –, sonst schlägt die Zustellung mit `not_in_channel` fehl.
</Callout>

Sie können eine **Nachrichtenvorlage** mit Slack-mrkdwn (`*bold*`, `_italic_`, `` `code` ``, `<url|text>`) und Systemvariablen hinterlegen. Lassen Sie sie leer, wird das Standardformat von Block Kit verwendet.

## Zapier

Mit Zapier erreichen Sie Tausende von Apps:

1. Erstellen Sie in Zapier einen Zap und wählen Sie **Webhooks by Zapier** als Trigger.
2. Wählen Sie das Ereignis **Catch Hook** und kopieren Sie die erzeugte Webhook-URL.
3. Fügen Sie diese URL in RooQuiz ein, speichern Sie und prüfen Sie die Verbindung mit **Test senden**.

## Kit

Kit (ehemals ConvertKit) ist ein E-Mail-Marketing-Tool. Nach **Kit verbinden** und dem OAuth-Ablauf:

* **Tags für jeden neuen Lead** – ein fester Satz von bis zu 20 Tags, der jedem Abonnenten zugewiesen wird, z. B. `quiz-lead`. Geben Sie einen Namen ein, der noch nicht existiert, wird er beim Speichern **in Kit angelegt**.
* **Tags nach Ergebnis** – legen Sie Regeln an, die Teilnehmer nach ihrem Ergebnis taggen: Jede Regel wählt ein Quiz, eine oder mehrere seiner Stufen oder Ergebnistypen (oder KI-Ergebnis-Tags) und die hinzuzufügenden Tags. Starten Sie für jeden Tag eine andere Kit-Sequenz. Die Regeln greifen bei jeder Einreichung, sodass eine Wiederholung mit neuem Ergebnis auch die Tags dieses Ergebnisses hinzufügt.
* Mit **Tags aktualisieren** laden Sie die Tag-Liste bei Bedarf erneut aus Kit.

Lösen Sie in Kit E-Mail-Sequenzen über diese Tags aus, und neue Leads gelangen direkt in Ihren Nurturing-Prozess.

<Callout type="info">
  E-Mail und Slack sind in jedem Tarif verfügbar. Webhook, Zapier und Kit sind **nur im Pro-Tarif** verfügbar.
</Callout>
