Skip to main content

Field Marketing & QR Event Subsystem

HiTech Insurance actively deploys field agents to major trucking conventions, logistics expos, and trade shows across North America (e.g., Great American Trucking Show, Texas Trucking Expo).

The Field Marketing & QR Event Subsystem provides field marketing infrastructure enabling rapid campaign provisioning, dynamic attendee questionnaire generation, vanity QR code generation, and licensed agent commission attribution.

1. End-to-End Field Campaign Lifecycle​

2. Dynamic Schema Form Builder (EventFormField)​

Different industry conventions require different underwriting intake questionnaires. Rather than requiring code deployments to alter form fields, each EventCampaign embeds a schema-driven array of field definitions (IEventFormField):

export interface IEventFormField {
  id: string; // e.g. "fleet_size", "equipment_type", "preferred_language"
  label: string; // e.g. "How many power units do you operate?"
  type: "text" | "number" | "email" | "tel" | "select" | "time" | "date" | "textarea";
  placeholder?: string;
  required: boolean;
  options?: string[]; // e.g. ["1-2 Units (Owner Operator)", "3-10 Units (Small Fleet)", "11+ Units (Fleet)"]
  defaultValue?: string;
  order: number;
}

The attendee interface (src/components/feature/events/attendee-event-form.tsx) iterates these definitions, dynamically rendering accessible form controls with client-side Zod validation.

3. Short URL Architecture & Edge Redirection (/e/:slug)​

Printed marketing flyers and exhibition booth banners require compact, easily readable URLs:

  • Vanity Short URL: https://hitechinsurance.ai/e/dallas-truck-expo
  • Middleware Interception: In src/middleware.ts, requests matching /e/:slug are intercepted at the edge: 
    if (req.nextUrl.pathname.startsWith("/e/")) {
      const redirectUrl = new URL(`/en${req.nextUrl.pathname}${req.nextUrl.search}`, req.url);
      return Response.redirect(redirectUrl, 307);
    }
  • Preserved Attribution: Query parameters (such as ?agent=AGT-01 or ?source=booth_banner) are automatically preserved through the 307 redirect.

4. Licensed Agent Attribution (EventAgent)​

To incentivize field teams and track operational return on investment (ROI):

  • Multiple licensed agents can be attached to a campaign in EventAgent.
  • Each agent receives a unique alphanumeric code (agentCode).
  • Attendees entering an agent code (or scanning an agent-specific QR badge) have their leads automatically attributed to that agent's performance record (totalLeadsCaptured).

5. Mobile-Optimized Attendee Intake (AttendeeEventForm)​

Convention floors often suffer from congested cellular towers. The attendee capture interface is engineered for speed and touch ergonomics:

  • One-Thumb Touch Targets: Large tap zones for checkboxes and select dropdowns.
  • Offline Resilience: If connection drops temporarily, form inputs are retained in client state.
  • Instant Digital vCard: Upon submission, the attendee receives a downloadable .vcf digital business card file containing the agency underwriter's phone number and direct email.