Votel App Builder

Tutorial 2: Quiz builder to CRM

In about 45 minutes you'll have a public quiz that recommends an AI employee, captures the lead and creates a tagged contact in your Votel CRM, plus a private page that lists every submission.

~45 min with approvals 1 prompt, 1 pasted URL 0 lines of code
Built and tested end to end in a live Votel account on November 21, 2026: a test submission created a tagged CRM contact with a note. Labels can change as Votel ships updates.
Before you start

What you'll build

You'll build a "Which AI employee does your business need?" quiz that turns answers into a CRM contact you can follow up with.

What you'll build

  • A public 4-question quiz with a recommended result
  • A lead form: first name, email and phone
  • A CRM contact created or updated, tagged ai-quiz plus the result, with the answers saved as a note
  • A password-protected /admin page listing submissions, with a chart by result

What you need

  • A Votel account with access to Agents and workflows
  • About 45 minutes
  • Time to read and approve a few cards
  • Done Tutorial 1 first (recommended)
Read this first

How the quiz talks to the CRM

The app can't touch the CRM directly. It sends each submission to a Votel workflow, and the workflow writes the contact.

Quiz pageVisitor answers and submits the lead form
Server functionHolds the webhook URL as a secret. Saves a copy to the app's table
Votel workflowWebhook trigger receives the data
CRM contactLook up or create, tag, add the note

The admin page reads the app's own table, not the CRM. So it lists quiz submissions only, never contacts tagged some other way.

01

Open Web Apps and start a new app

Same start as every app: click Websites, open the Web Apps tab, then click New web app.

Votel Websites page on the Web Apps tab, with the New web app button at the top right
Websites, then Web Apps, then New web app.
02

Paste the prompt

Copy the prompt, paste it in and press Enter. It asks for the plan and the costs up front, and it sets strict test-data rules.

Prompt · Lead quiz to CRM
Build me a web app that connects to this account's CRM. Two parts. 1) Public page: a 'Which AI employee does your business need?' quiz with 4 multiple-choice questions, then a lead form (first name, email, phone). On submit, create or update a contact in this account's CRM, add the tag 'ai-quiz' plus a tag for the recommended result (e.g. 'ai-quiz-receptionist'), and save the quiz answers to the contact as a note. Also save a copy of each submission in the app's own table. 2) Private admin page at /admin protected by a simple password: lists the 20 most recent quiz submissions from the app's own table, with name, email, result, and date, plus a count by result shown as a bar chart. Tell me plainly how the app talks to the CRM (API, keys, where secrets live), whether it needs a backend or database and what that costs, and anything you cannot do. For testing, create at most ONE contact named 'Test VotelApp' with email test-votelapp@example.com and tag 'votel-app-test'. Do not insert any other test rows.
Why the admin page reads the app's table. Our first version asked for contacts "pulled live from the CRM". Apps can't read the CRM, so that part can't work. This prompt asks for what the app can do.
03

Read the plan and approve the cards you meant

This app needs a backend, so you'll see approval cards. Read each one before you approve it.

CardWhat it doesApprove?
BackendSets up the app's database, storage and server functions. Shows the monthly feeYes, this app needs it
Each tableCreates a table, such as the submissions tableYes, if it matches the plan
Deleting test rowsRemoves test data it addedYes
Activating the workflowTurns on the Votel workflow that writes the contactYes
PublishingGives the app a permanent linkOnly after you've tested it
The Votel assistant asking: OK to provision the backend at $0.00 a month, one table plus two server functions, followed by the reply approving the backend, the CRM workflow and publishing
The assistant asks before it sets up the backend, and names the fee: $0.00 a month in our test. The rows below are approvals and automatic retries.
Watch the test data. In our run the assistant inserted 7 fake test rows even though the prompt said not to, then asked to delete them. That's why this prompt says "Do not insert any other test rows". Check the preview, and approve the delete.
04

Paste the webhook URL into the secure form

This is the one manual step. The assistant creates and activates a Votel workflow on a new agent, but it can't read that workflow's webhook URL, so you copy it across. In our run the URL hadn't even been generated yet.

The AI Quiz Lead Capture workflow on the Votel canvas: Webhook Trigger, Contact Lookup that creates the contact if there is no match, Tag with ai-quiz and the result tag, Add Note with the quiz answers, then End
The workflow the assistant built: webhook trigger, look up or create the contact, tag it, add the note. Webhook URL blurred.
  1. Open the right agentGo to Agents and open the agent the assistant names. Ours was called AI Quiz Lead Capture.
  2. Click the Trigger stepIt's the first box on the canvas, set to On webhook call.
  3. Generate the URL if you need toIf you see Generate Webhook URL, click it, then Apply, then Save at the top.
  4. Copy itUse the copy button next to the Webhook URL field.
  5. Paste it into the secure formBack in the chat, paste it into the Add your API keys form and click Save. Never paste it into the chat itself.
The Trigger step settings with an empty Webhook URL field and a Generate Webhook URL button
No URL yet: click Generate Webhook URL.
The Trigger step showing a generated webhook URL, marked Webhook URL ready to use, with the copy button highlighted
Ready to use. Copy it with the button on the right (URL blurred).
The Votel assistant's Add your API keys form asking for CRM_SYNC_WEBHOOK_URL, under a preview of the empty Quiz submissions admin page
The secure form in the chat. Links blurred.
Copy it from the right agent. Our first paste came from an older agent with an empty workflow. The test said it synced, but nothing reached the CRM. The assistant traced the run, spotted the wrong agent and asked for the URL again in a new form. If your test contact doesn't show up, check this first.
05

Test it yourself

Take the quiz once, as the test contact, then check the CRM. In our run the assistant ran the test submission itself once the URL was in, then we took the live quiz too.

Three screens of the live quiz: the first question about what happens outside business hours, the lead form asking for first name, email and phone, and the result AI Receptionist with the answers listed
The live quiz: a question, the lead form, and the result.
CheckDo thisYou should see
Quiz flowAnswer the 4 questionsThe lead form, then a recommended AI employee with your answers
Contact createdSubmit as Test VotelApp, test-votelapp@example.comOne contact in the CRM with that email. Submitting again updates the same contact
TagsOpen the contactai-quiz plus a result tag, such as ai-quiz-ai-receptionist
NoteLook at the contact's timeline"AI Quiz submission" with the result and the answers, written by the workflow
Admin pageOpen /adminAn email and password sign-in. Use Forgot password the first time to set yours
The Test VotelApp contact in Votel with tags ai-quiz, ai-quiz-ai-receptionist and votel-app-test, and two notes reading AI Quiz submission, result: ai-receptionist, with the answers
The test contact: tags on the left, the workflow's notes in the timeline.
Two things to tidy in your version. In our run the note stored answer codes ("q1":"a") instead of the answer text, and the phone number didn't reach the contact. Ask for both up front, or paste the follow-up below.
Fix prompt
In the CRM note, write each question and the answer text the visitor picked, not answer codes. Also save the phone number from the lead form on the contact.
When it passes every check

Publish, share and tweak

Publish once the test contact looks right. Type "Publish this app." and read the card before you approve it. It tells you if this is the first publish and if a new charge applies. Then put the quiz link in your bio, emails or ads.

A Publish App approval card reading: First publish of this app, it gets a new link of its own. No new charge, this app already pays its monthly fee. With Deny and Approve buttons
The publish card in our run. The app already had a backend, so publishing added no new charge.

Follow-up prompts to try:

  • Add a fifth question about how many calls the business misses each week.
  • Show a Book a call button on the result screen that links to my calendar.
  • Change the accent color to teal and add my logo at the top.
If something looks off

Troubleshooting

Most issues here come from the webhook step or from test data. Here's what to do.

You seeWhyFix
Submissions save, but no contact appearsThe webhook URL isn't saved, or it came from a different agentCopy it from the Trigger step of the agent the assistant named, and paste it into the secure form
The Trigger step has no URLIt hasn't been generated yetClick Generate Webhook URL, then Apply, then Save
Extra fake rows in the admin pageThe assistant added test dataApprove its delete card, and keep the test-data rule in your prompt
A step says passed but the preview shows the Vite starter pageThe build step didn't write the UIAsk: "The preview still shows the Vite starter page. Build the quiz screens."
The admin page should show other tagged contactsApps can't read the CRMThat's a platform limit. It shows quiz submissions only
Quick answers

FAQ

Can a Votel web app write contacts to the CRM?

Yes, but only through a Votel workflow. The app's server function sends the quiz answers to a workflow with a webhook trigger, and the workflow looks up or creates the contact, adds the tags and saves the note.

Why can't the admin page list my CRM contacts?

Apps are walled off from the CRM and can't read contacts. The server function also saves a copy of each submission to the app's own table, and the admin page reads that table, so it shows quiz submissions only.

Where does the webhook URL go?

Into the Add your API keys form the assistant shows in the chat. It's encrypted when saved and goes straight to the app. Never paste it into the chat itself.

How long does the quiz app take to build?

About 40 minutes in our test, with approval cards for the backend, each table, deleting test rows, activating the workflow and publishing.

Your turn

Try it in Votel

Haven't built an app yet? Start with the ROI calculator, then come back for the quiz. Votel has a 14-day trial, then plans are $97 or $297 a month.

All Things Votel is an independent site, not operated by or affiliated with Votel.ai. Links to Votel are affiliate links. Built in a live account on November 21, 2026. Labels may change.