Key Concepts
Accounts & Organizations
Each TrolleyShield account represents an organization (business, agency, etc.). Users can belong to multiple organizations, and each organization has its own:
- Tracking numbers
- Form Shield configuration
- Billing and subscription
- Usage limits
Roles
| Role | Permissions |
|---|---|
| Owner | Full access, billing, member management, delete org |
| Admin | Manage numbers, settings, view analytics |
| Viewer | View-only access to dashboard and analytics |
Intent Classification
TrolleyShield uses AI (Google Gemini) to classify the intent of every call and form submission.
Call Shield Intents
| Intent | Description | Action |
|---|---|---|
high_intent | Caller is ready to buy or book | Fire conversion |
medium_intent | Caller is interested but not committed | Fire conversion |
low_intent | General inquiry, not a strong lead | Nurture |
existing_customer | Caller is an existing customer | Ignore |
spam | Robocall, telemarketer, scam | Block |
wrong_number | Caller reached the wrong business | Ignore |
incomplete | Call too short to classify | Ignore |
Form Shield Intents
| Intent | Description | Action |
|---|---|---|
legitimate | Real person with genuine inquiry | Allow |
spam | Generic spam content | Block |
bot | Automated/bot submission | Block |
phishing | Phishing or social engineering | Block |
suspicious | Uncertain, needs review | Flag |
Conversions
When a call or form submission is classified as high or medium intent and has Google Ads attribution data (gclid, gbraid, or wbraid), TrolleyShield automatically fires an offline conversion via the Google Ads API or GA4 Measurement Protocol.
License Keys
Each account has a license key used to authenticate external integrations:
- Form Shield WordPress plugin uses the license key to connect to TrolleyShield
- DNI script uses the license key for number assignment requests
- License keys can be regenerated from Settings without affecting your subscription