GuestIQ

GuestIQ is EveryBite’s real-time guest intelligence platform. It identifies guests the moment they open your menu, delivers their segments and behavioral history instantly, and feeds that intelligence into your loyalty and marketing systems.

The key insight: Traditional loyalty identifies guests after they purchase. GuestIQ identifies them before they browse—enabling personalization from the very first screen.

What GuestIQ Does

Why GuestIQ Matters

Traditional Loyalty Flow

With GuestIQ

GuestIQ moves identity resolution upstream—before the transaction, not after. This unlocks personalization at every step of the guest journey.

Core Capabilities

Instant Identity

Recognize guests at session start using device fingerprint, email, phone, or loyalty ID. Even returning guests without accounts can be identified.

Real-Time Segments

Primary segments (wheat-free, high-protein) and compound segments (wheat-free + high-protein) computed and delivered in milliseconds.

Behavioral Intelligence

Past orders, favorite dishes, customization patterns, visit frequency—delivered at session creation so you can act on it immediately.

Loyalty Integration

Feed rich behavioral data into your existing loyalty system via webhooks. Every signal enriches the guest profile.

How It Works

When you call startSession, GuestIQ returns intelligence alongside the session:

mutation StartSession {
  startSession(input: {
    chainId: "honeygrow"
    guestId: "loyalty_12345"
    platform: IOS
  }) {
    sessionId

    # GuestIQ Intelligence
    guestiq {
      identity {
        guestId
        identifiedVia
        confidence
        isReturning
      }
      segments {
        primary
        compound
      }
      cohorts
      history {
        lastVisit
        visitCount
        favoriteDishes
        avgOrderValue
        customizationRate
      }
      recommendations {
        type
        dishId
        reason
      }
    }
  }
}

Example Response

{
  "data": {
    "startSession": {
      "sessionId": "sess_7f3a9c2e-8b1d-4e5f-a6c0-9d2e8f1a3b5c",
      "guestiq": {
        "identity": {
          "guestId": "guest_abc123",
          "identifiedVia": "LOYALTY_ID",
          "confidence": 0.98,
          "isReturning": true
        },
        "segments": {
          "primary": ["wheat-free", "high-protein", "frequent-visitor"],
          "compound": [
            "wheat-free+high-protein",
            "wheat-free+frequent-visitor",
            "high-protein+frequent-visitor"
          ]
        },
        "cohorts": [
          "health-conscious-regulars",
          "weekday-lunch-crowd",
          "customizers"
        ],
        "history": {
          "lastVisit": "2026-01-20T12:30:00Z",
          "visitCount": 12,
          "favoriteDishes": ["dish_stir_fry", "dish_power_bowl"],
          "avgOrderValue": 18.50,
          "customizationRate": 0.73
        },
        "recommendations": [
          {
            "type": "HIGHLIGHT",
            "dishId": "dish_new_bowl",
            "reason": "Matches wheat-free + high-protein preferences"
          },
          {
            "type": "UPSELL",
            "dishId": "dish_protein_add",
            "reason": "Frequently adds extra protein"
          }
        ]
      }
    }
  }
}

Segments

GuestIQ computes two types of segments:

Primary Segments

Single-attribute segments based on dietary needs, behavior, or value:

Category	Examples
Dietary	`wheat-free`, `dairy-free`, `vegan`, `keto`, `halal`
Allergens	`peanut-free`, `shellfish-free`, `tree-nut-free`
Behavioral	`customizer`, `saver`, `browser`, `quick-orderer`
Preference	`spicy-lover`, `high-protein`, `low-carb`, `low-sodium`
Value	`high-frequency`, `high-aov`, `loyalty-member`, `new-guest`

Compound Segments

Combinations of primaries that create targetable micro-audiences: Every viable combination is pre-computed and targetable. This enables hyper-specific personalization and campaign targeting.

Cohorts

Pre-built audience groups based on behavioral patterns:

Cohort	Description
`health-conscious-regulars`	Frequent visitors who filter by dietary/nutrition
`weekday-lunch-crowd`	Visits primarily Mon-Fri 11am-2pm
`weekend-explorers`	Tries new dishes, visits Sat-Sun
`customizers`	High rate of BYO/modification usage
`value-seekers`	Responds to promotions, uses discounts
`high-value-loyalists`	High AOV + high frequency + loyalty member

Identity Resolution

GuestIQ identifies guests through multiple signals:

Method	Confidence	Description
`LOYALTY_ID`	Highest	Guest’s loyalty program ID passed in session
`PASSPORT_ID`	Highest	EveryBite Passport authentication
`EMAIL`	High	Email match from previous sessions
`PHONE`	High	Phone number match
`DEVICE_FINGERPRINT`	Medium	Browser/device characteristics
`BEHAVIORAL_MATCH`	Lower	Pattern matching against known profiles

Even without explicit authentication, GuestIQ can identify returning guests and surface their preferences.

Use Cases

Menu Personalization

Staff Alerts

Alert front-of-house when a high-value guest or someone with specific dietary needs arrives. “VIP guest, dairy allergy, prefers booth seating.”

Campaign Targeting

Target email/push campaigns to compound segments. Send your new vegan dessert promotion only to vegan + dessert-lover + opted-in guests.

Predictive Ordering

Use recommendations to pre-populate suggested items. Returning guests see their favorites and personalized suggestions immediately.

Loyalty Enrichment

Feed behavioral signals to your loyalty platform. Your CRM now knows not just what they bought, but what they browsed, customized, and saved.

Getting Started

Enable GuestIQ — Contact your EveryBite account manager to enable the GuestIQ module
Update Session Calls — Request guestiq fields in your startSession mutation
Act on Intelligence — Use segments, history, and recommendations to personalize the experience

Session Endpoint

GuestIQ data is returned in the startSession response

Roadmap

GuestIQ intelligence is available read-only via the startSession response. The following management APIs are planned for future releases.

Feature	Description	Status
Identity Management	Merge guest profiles, link identifiers across systems	Planned
Segment Analytics	Query segment metrics, trends, and overlap analysis	Planned
Signal Tracking	Track behavioral events to enrich guest profiles	Planned
Integrations	Webhooks, batch exports, and direct connections to Punchh, Thanx, Braze	Planned

Interested in early access? Contact your EveryBite account manager.

Overview

Core Concepts

SmartMenu API

Atlas

GuestIQ

What GuestIQ Does

Why GuestIQ Matters

Traditional Loyalty Flow

With GuestIQ

Core Capabilities

Instant Identity

Real-Time Segments

Behavioral Intelligence

Loyalty Integration

How It Works

Segments

Primary Segments

Compound Segments

Cohorts

Identity Resolution

Use Cases

Getting Started

Session Endpoint

Roadmap

​What GuestIQ Does

​Why GuestIQ Matters

​Traditional Loyalty Flow

​With GuestIQ

​Core Capabilities

Instant Identity

Real-Time Segments

Behavioral Intelligence

Loyalty Integration

​How It Works

​Segments

​Primary Segments

​Compound Segments

​Cohorts

​Identity Resolution

​Use Cases

​Getting Started

Session Endpoint

​Roadmap

What GuestIQ Does

Why GuestIQ Matters

Traditional Loyalty Flow

With GuestIQ

Core Capabilities

How It Works

Segments

Primary Segments

Compound Segments

Cohorts

Identity Resolution

Use Cases

Getting Started

Roadmap