How To

Email piping is feature in Perfex CRM to auto open or reply to ticket from email.

Before start setup email piping make sure you turn on in Setup -> Settings -> Tickets  find Email Piping and set Enabled to YES.

This is used if you have already setup email piping but you want to disable temporary. If piping is not enabled in this case before the pipe check script will run will check for this option and then will stop executing.

NOTE: This option is applied to both auto importing methods cPanel Forwaders or IMAP.

NOTE: You cant use both methods for auto importing tickets. You need to configure only 1 depends on your requirements.

• On your mail server you must create a unique email account for each support department. This must be a full inbox.
• In Perfex navigate to Setup -> Support -> Departments > Edit and enter your email address for this department.

Email forwarder method (from cPanel)

1. Login to you cPanel account
2. Go to Forwarders section and setup forwarder using the following command based on your department “php -q /home/username/public_html/crm/pipe.php” . Ex. If you department is Info and you setup [email protected] as email in the department you should forward this email. Repeat this step for each department.

TIP: You can check the pipe path into Setup -> Settings -> Tickets -> Email Piping

IMAP Auto Import Method

This method auto import tickets directly reading your email.

• If you want to use this method you need to have setup cPanel cron job.
• The cron will run each 5 minutes and will check for new tickets.

NOTE: The script will check only non-opened emails to prevent checking all the emails again and again and avoid slowing down the system. After checking email if you dont have checked delete after import the script will auto mark the email as READ.

Your PHP build needs IMAP support for this method to function correctly.

1. On your mail server create a unique email account for each support department.
2. Navigate to Setup->Support->Departments for each department add your IMAP credentials, click test IMAP connection to test if the connection is successful and your credentials are good.
3. Follow the test steps mentioned below.

Gmail IMAP Auto Import notes

1. If you are using google apps account make sure you verified your domain name.
2. If you are using google apps account make sure you enable IMAP.
3. If you get connection refused while testing IMAP connection check that your server’s firewall isn’t blocking traffic to google.
4. Maker sure you have enabled less secure apps
5. For IMAP server try imap.gmail.com
6. Check encryption SSL

To control/block any spam emails you should visit Setup->Support->Spam Filters.

Testing the Email Piping

If you are using the IMAP auto importing tickets method you will need to wait 5 minutes the cron job to run.

After you setup the piping try sending some test email. If everything is good a new ticket will be opened inside the CRM. While testing you should not use your or any admin address to send message.

Admin email addresses is only for ticket replies only and you cant create new ticket with admin email.

Should a ticket not be created when sending in an email, then check in Utilities > Ticket Pipe Log. If the message was received by Perfex it will be listed here with the reason why it failed to create a ticket. If the message you sent is not listed here, then the forwarder you setup previously is not working correctly and Perfex didn’t receive the message.

If you get the error message “Ticket ID Not Found” this means you are trying to open a support ticket from your admin email address.

Admins can only reply to tickets, not open new ones so submit a ticket from any other email address and it should be accepted.

Known problems you can encounter

If an email has not been piped into the ticket system the first reference point is Utilities > Email Pipe Log. This shows all the emails processed by the Perfex email piping process and any errors that may have occurred, explanations of the three most common errors are below:

Ticket ID Not Found

This means you are using an email address assigned to an staff to send your email. Staff can only reply to tickets and cant open new tickets sending an email to the support emails.
If you want to test, you must send an email from an email address that is not assigned to an staff into Perfex.

Only Replies Allowed by Email

The log means that an email was received to the department email address, but the subject did not contain a ticket ID.If you have set to Yes Only Replies Allowed by Email option located in Setup -> Settings -> Tickets config the email is rejected from the system.

Troubleshooting

If an email has not been piped into the ticket system and it is not listed in the Utilities > Email Pipe Log then these steps can be followed to identify the cause of the problem. There are different procedures depending upon whether the email forwarder piping method is used.

No Log outputed in the Email Pipe Log or Getting Mail Delivery

If no email pipe log when sending an email in to your piped email address then the forwarder entry is not correct and the message is not being sent to the pipe.php file.

To correct this, first ensure the pipe.php file is chmod to 755.

If still not working try one of the following commands: