CRM For WHMCS
From ModulesGarden Wiki
(Difference between revisions)
|
|
Line 272: |
Line 272: |
| ''Note: Only staff members with full privileges can assign admins to the contacts.'' | | ''Note: Only staff members with full privileges can assign admins to the contacts.'' |
| <br/> | | <br/> |
− | Apart form basic ones, options and Information, there may be visible some custom fields if they have been added and enabled. | + | Apart form basic ones, options and information, there may be visible some custom fields if they have been added and enabled. |
| |} | | |} |
| {| | | {| |
Revision as of 09:23, 19 November 2015
CRM For WHMCS is a module created to expedite the management process of potential clients.
You will be able to add new contacts, define their type as a lead or a potential and create accounts directly in the addon.
The module will allow you to send automated notifications, create quotes and notes as well as add custom fields to leads' and potentials' profiles according to your needs.
What is more, all the information about leads and potentials will be shown in a graphic presentation in dashboard.
TIP: You can extend the functionality of CRM For WHMCS by integrating the module with Asterisk VoIP Center For WHMCS, Quotes Automation For WHMCS and SMS Center For WHMCS.
|
✔ Convert Contact Types Between Lead And Potential
|
✔ Assign Client Account To Contact
|
✔ Assign Administrator To Contact
|
✔ Assign Ticket To Contact
|
✔ Quickly Edit Contact Details
|
✔ Add And Manage Contact's Follow-ups
|
✔ Add And Manage Contact's Notes
|
✔ Create And View Quotes For Contact
|
✔ Send Email From Template Or Custom Message - Include Files And Quote
|
✔ Upload And Manage Files From Contact Profile
|
✔ View Announcements For Administrators
|
✔ View Logs Concerning Contact
|
✔ View Dashboard Containing Incoming Follow-ups
|
✔ View Calendar With All Reminders Sorted By Type
|
✔ View CRM Statistics And Graphs Concerning Contacts
|
✔ Upon Removing, Contact Is Moved To Archive Where They Can Be Restored From If Needed
|
✔ 3 Types Of Notifications: Now, On Follow-up Date, Before Follow-up Date - Both For Administrators And Clients
|
✔ Follow-up Type - Easier Determination Of Follow-up Purpose
|
✔ Administrator To Notify - Defines Included Administrators Per Notification Type
|
✔ Notify Administrator via Email And SMS
|
✔ Use Email Template Or Place Custom Message
|
✔ Define Campaign Duration Time
|
✔ Assign Leads To Campaign Using Filters
|
✔ Manually Assign Campaign To Lead
|
✔ Display Dashboard Per Campaign
|
✔ Display Campaign Description Inside Of Assigned Lead Profile
|
✔ View Module Status - Contains Status Of CRM Key Elements
|
✔ Define Whether To Use Quotes And Administrator Assignment
|
✔ Define Follow-up Types And Default Notifications On Follow-up Reschedule
|
✔ Define If Notification Needs To Be Acknowledged By Administrators
|
✔ Create Custom Fields - Text, Textarea, Checkbox, Radio And Select
|
✔ Add Description To Custom Field
|
✔ Add Validators To Custom Fields
|
✔ Define WHMCS - CRM Fields Mapping - Automatically Fill Out Form With Appropriate Values
|
✔ Define Permissions Per Administrator Role Group
|
✔ Define Personal Settings:
|
✔ Define Visible Fields And Their Order For Leads, Potenials And Dashboard
|
✔ Configure Default View Of Leads And Potentials Lists - Visibility And Order In Columns
|
✔ Create CRM Email Templates
|
✔ Create CRM Email Templates
|
✔ WHMCS Support Tickets System - Create Lead, Quickly View Its Details And Move To CRM Contact Profile
|
✔ WHMCS Quotes - Quotes Created From The CRM Profile Will Be Automatically Assigned To Contact
|
✔ Integrated With Asterisk VoIP Center For WHMCS - Call Your Clients At Any Time (read more)
|
✔ Integrated With Quotes Automation For WHMCS - Extend Your Quotes Possibilities (read more)
|
✔ Integrated With SMS Center For WHMCS - Send Reminders via SMS (read more)
|
✔ Migration Tool - Migrate Leads/Potentials And Settings From CRM For WHMCS 1.2.4
|
✔ Toggle Standalone Mode - Display CRM Outside Of WHMCS
|
✔ Display Any Page Or Panel In Full Screen Mode
|
✔ Supports WHMCS V5 and V6
|
Installation
This tutorial will show you how to successfully install and configure CRM For WHMCS.
We will guide you step by step through the whole installation and configuration process.
|
Installation
1. Log in to your client area and download CRM For WHMCS.
|
2. Upload and extract the module into the main WHMCS directory.
Files in your WHMCS directory should look like on the following screen.
|
3. When you install CRM for the first time you have to rename 'license_RENAME.php' file.
File is located in 'modules/addons/mgCRM/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.
|
4. In order to configure your license key, you have to edit the previously renamed 'license.php' file.
Enter your license key between quotation marks as presented on the following screen. You can find your license key in your client area → 'My Products'.
|
Activate The Addon
5. Now you have to activate the module in your WHMCS system.
Log in to your WHMCS admin area. Go to 'Setup' → 'Addon Modules'. Afterwards, find 'CRM' and press 'Activate' button.
|
6. In the next step you need to permit access to this module.
To do so, click on 'Configure' button, tick checkboxes to assign desired admin roles.
CRM as standalone page - if selected, CRM page will be visible in standalone mode by default, no matter which template is used.
Full Access Admin - select admins that will have full access to your module.
Access Control - select admin groups that will have access to your module.
Now, press 'Save Changes'.
|
7. Now, you have to set up a cron job, which can be found in CRM Addon → 'Settings' → 'General' → 'System Overview'.
We advise to set up the cron as frequently as possible to send email notifications, 5 minutes interval is recommended.
|
8. You have just successfully installed CRM For WHMCS!
You can access your module in 'Addons' → 'CRM'.
|
Configuration and Management
CRM For WHMCS is a module which allows you and your staff to manage relations with your current as well as possible clients in one place.
|
Leads/Potentials
Create Contact
To add a new contact, press 'Create Lead' as shown on the following screen.
As you can see, fields are divided into two sections: Options and Information.
Fill out the form and press 'Add' to add the contact to the list.
Note: Only staff members with full privileges can assign admins to the contacts.
Apart form basic ones, options and information, there may be visible some custom fields if they have been added and enabled.
|
Immediately, after a new lead is added you are moved to its summary, where you can find/edit some additional data.
Read more about them in the following section.
|
Manage Contacts
In 'Actions' column you can find various useful operations which can be performed on a contact.
As you can see, in dropdown menu, actions such as 'Convert To Potential' and 'Delete' can be found.
'Note: 'Call Out' functionality is available as well if you have Asterisk VoIP Center For WHMCS installed and configured properly.
|
Now, let's proceed to the contact itself.
Press pencil icon to move to the contact's summary page.
|
Summary
In the area marked on the following screen, you can find assigned client name, status, ticket from which it was created, contact's basic details and campaigns if this contact belongs to any.
|
Contact's name and status can be changed by pressing pencil icon next to each of them, altering the name/status and pressing 'Update Name' / 'Update Status' button.
On the following screen you can see contact's name pencil and status form visible after the status pencil was pressed.
|
If option is enabled in the module settings, admin can be assigned to a contact.
Press 'Assign' , choose admin from a dropdown menu and press 'Save' to do so.
|
To edit fields in 'Main Details' press 'Edit' button as shown below.
After you make wanted changes, press 'Save'.
|
Module also allows assignment of a client account to the contact.
This can be done in two ways, by creating a new client from a contact or by assigning existing client to a contact.
|
In 'Summary' page you may also find brief conclusion of cerated notes, list of flow-ups and quickly do actions like:
- adding new notes
- sending emails
- adding follow-ups
- sending tickets responses (if assigned)
|
Follow-ups
Follow-ups allow you to send email templates or text messages to contacts and staff members, and create ToDo entries.
Any follow-up can be removed or rescheduled using buttons in the 'Actions' column.
You can search for the desired follow-up using search box and sorting by one of the columns.
|
To add a new follow-up, fill out the 'New Follow-up' form.
Here you can define:
- Date - (required) time when the notifications will be sent.
- Description - (required) short description of a follow-up, it will be afterwards visible in the follow-up list.
- Follow-up Type - allows you to define the type of a follow-up for easier determination of its purpose.
- Admin - admin whom ToDo entry will be assigned.
|
|
The last step is defining reminders, we will discuss each of them below.
Reminders for Administrators
- 'On Create' - Notification is sent to an admin, who is assigned to a Lead/Potential, immediately when a follow-up is created.
- 'Follow-up Due Date ' - notification is sent to an admin, who is assigned to a Lead/Potential, on the set date.
- 'Before Follow-up Due Date ' - Specify time (date/hours/minutes etc) before the Follow-up Due Date to send notification to an admin, who is assigned to a Lead/Potential.
Reminders for Clients
- 'On Create' - Notification is sent to a client, who is assigned to a Lead/Potential, immediately when a follow-up is created.
- 'Follow-up Due Date ' - Notification is sent to a client, who is assigned to a Lead/Potential, on the set date.
- 'Before Follow-up Due Date ' - Specify time (date/hours/minutes etc) before the Follow-up Due Date to send notification to a client, who is assigned to a Lead/Potential.
Choose whether you wish to send reminders via email or SMS (if SMS Center for WHMCS is activated) or perhaps both. Once option is marked and path chosen, you will have to fill out the details for chosen reminder, separate for emails and separate for SMS.
Press 'Add Follow-up' to finalize the process.
|
|
Added follow-up will turn up on the list of all follow-ups of the lead. Use action buttons to delete the follow up, reschedule and edit.
|
In order to reschedule a follow-up you must always give the reason!
|
Edit follow-up details:
- edit details
- add reminders
- manage existing reminders
|
Notes
'Notes' enables you to make and manage notes about the contact.
On the following screen you can see how to add an exemplary note.
|
Any existing note can be modified and hiden as presented below.
|
Please note that only hidden notes can be deleted. To show hidden notes press 'Display Hidden'.
|
Emails
Any staff member can send an email from the contact's profile.
As you can see, you can manually fill out email subject and content.
|
Alternatively, you can choose one of email templates to send.
Whatever way you choose, you can choose address to send from, as well as attach files and quotes.
|
Orders
Move to orders page to place order for the contact. Preview details of all orders and edit them.
|
Quotes
Quotes can be created for any CRM contact.
As you can see on the screen below, in the 'Quotes' section of the contact page, brief information about quotes assigned to the contact is displayed.
You can edit any of these quotes through using buttons in 'Actions' column.
|
You can also create a new quote for the contact, press 'Add New Quote' as shown on the following screen.
|
Now, create a quote for your contact.
You can do it in two ways, if a client is assigned to the contact, they will be automatically linked to the quote.
Otherwise, module will ask you to fill in a new client account details from to complete quote.
In the second scenario, client account will not be created in the process, unless you use 'Convert to Invoice' functionality.
Important: For extended functionality related to quotes we recommend our Quotes Automation For WHMCS.
It extends quotes with functionalities like adding product addons and domains to the quote, their automatic provision, and quote acceptance from the client area.
|
Files
'Files' tab allows you to upload and manage files related to your contact.
To upload a new file, select file to upload and describe it shortly, press 'Upload'.
|
Any uploaded file can be downloaded from the CRM by pressing its name or using actions icons.
It can be also removed by clicking on dustbin icon.
|
Logs
To view the latest actions performed on the contact, go to 'Logs' tab.
As you can see, it contains all details you might want to find in the logs.
|
'Logs' page, apart form displaying all the logs concerning the contact, contains searchbox.
Using the search option you can find logs of actions performed by specific administrators, at desired time and concerning desired actions.
On the following screen we were searching logs of associated with any event on client.
|
Campaigns
Another functionality that CRM For WHMCS has to offer is the possibility to create customized campaigns.
If you decide to apply this option, you will be able to create many and varied campings with selected contacts included and filtered according to your personal configurations.
Let's check how this functionality works.
|
Add Campaign
In order to add a new campaign use 'Create Campaigns' button.
|
Start with filling out some basic data about the campaign such as its name and descriptions. Select color that will be used to distinguish items. Assign admins who will have access to the campaign entries and declare beginning and ending dates.
|
In the second part you need to select filters to assign wanted record to this campaign. You may use both predefined system fields and your custom fields. Finally 'Add Campaign'.
|
Campaigns List
Find all the created campaigns stored together on a convenient list with the most crucial data close at hand.
Use Action buttons to:
1. Manually force record reassignment
2. Move to edition page
3. Delete unused campaign
|
Dashboard
On the 'Dashboard' you have a quick preview of the most important information in your CRM.
View follow-ups on calendar, list of latest leads/potentials and last activities.
|
It is possible to adjust the dashboard view according to applied filters. Choose dashboard view of CRM for a selected administrator. Select '--Any' if you want to show all content.
Additionally, you may impose campaign filters. Choose which campaign records shall be viewed. Select '--Not Applied' to disable this filter.
|
Standalone Mode
Use cross arrows icon to switch into standalone mode, your CRM module pages will be then accessed outside of WHMCS.
Press it again to come back to WHMCS view.
|
Calendar
Access calendar tab and you will find a fully manageable and adjustable calendar.
Switch between days, moths and week views to have a clear and precise view on your scheduled events (click on a selected day to see details).
Month view:
|
Under the calendar, there is a detailed legend of visible items with enumerated types of follow-ups.
Click on any follow-up to see its details.
|
Settings
Due to the wide variety of possible configurations, 'Settings' section has been moved to underneath to make the presentation more precise.
In 'Settings' → 'General' page of the module you can check current module status, enable major features and define follow-ups' settings.
|
General
System Overview
Under System Overview you can find information about:
- Integration with Asterisk VoIP Center For WHMCS
- Integration with SMS Center
- Cron job setup
- Number of CRM email templates
- Storage folder used by the module
|
In 'Cron Details', you can find all the information about the cron such as its path, last execution date and interval between cron runs.
|
Options
In Additional Options quotations may be enabled for leads and potentials as well as possibility to assign leads to administrators.
|
Follow-ups
In the last section of General Settings there are basic options to configure follow-ups. In settings part, you may enable follow-up per day (it means that a follow-up can be added within a day, not a specific hour) and choose email template used to notify admins about a follow-up being rescheduled.
|
Add new follow-up type by entering its name, assigning a color and finally enabling it to use. Once added you will see in the list of available underneath.
|
Personal
Personal Settings
Provide a URL to your avatar to personalize your CRM as you only wish!
|
Fields' View
In his place you may decide which columns exactly and even in what order they will appear in each of the possible sections (Leads, Potentials page and Leads&Potentials on Dashboard). Click on each section one by one to set its view.
Drag and drop available fields to create a perfect configuration.
|
Fields
Manage 'Fields' fully, add new fields, group them, define statuses and map existing fields.
|
List Of Fields
Each field, regardless of its type, has its name, description, assigned group and obviously its type.
Available types and validators for each of the types (seen when editing existing field)
- text: required, min, max, emial, url, ip, regex
- textarea: required, min, max, regex
- radio: required, min, max
- checkbox: required, min, max
- select: required, min, max
On the following screen you can see an example of a dropdown type custom field.
To add a field, press 'Create Field'.
|
Groups
Place where groups to segregate fields are created. Once you already know how you want to group your fields, create an adequate groups. Name them, assign a color and enable to start using it.
|
Status
Exactly, just like in case of groups, you may add hare statuses that later on will be used to segregate fields. Name the new status, assign a color and enable to start using it.
|
Fields Mapping
'Fields Mapping' option allows you to bond CRM fields with WHMCS standard or client custom fields.
This way during creation a lead from client's ticket or a client from lead, mapped fields will be automatically filled out.
|
Permissions
The last section in 'Settings' is responsible for assigning permissions to certain roles of group of administrators.
Select permissions for each existing role.
|
Once you have added a new role, use actions buttons to move the page where you can choose single permission rights for the group.
Select the one you need and 'Update' the settings.
|
Utilities
Statistics
'Statistics' contains graph concerning your leads and potentials.
Among the graphs, there can be distinguished graphs showing for example: the number of Leads and Potentials per status, new contacts per admin, per month and per day.
Additionally, administrators with extended permissions are able to view statistics of chosen administrators.
In 'Statistics' you can find the overall information such as graphs on Leads and Potentials of chosen status.
See a list of recently added leads/potentials with details such as assigned admins, status or creation date.
|
There are graphs and statistics tables presenting number of leads/potentials added within certain periods of time (year/month)
|
Archive
List of unused leads/potentials. Use action buttons to edit entries and convert them back to lead or potential from the archive.
|
Notifications
In this part you can manage any notifications that shall be delivered to any administrator depending on the configuration.
Let's check how it works. Press 'Create Notification' to begin.
|
|
You are moved to 'New Notification' creation form. Fill out the data to tailor the notification base perfectly in accordance with your needs.
- Choose its 'Type' from 'Temporary' and 'Permanent'.
- Select importance: 'Normal', 'Information', 'Warning' and 'Danger'.
- Mark administrators that this notification will be displayed to. You may surely select more than one admin.
- In 'Message' field simply type in the text of the notification. It is allowed to use HTML code here.
- Select 'Starting' and 'Ending' dates for 'Temporary' notifications
- 'Confirmation' - if you select this box, administrator will have to confirm reading such notification by pressing 'Accept' button.
- The button will be visible on the notification
- 'Hide Once Accepted' - decide whether accepted notification should disappear from the widget
'Create Notification'.
|
|
A newly created notification form is now visible on the list of all notifications in the system.
You may easily edit the notification (you will be moved to creation form where you can make any changes) or delete useless notification.
You will see here information if notifications have been accepted by administrators (if required) and by which ones exactly.
|
|
Created notifications are visible for selected in the configuration admins on any page of their CRM system.
'Accept' your notifications if it is required. Such info boxes like on the screen below will be visible until the specified in the configuration 'Ending Date', or once accepted if 'Hide Once Accepted' option has been selected.
You may easily hide it by pressing icon in the top right corner of the widget.
|
Migration
If you have already used any of the previous versions of CRM, the very first thing that you need to do with your module before moving to any further steps is migrating data from old CRM to CRM V2.0.0. To do so, move to 'Addons' → 'CRM' → 'Settings' → 'Migrator'.
You need to note that not all data can be migrated due to some incompatibility between systems.
These are:
- follow-ups
- uploaded files
Important! Before you proceed to migration itself, you must always make a backup copy of your database for safety reasons. In case of any unpredicted issues you will not lose any data and will be able to restore the previous version.
If you fulfill all conditions, press 'Begin Migration' to start the process.
|
Prepare mapping of statuses used in CRM V 1.2.4 that you wish to map to CRM V2.0.0. Confirm that you have done the mapping correctly and then move to custom fields mapping configuration.
|
Map fields used in CRM V 1.2.4, confirm proper configuration and move to the last step.
|
Read carefully all the information about migration consequences, if you agree with them, start the migration.
|
Congratulations! You have successfully migrated your database from old CRM to the latest version! Now, you can enjoy a much improved management of your contacts with potential clients.
|
Tickets
Our module offers additional integration in your WHMCS support tickets system.
As you can see on the screen below, your support operators can convert tickets directly into Lead.
This way you can track relations with your valuable clients.
|
Any ticket of such client will be displayed with contact name, status and assigned staff member.
Additionally, after pressing 'Lead Details' / 'Potential Details' extended information about the contact will be displayed in a popup.
Note: Any contact can be transferred between being lead and potential from the ticketing system as shown below (blue arrow).
|
Your staff will be also able to quickly move to the contact profile in CRM For WHMCS by pressing 'Show Lead' / 'Show Potential' .
|
Asterisk VoIP Center For WHMCS Integration
Integration with Asterisk VoIP Center For WHMCS extends your possibilities with ability to originate calls to your CRM contacts.
As soon as you install the module, you can originate a call by pressing 'Call Out' button.
If everything is set up correctly, you should see something similar to the screen below.
|
Workflow
In order to familiarize you with the module even more, we are presenting here an example workflow.
In the beginning, let's point the differences between privileges groups:
- Full Privileges Group - access to everything. 'Settings' tab is available only for this group.
- Sales Manager - ability to manage each Lead and Potential. Additionally, access to the dashboard with stats of each staff member and ability to export contacts.
- Sales Person - he can maintain only his own Leads and Potentials. Dashboard with only his stats.
On the following screen you can see the settings for each of the groups.
- Full Administrator - Full Privileges Group
- Sales Manager - Sales Manager
- Sales Person - Sales Person
|
|
Storytelling
Let's say we have admin X with full privileges and admin Y who has sales person privileges.
1. Admin X obtains a new contact, which is called Company X and creates Lead profile in CRM.
Additionally, he assigns admin Y to the Company X and leaves some notes in the profile.
2. Admin Y can now read these notes and choose newsletters and promotion notifications from email templates.
He sets them as a follow-ups spread over the next two weeks. Luckily, one of the newsletters draws the attention of Company X.
3. They respond to the newsletter, so that, admin Y changes this contact type to Potential.
This way he can track the relation with that contact better.
4. After a few emails with Company X, admin Y decides to prepare an interesting offer for the contact in the form of a quote.
5. Once the quote has been accepted, admin Y creates client account for the contact.
Additionally, owing to the integration with Quotes Automation For WHMCS, he is able to quickly generate the invoice & the order from the quote.
6. The following month a few more offers are accepted, and both your company and Company X benefit from it.
7. All the time admins X and Y can easily track their contact with Company X.
Thanks to the quotes in the contact profile they can see current offers made for Company X.
While notes and files can give more information about progress in making current agreements.
|
Tips
1. If you want to see a specific part of your CRM, a single widget only, use full screen mode for widgets.
- You will find it in the top right corner of each widget.
|
Common Problems
1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
|
|
|