Connect Tiquiz to GoHighLevel

The guide, step by step

Eight steps, in the order you do them. Each one says which product you are in: Tiquiz, or your GoHighLevel account. Count ten minutes the first time, two the next ones.

1. 1

   Step 1 : Open the Connections tab

   In Tiquiz

   Go to Settings, Connections tab. You see one card per tool. On the GoHighLevel card, click Connect. That is the only action of this step: nothing to copy, nothing to paste.

   Screenshot to add

   The Connections tab in Tiquiz, with the GoHighLevel card and its Connect button.

2. 2

   Step 2 : Pick the sub-account

   In GoHighLevel

   You land at GoHighLevel, logged into your account. The page lists your sub-accounts (your Locations). Pick the one that should receive your quiz leads, then authorise Tiquiz. An agency can tick several: each becomes a connection, within your plan's limit.

   Tiquiz only asks for what it needs: read and write contacts, read sub-accounts, read tags. Nothing about your conversations, payments or appointments.

   Screenshot to add

   The GoHighLevel page listing the sub-accounts, with the one to pick ticked.

3. 3

   Step 3 : Check that it responds

   In Tiquiz

   You are back in Tiquiz, and the GoHighLevel window opens by itself with your sub-account. Click Test: you should read "It responds: the connection is active". You can rename the connection, pause it, or add another one with Add a sub-account.

   Screenshot to add

   The GoHighLevel window in Tiquiz, with the connected sub-account and the Test button.

4. 4

   Step 4 : Pick the quiz destination

   In Tiquiz

   Open the quiz, Create tab, left column, "Quiz management" group: Where this quiz's leads go. Pick your GoHighLevel connection. Your first connection becomes the default destination of your project, so your next quizzes use it with nothing to set.

   Screenshot to add

   The lead destination selector in the editor, set to the GoHighLevel connection.

5. 5

   Step 5 : Write a tag on each profile

   In Tiquiz

   Still in the Create tab, open each result profile. Below its text, the field Tag to apply to people who got this profile. The safest choice is a tag that already exists in your sub-account, written character for character. A survey applies one tag per answer; a scored quiz can also apply one tag per score range.

   Screenshot to add

   A result profile open in the editor, with its tag filled in.

6. 6

   Step 6 : Copy the list of your tags

   In Tiquiz

   The Automate tab of the editor lists, for this quiz, the exact tags that will be sent to GoHighLevel, and the recipe to repeat for each. One click on a tag copies it. This is the list you take to the next step.

   Screenshot to add

   The Automate tab, with the list of the quiz's tags and the GoHighLevel recipe.

7. 7

   Step 7 : Create one workflow per tag

   In GoHighLevel

   A tag on its own triggers nothing, in GoHighLevel as anywhere else. In the sub-account: Automations, Workflows, Create Workflow. Trigger Contact Tag, filter Tag Added, then paste the tag. Action: the email or campaign the person should receive. Publish the workflow.

   Repeat for each tag in the list. A profile without a workflow gets its tag, and nothing else.

   Screenshot to add

   A GoHighLevel workflow with the Contact Tag trigger, the Tag Added filter and the pasted tag.

8. 8

   Step 8 : Take the quiz for real

   In GoHighLevel

   Take your quiz with a test address, up to the email screen. In Contacts, the contact shows up with the tag of its profile, the source "Tiquiz: " followed by the quiz title, and the profile in plain words in the tiquiz_resultat field. Take the quiz again with the same address and another result: the second tag is added, the first one stays.

   Screenshot to add

   The test contact's record in GoHighLevel, with the profile tag and the Tiquiz source.

What is sent to GoHighLevel

For each captured lead, in this order:

• The contact: email, first name, last name, phone and country when the quiz asks for them. If it already exists, it is updated, never duplicated.
• The tags: the one of the result profile, those of survey answers, those of the score if you enabled them, and the share tag when the person shares. They are ADDED to the contact's existing tags, never replaced.
• The result profile, in plain words, in a custom field named tiquiz_resultat. Tiquiz creates it in the sub-account if it is missing; if the creation is refused, everything else is still sent.
• Your custom fields from the capture form, each one in a contact field named after its label, created if missing. Renaming a field in the editor creates a new field in GoHighLevel: the old one keeps its values.
• The source of the contact: "Tiquiz" followed by the quiz title.

An agency and its sub-accounts

One connection is for ONE sub-account, because that is where contacts and workflows live. An agency managing ten clients has ten connections, and each quiz picks its own. The free plan counts 1 connection, the subscription 2, and PLUS as many as you want: an agency with several clients therefore needs PLUS. Systeme.io keys and webhooks count too. The Connect button, started from an agency, offers all its sub-accounts at once; "Add a sub-account" adds one later.

Pausing, and being warned

Each connection has a switch: paused, nothing is sent anymore, and quizzes keep their setting. If GoHighLevel rejects the connection (app uninstalled, permissions removed), it turns "disconnected" and you get one email, once. Leads captured in the meantime stay in Tiquiz and can be resent from My leads, Sync button, once you have reconnected.