Contact Messages

Overview

The Contact Messages module allows administrators to manage and respond to messages submitted through the website's contact form. This centralized system helps you track all customer inquiries, monitor response times, and maintain a complete communication history. Messages can be filtered, searched, exported, and managed efficiently with bulk actions.

Accessing Contact Messages

Navigation path: Dashboard > Communication > Contact Messages

Required permission: contact-messages.view

Key Features

• Message Management: View, read, reply to, and delete contact messages
• Status Tracking: Track message status (unread, read, replied, archived)
• Advanced Search: Search by name, email, subject, message content, or phone number
• Filtering: Filter by status, subject, date range, and quick filters
• Statistics Dashboard: View real-time statistics about message volume and status
• Internal Notes: Add private notes for team collaboration
• Export Functionality: Export messages to CSV, Excel, or PDF formats
• Bulk Actions: Perform actions on multiple messages simultaneously
• Email Integration: Reply directly via email with pre-filled subject lines
• Phone Integration: Click-to-call functionality for messages with phone numbers

Main Interface

Statistics Cards

At the top of the page, six statistics cards provide an at-a-glance overview:

• Total Messages: Total number of messages received
• Unread: Messages that haven't been opened yet (red indicator)
• Read: Messages that have been viewed but not replied (yellow indicator)
• Replied: Messages that have been responded to (green indicator)
• Archived: Messages moved to archive
• This Week: Messages received in the last 7 days

List View

The main list displays all contact messages with the following information:

• Checkbox: Select messages for bulk actions
• Status Badge: Visual indicator of message status (Unread, Read, Replied, Archived)
• Contact Info: Sender's name, email, and phone number (if provided)
• Subject: Message subject line
• Message Preview: First 100 characters of the message
• Date: When the message was received
• Actions: Quick action buttons (View, Delete)

Visual Indicators:

• Unread messages have a light saffron background highlight
• Status badges are color-coded: Red (Unread), Yellow (Read), Green (Replied), Gray (Archived)

Search and Filters

The filter panel provides multiple ways to find specific messages:

Search Field:

• Search across name, email, subject, message content, and phone number
• Real-time search as you type

Status Filter:

• All Status
• New
• Unread
• Read
• Replied
• Archived

Subject Filter:

• All Subjects
• General Inquiry
• Customer Support
• Sales Inquiry
• Partnership
• Feedback
• Other

Quick Filters:

• All Messages
• Unread Only
• Recent (last 7 days)
• Old (30+ days)

Date Range:

• Filter by date from and date to
• Useful for generating reports for specific time periods

Common Tasks

Task 1: Viewing Message Details

1. Navigate to Dashboard > Communication > Contact Messages
2. Locate the message you want to view in the list
3. Click the eye icon in the Actions column or click on the message row
4. The message details page displays:
   • Full message content
   • Sender information (name, email, phone)
   • IP address and user agent (for security tracking)
   • Current status
   • Read timestamp and who read it
   • Admin notes (if any)

What happens: The message is automatically marked as "read" when you view it for the first time.

Task 2: Marking Messages as Read/Unread

Individual Message:

1. Open the message details page
2. In the "Update Status" section, select the desired status from the dropdown
3. Click Update Status

Bulk Action:

1. On the messages list page, check the boxes next to messages you want to update
2. Select "Mark as Read" or "Mark as Unread" from the bulk action dropdown
3. Click Apply
4. Confirm the action

Expected result: Message status is updated and the status badge changes color accordingly.

Task 3: Replying to Messages

1. Open the message details page
2. In the "Quick Actions" section, click Reply via Email
3. Your default email client opens with:
   • To: Sender's email address
   • Subject: "Re: [Original Subject]"
4. Compose your reply in your email client
5. Send the email
6. Return to the admin panel
7. Update the message status to "Replied"
8. Optionally, add notes about your response in the "Admin Notes" field

Alternative: If a phone number is provided, click Call [Phone Number] to initiate a phone call.

Task 4: Adding Internal Notes

1. Open the message details page
2. Scroll to the "Update Status" section
3. In the "Admin Notes" textarea, type your notes
4. Click Update Status to save

Use cases for notes:

• Document actions taken
• Add context for other team members
• Record follow-up requirements
• Note customer preferences or special requests

Task 5: Deleting Messages

Single Message:

1. On the messages list, click the trash icon in the Actions column
2. Confirm the deletion in the popup dialog
3. The message is permanently deleted

From Details Page:

1. Open the message details page
2. Scroll to the "Quick Actions" section
3. Click the red Delete Message button
4. Confirm the deletion

Bulk Delete:

1. Check the boxes next to messages you want to delete
2. Select "Delete" from the bulk action dropdown
3. Click Apply
4. Confirm the action

Warning: Deleted messages cannot be recovered. Consider archiving instead of deleting for record-keeping.

Task 6: Archiving Messages

1. Select messages using checkboxes
2. Choose "Archive" from the bulk action dropdown
3. Click Apply

Or for individual messages:

1. Open the message details page
2. Change status to "Archived"
3. Click Update Status

Tip: Archived messages are hidden from the default view but can be accessed by filtering for "Archived" status.

Task 7: Exporting Messages

1. Apply any filters you want (status, date range, subject, etc.)
2. Click the Export button in the top right
3. Select your preferred format:
   • CSV: For spreadsheet applications
   • Excel: For Microsoft Excel with formatting
   • PDF: For printable reports
4. The file downloads automatically

Export includes:

• ID, Name, Email, Phone
• Subject and Message
• Status and IP Address
• User Agent (truncated)
• Created timestamp

Note: The export respects your current filters, so you can export specific subsets of messages.

Task 8: Using Bulk Actions

1. Check the "Select All" checkbox to select all visible messages, or
2. Individually check boxes next to specific messages
3. The selected count appears above the list
4. Choose an action from the dropdown:
   • Mark as Read
   • Mark as Unread
   • Mark as Replied
   • Archive
   • Delete
5. Click Apply
6. Confirm the action when prompted

Tip: Bulk actions are great for cleaning up old messages or updating status after a batch of responses.

Settings and Options

Message Status Field

• Type: Select dropdown
• Required: Yes
• Options: Unread, Read, Replied, Archived
• Description: Tracks the current state of the message
• Default: "Unread" for new messages

Admin Notes Field

• Type: Textarea
• Required: No
• Max Length: 1000 characters
• Description: Private notes visible only to administrators
• Use: Document actions, add context, or note follow-up requirements

Message Information (Read-Only)

• Name: Sender's full name
• Email: Sender's email address (clickable mailto link)
• Phone: Sender's phone number (clickable tel link, if provided)
• Subject: Message subject line
• Message: Full message content
• IP Address: Sender's IP address (for security tracking)
• User Agent: Browser and device information
• Created At: When the message was submitted
• Read At: When the message was first opened
• Read By: Administrator who first opened the message

Permissions

The following permissions control access to the Contact Messages module:

• contact-messages.view: Can view the contact messages list and details
• contact-messages.update: Can update message status and add notes
• contact-messages.delete: Can delete messages
• contact-messages.export: Can export messages to CSV/Excel/PDF
• contact-messages.bulk-action: Can perform bulk actions on multiple messages

Note: Users need the appropriate permission to perform each action. Without the delete permission, the delete button will not appear.

Tips and Best Practices

• Respond promptly: Aim to respond to messages within 24 hours to maintain good customer relations
• Use status effectively: Update status immediately after taking action to keep the team coordinated
• Add meaningful notes: Document important details in admin notes for future reference
• Regular cleanup: Archive or delete old messages monthly to keep the list manageable
• Export for records: Export messages quarterly for compliance and record-keeping
• Monitor statistics: Check the statistics cards daily to track message volume and response rates
• Use filters wisely: Create custom filter combinations for different workflows (e.g., "Unread + Last 7 days")
• Bulk actions for efficiency: Use bulk actions when processing multiple similar messages
• Check IP addresses: Review IP addresses for suspicious patterns or spam
• Coordinate with team: Use admin notes to communicate with other administrators about complex inquiries

Troubleshooting

Problem: Cannot see any messages

Solution:

• Check that you have the contact-messages.view permission
• Verify that the contact form on your website is working correctly
• Check if filters are applied that might be hiding messages
• Click "Clear" to reset all filters

Problem: Cannot reply to messages

Solution:

• Ensure your email client is configured correctly
• Check that the "Reply via Email" button opens your email application
• Verify the sender's email address is valid
• If the email link doesn't work, manually copy the email address and compose a message

Problem: Bulk actions not working

Solution:

• Ensure you have selected at least one message (checkboxes are checked)
• Verify you have the contact-messages.bulk-action permission
• Check that you've selected an action from the dropdown before clicking Apply
• Try refreshing the page and attempting the action again

Problem: Export not downloading

Solution:

• Check your browser's download settings and popup blocker
• Verify you have the contact-messages.export permission
• Try a different export format (CSV instead of PDF)
• Check that there are messages to export (filters might be excluding all messages)

Problem: Message status not updating

Solution:

• Verify you have the contact-messages.update permission
• Ensure you clicked the "Update Status" button after making changes
• Check for any error messages displayed on the page
• Try refreshing the page and updating again

Problem: Cannot delete messages

Solution:

• Verify you have the contact-messages.delete permission
• Ensure you confirmed the deletion in the popup dialog
• Check if the message is protected or has special restrictions
• Try archiving the message instead of deleting it

Related Modules

• Mail Configuration: Configure email settings for sending replies
• Audit Logs: Track who viewed or modified messages
• Notifications: Receive alerts for new contact messages
• General Settings: Configure site contact information