{"id":3479,"date":"2025-12-05T12:52:18","date_gmt":"2025-12-05T07:52:18","guid":{"rendered":"https:\/\/devdiligent.com\/blog\/?p=3479"},"modified":"2025-12-19T18:03:38","modified_gmt":"2025-12-19T13:03:38","slug":"build-enterprise-grade-automations-in-perfex-crm","status":"publish","type":"post","link":"https:\/\/devdiligent.com\/blog\/build-enterprise-grade-automations-in-perfex-crm\/","title":{"rendered":"How to Build Enterprise-Grade Automations in Perfex CRM (Without Any Paid Modules)"},"content":{"rendered":"\t\t
\n\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t\n

Perfex CRM<\/a> has a reputation for flexibility, but most tutorials only cover surface-level configuration\u2014enabling default workflows, setting reminders, or creating basic automations. Enterprise environments need far more: multi\u2011step workflows with conditional logic, CRON\u2011powered background executions, webhook pipelines, custom event listeners, server\u2011side PHP automation scripts, cross\u2011system integrations, and fully autonomous processes that run without manual intervention.<\/p>\n

This advanced developer guide focuses on exactly those capabilities, showing how to use webhooks, CRON triggers, event logic, custom automation, and background jobs to unlock Perfex CRM\u2019s full automation potential or Perfex CRM enterprise automation.<\/p>\n\n

All of this can be built inside Perfex CRM without paid modules. Unlike basic tutorials on email reminders, this guide explores enterprise-grade workflow engineering\u2014hooks, event observers, cron tasks, custom PHP modules, webhooks, background queues, and scalable patterns used by modern SaaS platforms and enterprise teams.<\/p>\n\n

1. Understanding Perfex CRM\u2019s Automation Architecture<\/strong><\/h2>\n\n

To build enterprise-grade workflows, it\u2019s essential to understand the building blocks inside Perfex CRM enterprise automation. Perfex uses CodeIgniter 3, so its backbone features are:<\/p>\n\n

1.1 Hooks<\/strong><\/h4>\n\n

Hooks execute custom logic immediately when a specific event occurs in Perfex CRM, giving developers full control to extend or modify system behavior without altering the core files.<\/p>\n\n

1.2 CRON Jobs<\/strong><\/h4>\n\n

CRON jobs enable time-based automation by running predefined tasks at regular intervals. They are essential for scheduling background processes, such as reminders, data updates, or batch operations.<\/p>\n\n

1.3 Webhooks<\/strong><\/h4>\n\n

Webhooks allow Perfex CRM to receive real-time triggers from external systems, such as WhatsApp, Slack, or custom applications. They enable instant responses and seamless integration between platforms.<\/p>\n\n

1.4 Custom Controllers & CLI Scripts<\/strong><\/h4>\n\n

Custom controllers and CLI scripts allow running specific automation logic on demand, providing precise control over the timing and execution of tasks. They are particularly useful for operations that do not require continuous or scheduled execution.<\/p>\n\n

1.5 Database Event Handlers<\/strong><\/h4>\n\n

Database event handlers monitor changes in specific tables and automatically trigger business logic in response. They allow real-time automation based on data modifications without manual intervention.<\/p>\n\n

1.6 Options & Settings<\/strong><\/h4>\n\n

Options and settings provide a way to store automation rules and configure triggers within Perfex CRM. In enterprise environments, these configurations are combined to create complex, reliable automation pipelines. Let\u2019s build them one by one.<\/p>\n\n

\"Flowchart<\/figure>\n\n

\u00a0<\/h2>\n

2. Building Webhook-Based Automations in Perfex CRM<\/strong><\/h2>\n\n

Modern enterprise systems rely heavily on webhooks<\/strong> \u2014 automated messages sent between systems.<\/p>\n\n

Perfex supports custom endpoints easily using modules.<\/p>\n\n

2.1 Create a Webhook Receiver Endpoint<\/strong><\/h3>\n\n

Inside\u00a0 module:<\/p>\n\n

modules\/automation_module\/controllers\/Webhook.php\n\n<?php\ndefined('BASEPATH') or exit('No direct script access allowed');\n\nclass Webhook extends CI_Controller {\n\n    public function index() {\n        $payload = json_decode(file_get_contents('php:\/\/input'), true);\n\n        \/\/ Log payload for debugging\n        log_activity('Webhook received: ' . json_encode($payload));\n\n        \/\/ Trigger automation\n        $this->process_webhook($payload);\n    }\n\n    private function process_webhook($payload) {\n        if ($payload['event'] === 'contact.created') {\n            \/\/ Example action: assign staff automatically\n            $this->assign_staff_to_new_contact($payload);\n        }\n    }\n\n    private function assign_staff_to_new_contact($payload) {\n        $assigned = 5; \/\/ staff_id = 5\n        $contact_id = $payload['contact_id'];\n\n        update_contact($contact_id, ['assigned_to' => $assigned]);\n\n        log_activity(\"Automation: Contact $contact_id assigned to staff $assigned\");\n    }\n}\n<\/code><\/pre>\n\n
2.2 Using This Webhook in Automation Pipelines<\/strong><\/h3>\n\n
Within automation pipelines, a webhook endpoint can receive triggers from multiple external systems, such as WhatsApp Cloud API, Zapier or Make.com, company ERP platforms, HR systems, payment processors, and custom mobile applications, enabling seamless integration and real-time workflow execution.<\/p>\n\n
Use cases:<\/strong><\/h4>\n\n
Common use cases for webhook-driven automation include automatically creating a lead when a WhatsApp message is received, auto-assigning staff after a contact form submission, syncing invoices with accounting software, and triggering workflows immediately after a contract is signed.
This approach replaces entire paid automation suites.<\/p>\n\n
3. CRON Triggers \u2014 The Backbone of Heavy Automation<\/strong><\/h2>\n\n
Time-based tasks allow businesses to execute operations in the background without user interaction.<\/p>\n\n
Perfex runs its CRON every 5 minutes by default.<\/p>\n\n
3.1 Create a Custom Cron Job<\/strong><\/h3>\n\n
Inside module\u2019s main file:<\/p>\n\n
hooks()->add_action('after_cron_run', 'automation_cron');<\/code><\/pre>\n\n
Then write the function:<\/p>\n\n
function automation_cron() {\n    $CI = &get_instance();\n    $CI->load->model('automation_model');\n\n    $CI->automation_model->process_scheduled_tasks();\n}<\/code><\/pre>\n\n
3.2 Create the Cron Execution Logic<\/strong><\/h3>\n\n
modules\/automation_module\/models\/Automation_model.php\n\npublic function process_scheduled_tasks() {\n\n    \/\/ Example: Auto-close stale tickets\n    $tickets = $this->db->where('status !=', 5)\n                        ->where('last_reply <', date('Y-m-d H:i:s', strtotime('-7 days')))\n                        ->get('tickets')\n                        ->result();\n\n    foreach ($tickets as $ticket) {\n        $this->db->where('ticketid', $ticket->ticketid)\n                 ->update('tickets', ['status' => 5]);\n\n        log_activity(\"Automation: Ticket {$ticket->ticketid} auto-closed by CRON\");\n    }\n}\n<\/code><\/pre>\n\n
3.3 Enterprise Use Cases<\/strong><\/h3>\n\n
Enterprise automation use cases include auto-closing inactive tickets, sending reminders automatically, performing daily data cleanup, assigning leads in a round-robin manner, managing invoice follow-up sequences, handling contract renewal workflows, sending SLA violation notifications, and performing batch synchronization with external applications. Implementing such automation is essential for maintaining efficiency and consistency in enterprise workflows.<\/p>\n\n
4. Event-Based Logic \u2014 Build Real Workflow Reactors<\/strong><\/h2>\n\n
Perfex CRM<\/a> provides built-in hooks for nearly every major system event, such as lead creation, lead conversion, invoice generation, ticket opening, task completion, email sending, contact creation, and client registration. By leveraging these hooks, businesses can develop robust event-driven automations that respond instantly to changes within the system.<\/p>\n\n
4.1 Example: When a Lead Converts, Create a Welcome Project<\/strong><\/h3>\n\n
hooks()->add_action('after_lead_converted', 'create_project_after_conversion');\n\nfunction create_project_after_conversion($lead_id) {\n\n    $CI = &get_instance();\n    $CI->load->model('projects_model');\n\n    $project_data = [\n        'name' => 'New Client Onboarding',\n        'clientid' => get_customer_id_from_lead($lead_id),\n        'status' => 1,\n        'start_date' => date('Y-m-d'),\n    ];\n\n    $CI->projects_model->add($project_data);\n\n    log_activity(\"Automation: Project created for converted lead $lead_id\");\n}\n<\/code><\/pre>\n\n
4.2 How Enterprise Teams Use This<\/strong><\/h3>\n\n
Enterprise teams use event-driven workflows as the backbone for automating critical processes, including customer lifecycle management, lead nurturing, support pipelines, accounting operations, contract management, and employee onboarding sequences. With these capabilities, Perfex CRM functions as a full-fledged workflow engine, rather than just a traditional CRM.<\/p>\n\n
5. Building a Custom PHP Automation Engine<\/strong><\/h2>\n\n
To handle enterprise automation, businesses should build a central Automation Engine<\/strong>.<\/p>\n\n
5.1 Automation Rule Structure<\/strong><\/h3>\n\n
Create table:<\/p>\n\n
automation_rules\n------------------------\nid\nname\ntrigger_type (event | cron | webhook)\ntrigger_value\nconditions (JSON)\nactions (JSON)\nstatus\ncreated_at<\/code><\/pre>\n\n
5.2 Automation Engine Controller<\/strong><\/h3>\n\n
modules\/automation_module\/controllers\/Engine.php\n\npublic function run() {\n    $rules = $this->automation_model->get_active_rules();\n\n    foreach ($rules as $rule) {\n        if ($this->conditions_match($rule)) {\n            $this->execute_actions($rule);\n        }\n    }\n}<\/code><\/pre>\n\n
5.3 Add conditional logic<\/strong><\/h3>\n\n
private function conditions_match($rule) {\n    $conditions = json_decode($rule->conditions, true);\n\n    foreach ($conditions as $cond) {\n        if (!$this->evaluate_condition($cond)) {\n            return false;\n        }\n    }\n    return true;\n}\n<\/code><\/pre>\n\n
5.4 Action Executor<\/strong><\/h3>\n\n
private function execute_actions($rule) {\n    $actions = json_decode($rule->actions, true);\n\n    foreach ($actions as $action) {\n\n        if ($action['type'] === 'send_email') {\n            send_mail_template($action['template'], $action['email']);\n        }\n\n        if ($action['type'] === 'assign_staff') {\n            assign_staff_to_customer($action['client_id'], $action['staff_id']);\n        }\n\n        if ($action['type'] === 'create_task') {\n            create_task_for_client($action['client_id'], $action['description']);\n        }\n    }\n}<\/code><\/pre>\n\n
At this point, businesses have effectively created a Zapier-like workflow engine within Perfex CRM, complete with triggers, conditions, actions, and reusable logic that can automate complex business processes.<\/p>\n\n
6. Background Jobs \u2014 Queueing Heavy Automation Tasks<\/strong><\/h2>\n\n
Enterprise systems demand background workers to manage resource-intensive tasks without blocking user interactions, such as bulk email sequences, large data sync operations, financial calculations, template generation, scheduled reports, API batching, and lead syncing. Perfex CRM lacks a native queue system by default but leverages its built-in email queue, which stores emails in the database for cron-driven background processing to prevent slowdowns during high-volume sends. Developers can extend this pattern using custom cron jobs for heavy tasks\u2014configured via cPanel or server crons calling \/cron\/index <\/strong>combined with database tables acting as queues, hooks for job insertion, and module libraries for processing logic like chunked data batches or retry mechanisms.\u200b<\/p>\n\n
A custom queue builds on Perfex’s CodeIgniter foundation by creating tbl_job_queue<\/strong> tables with columns for job_type, payload (JSON), status, retries, and scheduled_at, then registering module cron tasks to poll and execute jobs in batches. This approach ensures scalability for enterprise automations, with monitoring via log_activity()<\/strong> for job tracking and error handling to auto-requeue failures, mimicking production systems like Laravel queues without paid modules.<\/p>\n\n
6.1 Create Job Queue Table<\/strong><\/h4>\n\n
automation_jobs\n----------------\nid\npayload (JSON)\njob_type\nstatus (pending, running, done, failed)\ncreated_at\nupdated_at\n<\/code><\/pre>\n\n
6.2 Add to Queue<\/strong><\/h4>\n\n
public function queue_job($type, $payload) {\n    $this->db->insert('automation_jobs', [\n        'job_type' => $type,\n        'payload' => json_encode($payload),\n        'status' => 'pending'\n    ]);\n}\n<\/code><\/pre>\n\n
6.3 Cron Worker to Process Jobs<\/strong><\/h4>\n\n
public function process_jobs() {\n\n    $job = $this->db->where('status', 'pending')\n                    ->order_by('id', 'ASC')\n                    ->limit(1)\n                    ->get('automation_jobs')\n                    ->row();\n\n    if (!$job) return;\n\n    $this->db->where('id', $job->id)->update('automation_jobs', ['status' => 'running']);\n\n    try {\n        $this->execute_job($job);\n        $this->db->where('id', $job->id)->update('automation_jobs', ['status' => 'done']);\n    }\n    catch(Exception $e) {\n        $this->db->where('id', $job->id)->update('automation_jobs', [\n            'status' => 'failed',\n            'error_message' => $e->getMessage()\n        ]);\n    }\n}<\/code><\/pre>\n\n
6.4 Execute Job Types<\/strong><\/h4>\n\n
private function execute_job($job) {\n\n    $data = json_decode($job->payload, true);\n\n    switch ($job->job_type) {\n\n        case 'send_bulk_email':\n            foreach ($data['emails'] as $email) {\n                send_mail_template($data['template'], $email);\n            }\n        break;\n\n        case 'sync_leads':\n            $this->sync_with_external_api($data);\n        break;\n\n        case 'generate_invoice_report':\n            $this->create_report($data['client_id'], $data['period']);\n        break;\n    }\n}\n<\/code><\/pre>\n\n
Now CRM can handle thousands<\/strong> of operations in the background without freezing the UI.<\/p>\n\n
7. End-to-End Enterprise Automation Examples<\/strong><\/h2>\n\n
Below are full enterprise automation use cases can implement:<\/p>\n\n
7.1 Automated Lead Nurturing Flow<\/strong><\/h4>\n\n
When a lead is created in Perfex CRM, this serves as the primary trigger for the workflow. The condition checks if the lead status equals “New,” ensuring the automation only activates for fresh prospects. Upon meeting this condition, the actions execute sequentially: a welcome email is sent to engage the lead immediately, a follow-up task is created for ongoing nurturing, the lead is assigned to the appropriate sales agent for personalized handling, the lead is added to an email sequence for automated drip campaigns, and a WhatsApp outreach message is queued for quick mobile communication.<\/p>\n\n
7.2 SLA Management System<\/strong><\/h3>\n\n
Perfex CRM’s SLA Management System relies on a CRON job configured to trigger every 5 minutes<\/strong> for real-time monitoring. This process systematically checks all open tickets to identify those approaching or exceeding their service level agreement deadlines. Deadlines are then calculated based on predefined SLA rules, such as response times or resolution targets tied to ticket priority and type. Tickets breaching SLAs auto-escalate to supervisors for immediate intervention, while managers receive automated notifications to ensure oversight. Finally, stale tickets inactive beyond configurable thresholds are auto-closed to maintain system hygiene and accurate reporting.<\/p>\n\n
7.3 Accounting Automation<\/strong><\/h3>\n\n
Perfex CRM implements a daily CRON job that executes at midnight to handle essential financial automations. This process begins by syncing all invoices with the QuickBooks API to ensure real-time data consistency across platforms. It then auto-sends personalized invoice reminders to overdue clients based on configurable payment terms, generates a comprehensive list of overdue invoices for review, and emails the finance team with the updated report for proactive collections management.<\/p>\n\n
7.4 HR Onboarding Automation<\/strong><\/h3>\n\n
Perfex CRM’s HR Onboarding Automation activates whenever new staff is added to the system as the primary trigger. This workflow creates a series of predefined onboarding tasks to streamline the process, assigns relevant training modules to the new hire for immediate skill-building, and sends a personalized welcome email to foster engagement from day one. It also notifies the HR team for oversight and compliance, while automatically creating calendar events for key milestones like orientation sessions and check-ins.<\/p>\n\n
8. Performance Optimization for Automations<\/strong><\/h2>\n\n
Building Perfex CRM enterprise automation workflows requires careful attention to performance. Large tables should be processed using LIMIT and batching to avoid excessive loops. Heavy tasks must always be moved to a job queue rather than running directly inside hooks. Frequently used queries should be cached, leveraging Perfex\u2019s CodeIgniter caching support. Database indexes should be added to all tables involved in automation to optimize query performance. Additionally, logs should be kept clean by recording only essential events, ensuring efficient monitoring and minimal overhead.<\/p>\n\n
9. Debugging & Monitoring Enterprise Automations<\/strong><\/h2>\n\n
Perfex CRM enterprise automations require comprehensive debugging and monitoring to ensure reliability at scale. Essential monitoring covers cron logs for scheduled task execution, job queue performance to track processing delays, webhook failures with retry status, event listeners for hook responsiveness, and API errors including rate limits or authentication issues. Developers leverage Perfex’s native log_activity()<\/strong> function for structured activity tracking, custom log files in the application\/logs directory for detailed diagnostics, error email alerts configured via hooks, and database error tracking through dedicated tables like tblactivitylog<\/strong> or custom schemas.<\/p>\n\n
A custom monitoring dashboard can be built using Perfex modules, displaying real-time metrics such as cron success rates, queue backlogs, webhook delivery stats, and error trends via charts and filters. Tools like LogTracker modules enhance this with intuitive interfaces for log searching, real-time updates, and export capabilities, while integrating Telegram alerts or email notifications for critical failures.<\/p>\n\n
10. Final Thoughts <\/strong><\/h2>\n\n
At this stage, an enterprise-level automation engine exists inside Perfex CRM, incorporating webhooks, triggers, conditions, actions, background jobs, event listeners, scheduling, and custom rules. This setup is comparable to systems like HubSpot Workflows, Zoho Flow, Pipedrive Automations, Zendesk Triggers, and Salesforce Automations. The most impressive aspect is that it was built entirely without paid modules, using only native Perfex features and PHP. With proper structuring, this automation engine can reduce workload by up to 70%, improve SLA compliance, increase lead conversions, automate entire departments, and replace expensive automation tools.<\/p>\n\n
References<\/strong>:<\/h3>\n\n