ZeroBounce: Email Validation

Purpose:
This function provides comprehensive email validation by combining regex pattern matching with ZeroBounce's powerful email verification service. It's designed for chatbots and automated workflows that need reliable email validation while maintaining user privacy.

Key Features:
- Initial regex validation for basic email format
- Advanced validation through ZeroBounce API
- User-friendly, privacy-focused error messages
- Accepts specific status/substatus combinations:
 - Valid (all substatuses)
 - Abuse (all substatuses)
 - Catch-all (all substatuses)
 - Unknown with greylisted substatus
 - Do-not-mail with role_based substatus
 - Do-not-mail with role_based_catch_all substatus

Technical Details:
- Input: Text containing email address
- Output:
 - EmailisValid: Boolean validation result
 - EmailvalidationMessage: User-friendly message
 - Status and substatus codes
 - Comprehensive metadata (name, location, domain info)
- Three response paths: valid, invalid, error
- Secure error handling with generic user messages

Status/Substatus Handling:
- Valid Combinations:
 - status: 'valid' (any substatus)
 - status: 'abuse' (any substatus)
 - status: 'catch-all' (any substatus)
 - status: 'unknown' + substatus: 'greylisted'
 - status: 'do_not_mail' + substatus: 'role_based'
 - status: 'do_not_mail' + substatus: 'role_based_catch_all'

- Invalid Combinations (Generic Error Message):
 - status: 'invalid' (all substatuses)
 - status: 'spamtrap' (all substatuses)
 - status: 'do_not_mail' (except role_based/role_based_catch_all)
 - status: 'unknown' (except greylisted)

Privacy & Security:
- Generic error messages protect system details
- Technical details stored in backend variables
- Secure API communication
- No sensitive information in user responses

Perfect For:
- User registration flows
- Lead generation forms
- Email list cleaning
- Customer data validation
- Marketing automation

Integration:
Easy to integrate into Voiceflow projects with clear input/output variables and straightforward path handling. Simply connect to your flow, provide the API key, and start validating emails.

This function balances thorough email validation with user privacy, making it ideal for both customer-facing applications and backend data verification processes.