Contact360Tile Documentation

Purpose

The Contact360Tile component serves as a comprehensive dashboard tile within the Vantage analytics and data platform. It offers users a complete view of individual contacts, including relevant information, linked companies, deals, and activities related to that contact. This tile allows users to efficiently manage and analyze contact interactions, enhancing the overall customer relationship management (CRM) capabilities.

Settings

The Contact360Tile has several configurable settings that allow users to customize its behavior and appearance. Below is a detailed breakdown of each settings:

Title

1. Setting Name: title
2. Input Type: String
3. Functionality: This setting defines the main title displayed at the top of the tile. Changing this value will modify the heading visible to users, allowing for personalization based on user requirements.
4. Default Value: 'Contact 360'

Subtitle

1. Setting Name: subtitle
2. Input Type: String
3. Functionality: The subtitle provides additional context below the title, which can be used to display a brief description or status. Modifying this setting affects the subtitle text shown to users.
4. Default Value: '' (empty string)

Tile ID

1. Setting Name: id
2. Input Type: String
3. Functionality: This unique identifier is essential for dashboard management and data storage. It’s crucial for ensuring that tile data is correctly linked and stored in the dashboard.
4. Default Value: undefined (must be provided for the component to function)

How It Works

Component Lifecycle

1. State Management: The component manages several local states, including contacts, companies, deals, activities, loading states, errors, search queries, and the currently selected contact.
2. Data Fetching: Upon mounting, the loadAllData function is called, which fetches data related to contacts, companies, deals, and activities via API requests.
3. Conditional Rendering: The tile displays a search input for users to find contacts. Depending on the state of the selected contact, it can show a detailed view or simply a list of contacts.
4. Quick-Add Activity: Users can quickly add activities associated with a contact. This feature allows for efficient task management directly from the tile.

Data Expectations

The Contact360Tile expects the following data inputs:

1. Contacts: An array of contact objects that include fields like first_name, last_name, email, phone, company, etc.
2. Companies: An array of company objects to allow linking contacts to their respective companies.
3. Deals: An array of deals that can be associated with selected contacts.
4. Activities: An array of activities that provide details about previous interactions with contacts.

AI Integrations

The tile integrates with the useDashboardStore to manage tile data dynamically. This integration allows other dashboard components to access or make changes to the Contact360Tile's data context, improving collaboration and data-sharing efficiency across the analytics platform.

Billing Impact

The Contact360Tile does not impose direct billing impacts as it is a visualization component. However, the data fetching from the /api/apps/data endpoints could lead to increased costs in areas such as:

• API call limits
• Data transfer rates

Error Handling

The component includes error handling which detects any issues while fetching data, providing feedback to the user through the error state.

Use Cases & Examples

Use Case 1: Sales Management

A sales team can utilize the Contact360Tile to quickly view detailed profiles of potential customers (leads) and track their interaction history. The tile's search functionality enables sales reps to find contacts rapidly, while also adding notes for future follow-ups.

Use Case 2: Customer Support

Customer service representatives can use the tile to access the history of interactions with clients, pulling up relevant information quickly to assist in resolving issues. This helps in maintaining a high level of service and customer satisfaction.

Use Case 3: Event Management

Event coordinators can leverage the tile to manage participants effectively. Information about attending contacts can be maintained, along with their preferences and histories, ensuring personalized engagement.

Concrete Example Configuration

Use Case: Sales Management

In this scenario, a company might want to configure the Contact360Tile for its sales representatives.

Configuration Data Example:

{
    "title": "Sales Contact Overview",
    "subtitle": "Track all sales interactions",
    "id": "sales-contacts-tile"
}

Expected Behavior: The above configuration will set the tile’s title to "Sales Contact Overview" and the subtitle to "Track all sales interactions." This clear labeling helps sales reps know the specific focus of the tile as they navigate through their dashboard, enhancing usability and efficiency.