Knowledge Base
Behavioral Tokens Reference
here are all the behavioral and engagement tokens you can use at your organization to personalize based on visitor actions and AI analysis:
AI Scoring & Engagement Tokens
Visitor Score & Status
| Token | What It Shows | Example Value | Use Case |
|---|---|---|---|
| {{raw:visitor.score}} | Current AI engagement score (0-100) | 85 | Trigger campaigns for high-intent visitors |
| {{raw:visitor.lead_score}} | Lead qualification score | 72 | Sales prioritization, routing |
| {{raw:score.total_score}} | Overall engagement score | 68 | Campaign segmentation |
| {{raw:visitor.score_breakdown}} | Detailed scoring analysis | Intent: High, Engagement: 4 visits | Show why someone is qualified |
| {{raw:visitor.status}} | Lead status classification | known, anonymous, DQL | Different messaging by status |
| {{raw:visitor.is_dql}} | Discussion Qualified Lead status | true/false | Trigger sales alerts for DQLs |
Segmentation Tokens
AI Segments & Lists
| Token | What It Shows | Example Value | Use Case |
|---|---|---|---|
| {{raw:visitor.segment}} | Current AI segment assignment | High Intent Enterprise | Personalize content by segment |
| {{raw:visitor.segments}} | All segments (if multiple) | Enterprise, Product Interested | Multi-segment targeting |
| {{raw:visitor.list}} | Static list membership | Webinar Attendees | Event follow-ups |
Behavioral Status Tokens
Visitor State & Engagement
| Token | What It Shows | Typical Values | Use Case |
|---|---|---|---|
| {{raw:visitor.known}} | Whether visitor is identified | true/false | Show different content for known vs anonymous |
| {{raw:visitor.is_known}} | Alias for known status | true/false | Same as visitor.known |
| {{raw:visitor.returning}} | Return visitor flag | true/false | Welcome back messages |
| {{raw:visitor.first_visit}} | First-time visitor flag | true/false | Onboarding campaigns |
Usage Examples
Score-Based Personalization
You're highly engaged! Let's schedule a demo. Your engagement score: Learn more about how we can help.
DQL-Triggered Content
Great news! Based on your engagement, we'd love to connect you with our team. Your score breakdown:
Segment-Based Messaging
As an enterprise organization, you'll benefit from.. Perfect for growing teams like yours.. Let's find the right fit for.
Known vs Anonymous Visitors
Welcome back! Your current score: Welcome! Let's get to know each other.
Combining Behavioral Tokens
Subject: Priority Access for Exclusive Insights for Body:
Hi, Based on your engagement (Score: ), you're eligible for priority onboarding. Our team is ready to help. You've been exploring our platform. Let's take the next step! Welcome to our community. Here's what you should know.. Segment: Status:
Hi, Based on your engagement (Score: ), you're eligible for priority onboarding. Our team is ready to help. You've been exploring our platform. Let's take the next step! Welcome to our community. Here's what you should know.. Segment: Status:
Where Behavioral Tokens Work
Token Support by Feature
| Feature/Location | Scoring Tokens | Segment Tokens | Status Tokens | Conditionals |
|---|---|---|---|---|
| Campaign Email Subject | Yes | Yes | Yes | No |
| Campaign Email Body | Yes | Yes | Yes | Yes |
| Agent Triggers | Yes | Yes | Yes | Yes |
| Agent Actions | Yes | Yes | Yes | Yes |
| Chat Responses | Yes | Yes | Yes | Yes |
| Landing Pages | Yes | Yes | Yes | Yes |
Pro Tips for Behavioral Tokens
- Use score thresholds (>80, >50) to create tiered messaging
- Combine visitor.is_dql with visitor.score_breakdown to show why someone qualified
- Use visitor.segment for broad categorization, visitor.score for specific intent
- Always include fallbacks: visitor.segment || "General" prevents empty displays
- Test conditionals with both high and low scores to verify all branches work
- Use visitor.known to gate premium content or CTAs for identified visitors only
these behavioral tokens let your organization dynamically respond to how visitors engage with your site. The AI scoring and segmentation happen automatically, and these tokens give you the power to act on that intelligence in real-time across campaigns, emails, and agent workflows.
GPTWeb is the future of engagement, websites and marketing automation combined - built for the AI era, built for now.