This function provides robust international phone number validation with detailed carrier and location information. Perfect for AI agents, chatbots, and conversational AI applications that need to validate phone numbers naturally within user conversations.

Key Features:

• Intelligent extraction of phone numbers from natural conversations

• Real-time validation against Numverify's database covering 232 countries

• Seamlessly handles both direct input (+1234567890) and conversational text ("my number is +1234567890")

• Returns comprehensive data including:

  • Carrier information

  • Geographic location

  • Line type (mobile, landline, etc.)

  • Local and international number formats

• Error-resistant with clear feedback messages

• Three logical paths: valid, invalid, and error states
  
  

Ideal For:

• AI Agents handling customer onboarding

• Virtual assistants collecting contact details

• Lead qualification chatbots

• User registration workflows

• Customer support verification

• Automated form filling
  
  

The function enhances AI agent interactions by maintaining natural conversation flow while performing thorough phone validation. It processes various input formats and generates clear, context-aware feedback that agents can seamlessly incorporate into their responses.

Technical Details:

• Requires numverify API key (available at numverify.com)

• Input variables:

  • phoneNumber (text)

  • apiKey (text)

• Output variables include validation status, formatted messages, and detailed phone data

• Built-in error handling for API failures and invalid inputs
  
  

Perfect for developers and conversation designers building sophisticated AI agents and chatbots that need reliable, conversational phone number validation in their Voiceflow projects.