# Smart Identity Validator Suite - Complete Plugin Guide

 

## 🌟 Overview

 

The **Smart Identity Validator Suite** is a comprehensive Bubble.io plugin that provides enterprise-grade identity validation and data verification services. This plugin integrates multiple AbstractAPI services to offer a complete solution for validating emails, phone numbers, VAT numbers, IP geolocation, and generating custom avatars.

 

## 🚀 Features & Services

 

### 1. 📧 Email Validation Service

**Purpose**: Validates email addresses with comprehensive checks including format validation, SMTP verification, and deliverability analysis.

 

**Key Features**:

- ✅ Format validation

- ✅ SMTP server verification

- ✅ MX record validation

- ✅ Disposable email detection

- ✅ Free email provider identification

- ✅ Role email detection (admin@, info@, etc.)

- ✅ Quality scoring

- ✅ Autocorrect suggestions

 

**API Key Required**: `abstract_email_validation_key`

 

### 2. 📊 Email Reputation Analysis

**Purpose**: Advanced email reputation analysis with detailed security and deliverability insights.

 

**Key Features**:

- ✅ Advanced deliverability analysis

- ✅ Domain reputation scoring

- ✅ DMARC/SPF validation

- ✅ Suspicious username detection

- ✅ Breach history analysis

- ✅ Organization information

- ✅ Domain age and registration details

 

**API Key Required**: `abstract_email_reputation_key`

 

### 3. 📱 Phone Number Validation

**Purpose**: International phone number validation with formatting and carrier information.

 

**Key Features**:

- ✅ International format validation

- ✅ Country detection

- ✅ Local and international formatting

- ✅ Carrier information

- ✅ Phone type detection (mobile, landline, etc.)

- ✅ Location information

 

**API Key Required**: `abstract_phone_validation_key`

 

### 4. 🏢 VAT Number Validation

**Purpose**: European VAT number validation with company information retrieval.

 

**Key Features**:

- ✅ VAT number format validation

- ✅ Company information retrieval

- ✅ Country verification

- ✅ Address validation

- ✅ Real-time verification

 

**API Key Required**: `abstract_vat_validation_key`

 

### 5. 🌍 IP Geolocation & Intelligence

**Purpose**: Comprehensive IP geolocation with security analysis and threat detection.

 

**Key Features**:

- ✅ Geographic location detection

- ✅ Timezone information

- ✅ Currency and language detection

- ✅ ISP and network information

- ✅ VPN/Proxy detection

- ✅ Threat analysis

- ✅ Security scoring

 

**API Keys Required**:

- `abstract_ip_geolocation_key` (for geolocation)

- `abstract_ip_intelligence_key` (for security analysis)

 

### 6. 👤 Avatar Generator

**Purpose**: Generate custom avatars with initials and personalized styling options.

 

**Key Features**:

- ✅ Customizable background colors

- ✅ Font color options

- ✅ Multiple image formats (PNG, SVG)

- ✅ Size customization

- ✅ Font styling (bold, italic, uppercase)

- ✅ Character limit control

- ✅ Rounded/square options

 

**API Key Required**: `abstract_avatar_api_key`

 

## 🔧 Installation & Setup

 

### Step 1: Plugin Installation

1. Go to your Bubble app

2. Navigate to **Plugins** in the sidebar

3. Click **Add plugins**

4. Search for **"Smart Identity Validator Suite"**

5. Click **Install**

6. Confirm installation

 

### Step 2: API Keys Configuration

1. Go to **Settings** → **API**

2. Scroll to **API Keys** section

3. Add the following keys:

 

```

abstract_email_validation_key: [YOUR_EMAIL_VALIDATION_KEY]

abstract_email_reputation_key: [YOUR_EMAIL_REPUTATION_KEY]

abstract_phone_validation_key: [YOUR_PHONE_VALIDATION_KEY]

abstract_vat_validation_key: [YOUR_VAT_VALIDATION_KEY]

abstract_ip_geolocation_key: [YOUR_IP_GEOLOCATION_KEY]

abstract_ip_intelligence_key: [YOUR_IP_INTELLIGENCE_KEY]

abstract_avatar_api_key: [YOUR_AVATAR_API_KEY]

```

 

**⚠️ Important**: Key names must be exactly as shown above. Do not change spelling or underscores.

 

### Step 3: AbstractAPI Account Setup

1. Visit [AbstractAPI](https://www.abstractapi.com/)

2. Create a free account

3. Subscribe to the required services:

   - Email Validation API

   - Email Reputation API

   - Phone Validation API

   - VAT Validation API

   - IP Geolocation API

   - IP Intelligence API

   - Avatar Generator API

4. Copy your API keys from the dashboard

5. Add them to your Bubble app as shown in Step 2

 

## 📋 Service Configuration Tables

 

### Email Validation Service

 

| Input Field | Type | Required | Description |

|-------------|------|----------|-------------|

| `email` | Text | ✅ Yes | Email address to validate |

 

| Output Field | Type | Description |

|--------------|------|-------------|

| `email` | Text | Validated email address |

| `suggestion` | Text | Correction suggestion if applicable |

| `deliverability` | Text | Deliverability status (deliverable/undeliverable) |

| `quality_score` | Number | Email quality score (0-1) |

| `is_valid_format` | Boolean | Whether the email format is valid |

| `is_free_email` | Boolean | Whether it's a free email provider |

| `is_disposable` | Boolean | Whether it's a disposable email |

| `is_role_email` | Boolean | Whether it's a role email (admin@, info@, etc.) |

| `is_mx_found` | Boolean | Whether MX records were found |

| `is_smtp_valid` | Boolean | Whether the SMTP server responds |

 

### Email Reputation Service

 

| Input Field | Type | Required | Description |

|-------------|------|----------|-------------|

| `email` | Text | ✅ Yes | Email address to analyze |

 

| Output Field | Type | Description |

|--------------|------|-------------|

| `deliverability_status` | Text | Detailed deliverability status |

| `deliverability_detail` | Text | Specific analysis details |

| `quality_score` | Number | Advanced quality score |

| `is_username_suspicious` | Boolean | Whether the username is suspicious |

| `is_disposable` | Boolean | Whether it's a disposable email |

| `is_catchall` | Boolean | Whether the domain is catch-all |

| `is_role_email` | Boolean | Whether it's a role email |

| `is_dmarc_enforced` | Boolean | Whether DMARC is enforced |

| `is_spf_strict` | Boolean | Whether SPF is strict |

| `email_age_days` | Number | Estimated email age in days |

| `provider_name` | Text | Email provider name |

| `organization_name` | Text | Organization name |

| `domain` | Text | Email domain |

| `domain_age` | Number | Domain age in days |

| `total_breaches` | Number | Number of data breaches |

| `first_breached` | Text | First breach date |

| `last_breached` | Text | Last breach date |

 

### Phone Validation Service

 

| Input Field | Type | Required | Description |

|-------------|------|----------|-------------|

| `phone` | Text | ✅ Yes | Phone number to validate |

 

| Output Field | Type | Description |

|--------------|------|-------------|

| `phone` | Text | Validated phone number |

| `valid` | Boolean | Whether the phone number is valid |

| `format_international` | Text | International format |

| `format_local` | Text | Local format |

| `country_code` | Text | Country code |

| `country_name` | Text | Country name |

| `country_prefix` | Text | Country calling prefix |

| `location` | Text | Location information |

| `type` | Text | Phone type (mobile, landline, etc.) |

| `carrier` | Text | Carrier information |

 

### VAT Validation Service

 

| Input Field | Type | Required | Description |

|-------------|------|----------|-------------|

| `vat_number` | Text | ✅ Yes | VAT number to validate |

 

| Output Field | Type | Description |

|--------------|------|-------------|

| `vat_number` | Text | Validated VAT number |

| `valid` | Boolean | Whether the VAT number is valid |

| `country_code` | Text | Country code |

| `country_name` | Text | Country name |

| `company_name` | Text | Company name |

| `company_address` | Text | Company address |

 

### IP Geolocation Service

 

| Input Field | Type | Required | Description |

|-------------|------|----------|-------------|

| `debug_mode` | Boolean | ❌ No | Enable detailed logging |

 

| Output Field | Type | Description |

|--------------|------|-------------|

| `ip_address` | Text | Detected IP address |

| `country` | Text | Country name |

| `country_code` | Text | Country code |

| `country_is_eu` | Boolean | Whether country is in EU |

| `region` | Text | Region/State |

| `region_code` | Text | Region code |

| `city` | Text | City |

| `postal_code` | Text | Postal code |

| `continent` | Text | Continent |

| `continent_code` | Text | Continent code |

| `latitude` | Number | Latitude coordinate |

| `longitude` | Number | Longitude coordinate |

| `timezone` | Text | Timezone name |

| `timezone_abbreviation` | Text | Timezone abbreviation |

| `timezone_offset` | Number | GMT offset |

| `current_time` | Text | Current time in timezone |

| `is_dst` | Boolean | Whether daylight saving time is active |

| `currency` | Text | Currency code |

| `currency_name` | Text | Currency name |

| `flag_emoji` | Text | Country flag emoji |

| `flag_png` | Text | Flag PNG URL |

| `flag_svg` | Text | Flag SVG URL |

| `isp_name` | Text | ISP name |

| `organization` | Text | Organization name |

| `connection_type` | Text | Connection type |

| `vpn_detected` | Boolean | Whether VPN is detected |

| `proxy_detected` | Boolean | Whether proxy is detected |

| `tor_detected` | Boolean | Whether Tor is detected |

| `is_threat` | Boolean | Whether IP is a threat |

| `is_abuser` | Boolean | Whether IP is a known abuser |

| `browser_language` | Text | Browser language |

 

### Avatar Generator Service

 

| Input Field | Type | Required | Description |

|-------------|------|----------|-------------|

| `name` | Text | ✅ Yes | Name for avatar generation |

| `image_size` | Number | ❌ No | Image size in pixels |

| `image_format` | Text | ❌ No | Image format (png, svg) |

| `font_size` | Number | ❌ No | Font size |

| `char_limit` | Number | ❌ No | Character limit |

| `background_color` | Color | ❌ No | Background color |

| `font_color` | Color | ❌ No | Font color |

| `is_rounded` | Boolean | ❌ No | Whether avatar is rounded |

| `is_uppercase` | Boolean | ❌ No | Whether text is uppercase |

| `is_italic` | Boolean | ❌ No | Whether text is italic |

| `is_bold` | Boolean | ❌ No | Whether text is bold |

 

| Output Field | Type | Description |

|--------------|------|-------------|

| `avatar_url` | Text | Generated avatar URL |

 

## 🛠️ Implementation Examples

 

### Email Validation Workflow

1. Add the **Email Validation** action to your workflow

2. Set the `email` parameter to the email you want to validate

3. Use the exposed states to:

   - Display validation results

   - Show quality score

   - Apply conditional formatting based on deliverability

   - Trigger different actions based on validation results

 

### Phone Validation Workflow

1. Add the **Phone Validation** action to your workflow

2. Set the `phone` parameter to the phone number to validate

3. Use the exposed states to:

   - Format the phone number for display

   - Show country information

   - Apply validation styling

   - Store formatted numbers in your database

 

### IP Geolocation Element

1. Add the **IP Geolocation** element to your page

2. Configure the `debug_mode` if needed

3. Use the exposed states to:

   - Display user location

   - Show relevant content based on country

   - Apply timezone-specific features

   - Detect VPN/proxy usage for security

 

### Avatar Generation

1. Add the **Avatar Generator** action to your workflow

2. Set the `name` parameter (required)

3. Configure optional styling parameters

4. Use the `avatar_url` to display the generated avatar

 

## 📊 Free Plan Limits

 

| Service | Monthly Limit | Rate Limit |

|---------|---------------|------------|

| Email Validation | 100 | Unspecified |

| Email Reputation | 50 | Unspecified |

| Phone Validation | 100 | Unspecified |

| VAT Validation | 50 | Unspecified |

| IP Geolocation | 1,000 | Unspecified |

| IP Intelligence | 1,000 | Unspecified |

| Avatar Generator | 100 | Unspecified |

 

## 🔒 Security & Privacy

 

- All API calls are made server-side for security

- API keys are stored securely in Bubble's encrypted environment

- No sensitive data is logged or stored

- All services comply with GDPR and privacy regulations

- HTTPS encryption for all API communications

 

## 🐛 Troubleshooting

 

### Common Issues

 

**"API key not found" error**

- Verify the API key name is exactly as specified

- Check that the key is added in Settings → API → API Keys

- Ensure the key is active in your AbstractAPI dashboard

 

**"Field editors are missing" error**

- Verify all input and output fields are properly defined in the plugin editor

- Check that field names match exactly between code and plugin configuration

- Ensure all required fields are marked as required

 

**Service not working**

- Check your AbstractAPI account for service activation

- Verify you haven't exceeded monthly limits

- Check the API key permissions in AbstractAPI dashboard

 

### Debug Mode

Enable debug mode in the IP Geolocation element to see detailed logs in the browser console for troubleshooting.

 

## 📞 Support

 

For technical support or questions:

- Check the AbstractAPI documentation for each service

- Review the Bubble plugin documentation

- Contact the plugin developer through the Bubble marketplace

 

## 🔄 Updates & Maintenance

 

The plugin is regularly updated to:

- Maintain compatibility with Bubble platform updates

- Add new features and improvements

- Fix bugs and security issues

- Update API integrations as needed

 

---

 

**Version**: 1.0  

**Last Updated**: 2024  

**Compatibility**: Bubble.io Platform