GuidesRecipesAPI ReferenceChangelog
Changelog
Back to All

November 2023 Update

11 months ago by Francesco Panina

Enhanced PHONE API now includes detailed caller identification, advanced number type detection, Viber connectivity features, and comprehensive WhatsApp Business field integration.

🆕 PHONE API: Caller Name and Caller Type Detection

We're excited to announce a significant enhancement to our PHONE API, especially for our users in the US market. Trustfull now offers four new signals to provide more detailed information about phone calls. This update aims to enhance user experience and trust assessments in real-time communication.

New Features:

first_name:

This field will return the first name associated with the incoming phone number.

last_name:

Along with the first name, the API will also provide the last name associated with the phone number.

caller_type:

This feature categorizes the caller, such as 'CONSUMER' or 'BUSINESS'

caller_company_name:

For business-related caller_type, this signal will provide the name of the company associated with the incoming number.

Ready to Use:

This feature is now live and available for all our users in the US market. No additional setup is required for existing users of our PHONE API.

{
    "resolution_id": "...",
    "customer_id": "...",
    "device_request_time": "...",
    "webhook_url": "...",
    "claims": [
        "phone"
    ],
    "value": "...",
    ...
    "first_name": "Tony",
    "last_name": "Stark",
    "caller_type": "CONSUMER"
  
}

✨ PHONE API: enhanced number type detection

In the US, it is often complex to infer the number type just by looking at the format of the number. There are indicators that a phone number is mobile, landline, or other. With this new feature, our number type detection gets even more accurate and is able to differentiate from MOBILE, FIXED_LINE, or VOIP.

The integration remains the same; you don't need to change your current setup:

{
    "resolution_id": "...",
    "customer_id": "...",
    "device_request_time": "...",
    "webhook_url": "...",
    "claims": [
        "phone"
    ],
    "value": "...",
    ...
    "number_type": "VOIP"
  
}

The taxonomy also remains the same and is available in our docs: PHONE API DOCS

  • FIXED_LINE: A fixed line phone number
  • MOBILE: A mobile phone number
  • FIXED_LINE_OR_MOBILE: A phone number that could be either fixed line or mobile
  • TOLL_FREE: A toll-free phone number
  • PREMIUM_RATE: A phone number that charges premium rates
  • SHARED_COST: A phone number that shares the cost between the caller and recipient
  • VOIP: A phone number that uses voice-over IP technology
  • PERSONAL_NUMBER: A personal phone number
  • PAGER: A pager number
  • UAN: A universal access number
  • UNKNOWN: An unknown phone number type
  • EMERGENCY: An emergency phone number
  • VOICEMAIL: A voicemail number
  • SHORT_CODE: A short code number
  • STANDARD_RATE: A phone number that charges standard rates

🚀 PHONE API: Viber

We are excited to introduce two new features in this release that enhance user-profiles and Phone API within our platform: has_viber, viber_full_name, and viber_last_seen.

What is Viber?

Viber is a popular communication app that allows users to make phone calls, send messages, and share media, all via the Internet. With a vast user base, Viber is an essential tool for connecting people across the globe. It offers various functionalities including group chats, video calls, and more, making it a versatile and widely used platform.

phone_has_viber

The has_viber feature enables our system to automatically check if a phone number is registered with a Viber account. If a Viber account is linked to the phone number, the feature returns a true value, indicating that the user is reachable via Viber.

phone_viber_full_name

With viber_full_name, you can now access the full name of a user as registered on their Viber profile. This field is not mandatory during registration so we can have incomplete or missing data.

phone_viber_last_seen

The viber_last_seen feature provides the time since the user was last active on Viber. The number represents how many days ago the user connected to his Viber account. This can help us spot inactive or active accounts.

{
    "resolution_id": "...",
    "customer_id": "...",
    "device_request_time": "...",
    "webhook_url": "...",
    "claims": [
        "phone"
    ],
    "value": "...",
    ...
    "has_viber": true,
    "viber_full_name": "Tony Stark",
    "viber_last_seen": 3
  
}

✨ PHONE API: WhatsApp Business Fields

We're thrilled to announce our latest addition to the PHONE API, aimed specifically at enhancing information when the WhatsApp account is business.

New Features:

is_whatsapp_business (boolean):

This field identifies if the associated phone number is linked to a WhatsApp Business profile.

whatsapp_business_email (string):

Provides the business email address associated with the WhatsApp Business profile.

whatsapp_business_category (string):

Reveals the category of the business, such as 'Technology', 'Retail', etc.

whatsapp_business_description (string):

Offers a brief description of the business, giving you a snapshot of what the company represents.

whatsapp_business_products_review_status (string):

Indicates the review status of the business's products, such as 'APPROVED'.

whatsapp_business_products_price_avg (number):

Shows the average price of the products the business offers

whatsapp_business_products_price_std (number):

This field represents the standard deviation in the pricing of the business's products, offering a sense of the price range variability.

whatsapp_business_products_currencies (string):

Displays the currencies in which the business operates

{  
  "phone_number": "...",  
  "is_whatsapp_business": true,  
  "whatsapp_business_email": "[email protected]",  
  "whatsapp_business_category": "Technology",  
  "whatsapp_business_description": "We are a technology company",  
  "whatsapp_business_products_review_status": "APPROVED",  
  "whatsapp_business_products_price_avg": "55000",  
  "whatsapp_business_products_price_std": "0.0",  
  "whatsapp_business_products_currencies": "USD"  
}

This feature is now live and no additional setup is required for existing users of our PHONE API.

For any questions, or if you need assistance with the new features, our dedicated support team is always ready to help. Reach out to us anytime for support or guidance.

📚 Resources