RooQuiz Docs
Connectors & Automation

The Five Channels

Webhook, Slack, Zapier and Kit allow one connector per team — to replace an existing one, delete it first. Email allows up to 3, so different teams or events can get their own notification.

Email

Available on every plan. Sends through one of your team's own sending services — an SMTP server or a connected Gmail account, set up under Email Sending Service.

  • Sending service — pick which of your sending services delivers this connector's email.
  • Recipients — type an address and press Enter, up to 10. You can also add the dynamic "Respondent email" recipient to notify the person themselves.
  • Subject — up to 200 characters; no line breaks, no HTML.
  • Body — up to 10,000 characters; no HTML.
  • When to send — Every time, or Only for specific results: pick a quiz and one or more of its levels or result types (an AI Quiz's result tags count too), e.g. a follow-up for the "Beginner" level only. Conditions apply to new submissions and new leads; booking events never match. Because the result may not be ready when someone first becomes a lead (in an AI Quiz it never is), trigger result-based emails on New submission.

The quickest way to set up result-based emails for one quiz is Settings → Result page follow-up → Emails by result in that quiz — see Quiz settings.

Subject and body both support inserting variables, in two groups:

  • System variables — lead name, respondent name and email, quiz name, record number, submitted at, score, max score, result level, result type, report link, lead page link, team name, and for booking events the attendee name and email, booking start and end time, and previous start time.
  • Quiz questions — reference the answer to a specific question.

Webhook

POSTs each event to your own URL, which must be HTTPS.

A signing secret is shown exactly once at creation — close the dialog and it's gone. Copy it right away.

Every delivery carries an X-Rooquiz-Signature header: an HMAC-SHA256 of the request body using that secret. Your server should verify it to confirm the request really came from RooQuiz.

Slack

Click Connect Slack to run the OAuth flow, then pick a channel.

The bot is not added to channels automatically. Run /invite @rooquiz in the target channel first — required for private channels — otherwise delivery fails with not_in_channel.

You can supply a message template using Slack mrkdwn (*bold*, _italic_, `code`, <url|text>) and system variables. Leave it empty for the default Block Kit format.

Zapier

Use Zapier to reach thousands of apps:

  1. In Zapier, create a Zap and choose Webhooks by Zapier as the trigger.
  2. Pick the Catch Hook event and copy the Webhook URL it generates.
  3. Paste that URL into RooQuiz, save, and verify with Send test.

Kit

Kit (formerly ConvertKit) is an email marketing tool. After Connect Kit and the OAuth flow:

  • Tags for every new lead — a fixed set of up to 20 tags applied to every subscriber, e.g. quiz-lead. Type a name that doesn't exist yet and it is created in Kit on save.
  • Tags by result — add rules that tag respondents by their result: each rule picks a quiz, one or more of its levels or result types (or AI result tags), and the tags to add. Start a different Kit sequence for each tag. Rules apply on every submission, so a retake that lands on a new result adds that result's tags too.
  • Use Refresh tags to re-fetch the tag list from Kit when needed.

Trigger email sequences from those tags in Kit and new leads flow straight into your nurture path.

Email and Slack are available on every plan. Webhook, Zapier and Kit are Pro plan only.

On this page