Forms Overview
Build public intake forms that create support conversations.
Forms Overview
RogerIQ forms are schema-driven intake surfaces. They are useful for contact forms, bug reports, quote requests, onboarding surveys, and any support workflow that needs structured fields before a conversation starts.
Form Capabilities
| Capability | Description |
|---|---|
| Custom fields | Text, long text, email, number, phone, checkbox, radio, select, multi-select, date, and file fields. |
| Hosted pages | Public RogerIQ-hosted form pages. |
| Short routes | /f/:slugOrId for public access. |
| Embeds | iframe embeds, HTML POST, and JSON submit. |
| Success handling | Inline success message or redirect URL. |
| Origin controls | Optional allowed origin list. |
| Spam protection | Honeypot, rate limit, FingerprintIQ, and Turnstile on hosted pages. |
| Inbox creation | Each accepted submission creates a conversation. |
Form Lifecycle
1
Create a form
Define name, slug, fields, success behavior, rate limits, and allowed origins.
2
Publish or embed
Use the hosted page, iframe, HTML POST, JSON endpoint, or beacon.
3
Receive submissions
Submissions create conversations and store the structured payload.
4
Review in Inbox
Agents can respond, assign, tag, and resolve the conversation like any other support thread.
Public Endpoints
| Endpoint | Description |
|---|---|
GET /api/forms/:id/public | Fetch form schema. |
POST /api/f/:formId | Submit JSON, multipart form data, or HTML form data. |
GET /forms/:formId | Hosted form route on rogeriq.com. |
GET /f/:slugOrId | Short hosted form route on rogeriq.com. |
Use forms when you need structured intake. Use the widget when a visitor needs search, AI answers, previous messages, and chat.