MailboxAI – Webmail + AI Assistant For Perfex CRM

MailboxAI Overview & Embedded Webmail Layer for Perfex CRM

MailboxAI is a CodeIgniter-based PHP extension for Perfex CRM, engineered for agencies and internal IT teams to operate a complete webmail client inside the CRM workspace. The package removes the constant tab-switching between an external mail client and the CRM by mapping IMAP folders, unread counters, and message threads onto Perfex-native panels, modals, and Bootstrap styling, so the interface renders as part of the authenticated admin environment rather than an embedded afterthought. In day-to-day delivery workflows it allows sales, support, and operations staff to read, reply to, categorize, and convert inbound mail into CRM records — tasks, tickets, and leads — without leaving the platform.

Technical Specifications & Deployment Matrix

IMAP Ingestion & CRM Conversion Pipeline

The module’s core mechanism is a configurable sync engine that pulls IMAP messages into Perfex-managed storage and exposes them through a native inbox UI. Sync execution runs through three selectable modes: cron-based automated sync for production servers, a light sync mode with reduced overhead for shared hosting, and manual on-demand triggering. Folder mapping per mailbox account translates server-side Inbox, Sent, Drafts, Trash, Spam/Junk, and Archive directories into navigable CRM views, each carrying unread badges and total counters. A sync status indicator surfaces the last successful run and any transport error, giving administrators a diagnostic surface without log crawling.

Outbound traffic follows a separate SMTP configuration path per account, with stored signatures applied automatically at compose time. The compose and reply modals support To/CC/BCC autocomplete backed by Perfex data (staff, customers, contacts, leads), reusable email templates, file attachments, draft persistence, and a scheduled-send queue tracked in its own table. Auto-replies are governed by a rules engine — sender scope, subject “contains” matching with optional case sensitivity, once-per-sender frequency, cooldown minutes, daily maximums, weekends-only flags, and time-window restrictions — so out-of-office behavior behaves like a business rule set rather than a blind autoresponder.

Core Technical Capabilities of MailboxAI

• Multi-account mailbox engine: an admin table manages several IMAP/SMTP identities with independent folder mappings, signatures, and per-account AI preferences; staff switch mailboxes from a top selector suited to shared inboxes.
• On-demand AI layer: summarize unread batches, generate reply drafts, rewrite messages for clarity or brevity, summarize single long threads, and classify mail — every action is click-triggered, never automated, and respects mailbox-level tone, language, and length settings.
• One-click CRM conversion: an open email converts directly into a Perfex task, support ticket, or lead while retaining conversation context; teams needing deeper task oversight afterward can extend that workflow with Project Task Manage For Perfex CRM, a companion module operating on the same platform.
• Bulk triage operations: mark read/unread, star/unstar, apply or clear color-coded categories, and delete selected messages across the list view, with filters for unread, starred, and attachment-bearing mail plus keyword search over sender, subject, and snippet.

Production Implementation & Operational Resilience

Deployment follows the standard Perfex module path: upload the zip through Modules → Installed Addons, install, then configure sync behavior, permissions, and — optionally — an OpenAI API key with a selected model. This AI dependency is fully decoupled: without a key, or with the feature disabled in settings, the system degrades gracefully into a conventional webmail client, and no AI request fires unless a user explicitly invokes a summarize, classify, or improve action. OpenAI usage costs remain billed through the customer’s own provider account, and server-level access to the provider endpoint is a deployment prerequisite worth verifying on restricted hosts.

Attachment handling is configurable — administrators control how files are downloaded and stored to balance performance against disk footprint. Resilience surfaces also include the top-bar unread counter for staff visibility, per-account status monitoring in the central overview, and category/draft/schedule tables that preserve work-in-progress state. Email deletion is scoped locally, which protects source mailboxes from accidental mass removal during bulk operations. For organizations evaluating conversational AI on a separate stack, Chat AI: AI Assistant Chatbot App | Prompt Helper exists as an independent WordPress-based assistant application, distinct from this Perfex module’s mail-centric tooling. Environmental boundaries are explicit: email sync fidelity depends on the provider’s IMAP settings, and the light sync mode exists precisely for resource-constrained shared hosting where full cron jobs are impractical.