Hook Name: INCOMINGCALL_POPUP_WIDGET
The INCOMINGCALL_POPUP_WIDGET hook enables the registration of a custom component that can display additional data retrieved from third-party APIs or internal sources. Using this hook, developers can modify the default phone call popup behavior and inject useful insights such as customer details, previous interactions, order history, or real-time data from external systems. VTAP.Component.Register(INCOMINGCALL_POPUP_WIDGET, {}, VTAP.Component.Load('CUSTOM_COMPONENT_NAME', 'MODULE')); INCOMINGCALL_POPUP_WIDGET - The predefined VTAP hook for the incoming call pop-up widget.
- It ensures that the registered component gets executed when a call is received.
COMPONENT_NAME - This is the custom component that handles various operations inside the pop-up.
- It manages the UI rendering, API calls, and any business logic required to fetch and display data.
MODULE - Refers to the Vtiger module where the component is defined.
- It should contain all the necessary files, including templates and scripts, for the custom pop-up extension.
Consider the images below to compare a standard incoming call pop-up with an enhanced call pop-up.
Standard Incoming Call Pop-up

Enhanced Incoming Call Pop-up with External Insights 
Use Case: Real-time Shopper Insights for Enhanced Support A shopper contacts a shopping mall’s customer support to inquire about available offers or their account status. Proposed Enhancement: When the call connects, the system automatically identifies the shopper using their registered phone number. It instantly retrieves their profile and displays key details to the support agent, including: - Total loyalty points accumulated
- Membership status (Regular, Gold, Platinum)
- Duration of association with the mall
- Purchase history highlights
- Eligibility for special offers or benefits
With this information, the agent can provide a personalized and efficient service without requiring the shopper to repeat details. Key Benefits - Provides instant access to shopper details for a personalized experience
- Saves time by eliminating the need for repetitive questions
- Enhances trust and improves the overall shopping experience
- Encourages repeat visits and increased use of loyalty benefits
Example Interaction: The Shopper calls the support desk.
Agent: "Good evening, Ms. Nair! I see you’ve been shopping with us for over five years and have accumulated 3,200 loyalty points. As a Gold Member, you're eligible for exclusive weekend offers. How can I assist you today?"
Shopper: "I wanted to check if I can redeem my points on the new arrivals."
Agent: "Absolutely! Your points are valid for redemption on selected new arrivals. I can also share the list of eligible items if you’d like." We believe these examples will improve your experience with Vtiger CRM. We want to ensure that developers and CRM users can mutually share information and knowledge to further the functionality of the CRM. Stay tuned for more. Happy Coding! |