Email Piping: Google Apps - Revision history

SarahK at 20:25, 21 April 2022

2022-04-21T20:25:35Z

DanR: /* Configuration */

2021-05-04T12:25:00Z

‎Configuration

John at 10:50, 12 February 2021

2021-02-12T10:50:37Z

SarahK at 12:54, 5 August 2020

2020-08-05T12:54:21Z

Lawrence at 20:21, 29 December 2018

2018-12-29T20:21:09Z

Lawrence: /* Password command failed */

2018-12-29T20:17:28Z

‎Password command failed

Lawrence: /* Troubleshooting */

2018-12-29T20:15:49Z

‎Troubleshooting

Lawrence: /* Troubleshooting */

2018-12-29T20:11:36Z

‎Troubleshooting

Lawrence: /* Troubleshooting */

2018-12-29T20:11:09Z

‎Troubleshooting

Lawrence: /* Configuration */

2018-12-29T20:07:56Z

‎Configuration

@@ Line 20: / Line 20: @@
 . Please ensure that Imap-SSL/Pop3-SSL is in the PHP installation on the server. Such a change (if needed) will usually require the hosting provider or system administrator to do this. The reason for enabling this is because GSuite services will only accept secured connections.
-. Under  '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Support Departments''' or, prior to WHMCS 8.0, '''Setup > Support > Support Departments'''.  in WHMCS, create at least one department and configure the email account assigned to it like so:
+. Under  '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]''' or, prior to WHMCS 8.0, '''Setup > Support > Support Departments'''.  in WHMCS, create at least one department and configure the email account assigned to it like so:
   '''hostname:''' pop.gmail.com
   '''port:''' 995
@@ Line 26: / Line 26: @@
   '''pwd:''' yourpassw0rd
-. Create a cron job to trigger the <tt>/crons/pop.php</tt> file every 5 minutes. We have guides on creating cron job in most web hosting control panels here: https://docs.whmcs.com/Cron_Configuration
+. Create a cron job to trigger the <tt>/crons/pop.php</tt> file every 5 minutes. For help, see [[Cron Configuration]].
 Once this is done, any new emails to the support email addresses should be imported. If they are not, please follow the troubleshooting steps below to determine the cause and correct it as needed.
@@ Line 33: / Line 33: @@
 If e-mails are not being imported from GSuite as expected, there are some steps that can be taken to debug and correct this.
-The first step is to check the ticket import logs in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs''' or, prior to WHMCS 8.0, '''Utilities > Ticket Mail Import Log''' in the WHMCS admin area. Look for any entries for the e-mails in question. If there are no applicable entries present, it usually indicates that the pop.php cron job isn't set up  or is unable to successfully import the e-mails due to one or more of the below reasons:
+The first step is to check the ticket import logs in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' or, prior to WHMCS 8.0, '''Utilities > Logs''' in the WHMCS admin area. Look for any entries for the e-mails in question. If there are no applicable entries present, it usually indicates that the pop.php cron job isn't set up  or is unable to successfully import the e-mails due to one or more of the below reasons:
 * Verify that Pop3 and IMAP is enabled for the applicable Gsuite inbox as described in the Configuration section above and that the /crons/pop.php cron job has been created and is running every 5 minutes.
@@ Line 40: / Line 40: @@
 For more specific troubleshooting of the above, please refer to our help articles at [https://help.whmcs.com/m/support_tools/l/679784-troubleshooting-email-piping-problems Troubleshooting Email Piping Problems] and [https://help.whmcs.com/m/support_tools/l/679785-troubleshooting-email-piping-problems-advanced Troubleshooting Email Piping Problems Advanced]
 ===Connection refused===
 * Check that the server's firewall isn't blocking traffic to google.
 * To make absolutely sure that the server's firewall is not blocking your connection attempts, run this telnet command from the server using SSH:    '''telnet gmail-pop.l.google.com 995'''
 ===Too many login failures===
-* Double-check the username and password entered on the Support Department configuration are correct. You can find these at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Support Departments''' or, prior to WHMCS 8.0, '''Setup > Support > Support Departments'''.
+* Double-check the username and password entered on the Support Department configuration are correct. You can find these at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]''' or, prior to WHMCS 8.0, '''Setup > Support > Support Departments'''.
 * Adjust the Gmail account settings to allow [https://support.google.com/accounts/answer/6010255?hl=en-GB less secure apps]. This allows external applications such as WHMCS to authenticate to the account via username and password.
 * Check the Recent Activity page in Gmail to see whether the login attempt was blocked at their end: [https://support.google.com/accounts/answer/6063333?hl=en ‘Suspicious sign in prevented’ email].
@@ Line 50: / Line 52: @@
 ===Can not authenticate to POP3 server===
 Refer to the troubleshooting steps for [[#Too many login failures]]
 ===Password command failed===
 Refer to the troubleshooting steps for [[#Too many login failures]]

@@ Line 5: / Line 5: @@
 ==Configuration==
-Follow these steps:
+Follow these steps: <br>
-* Create a GSuite account at https://gsuite.google.com/
+. Create a GSuite account at https://gsuite.google.com/ <br>
-* Verify the domain where WHMCS is installed with GSuite and complete their setup process.
+. Verify the domain where WHMCS is installed with GSuite and complete their setup process. <br>
-* Log into Admin Console at https://gsuite.google.com/ and create appropriate email accounts that will be using WHMCS ticketing system and receiving tickets and replies.
+. Log in to the Admin Console at https://gsuite.google.com/ and create appropriate email accounts that will be using the WHMCS ticketing system and receiving tickets and replies.<br>
 <div class="docs-alert-success">A separate email account should be created for each support department.</div>
-<div class="docs-alert-info">Enable "Enable POP for mail that arrives from now on", otherwise POP will be enabled for all e-mails in the inbox (even older e-mails that may not need to be imported) and will cause all of them to be imported by WHMCS.</div>
+<div class="docs-alert-info">
-* Please ensure that Imap-SSL/Pop3-SSL in the PHP installation on the server. Such a change (if needed) will usually require the hosting provider or system administrator to do this. The reason for enabling this is because GSuite services will only accept secured connections.
+. For all accounts that will be receiving tickets, be sure to enable POP3 and IMAP in GMail's webmail interface:  [https://support.google.com/a/answer/9003945 Enable IMAP] [https://support.google.com/mail/answer/7104828 Enable POP3]
-* Under Setup > Support > Support Departments in WHMCS, create at least one department and configure the email account assigned to it like so:
   '''hostname:''' pop.gmail.com
   '''port:''' 995
@@ Line 21: / Line 26: @@
   '''pwd:''' yourpassw0rd
-* Create a cron job to trigger the /crons/pop.php file every 5 minutes. We have guides on creating cron job in most web hosting control panels here: https://docs.whmcs.com/Cron_Configuration
+. Create a cron job to trigger the <tt>/crons/pop.php</tt> file every 5 minutes. We have guides on creating cron job in most web hosting control panels here: https://docs.whmcs.com/Cron_Configuration
-If you complete these steps then this should work wonderfully.
+Once this is done, any new emails to the support email addresses should be imported. If they are not, please follow the troubleshooting steps below to determine the cause and correct it as needed.
 ==Troubleshooting==

@@ Line 9: / Line 9: @@
 * Verify the domain where WHMCS is installed with GSuite and complete their setup process.
 * Log into Admin Console at https://gsuite.google.com/ and create appropriate email accounts that will be using WHMCS ticketing system and receiving tickets and replies.
 * For all accounts that will be receiving tickets, be sure to enable POP3 and IMAP in Google Mail's webmail interface:  [https://support.google.com/a/answer/9003945 Enable IMAP] [https://support.google.com/mail/answer/7104828 Enable POP3]
@@ Line 49: / Line 50: @@
 Refer to the troubleshooting steps for [[#Too many login failures]]
-If there are any issues after verifying the suggested troubleshooting steps above, it will be necessary to contact Google or visit their discussion forums for GSuite.  It is possible they may be blocking your server from accessing their mail servers.
+===Email imported multiple times===
 ==Workaround for those without SSL==
 In some cases, it may be necessary to work around your server not properly handling SSL for POP3. To do so, create another POP3 e-mail account at a different domain name outside GSuite (that does not require SSL to pick up via POP3), and then have your GSuite e-mail forward to that e-mail address. Then in WHMCS, use POP3 to pick up the e-mail at the POP3 account that does not require SSL.  The user will never notice since they send all e-mails to your GSuite address, and receive e-mails "from" your Google Apps address (or whatever address you have assigned in WHMCS for that support department).

@@ Line 29: / Line 29: @@
 If e-mails are not being imported from GSuite as expected, there are some steps that can be taken to debug and correct this.
-The first step is to check the ticket import logs in Utilities > Ticket Mail Import Log in the WHMCS admin area and look for any entries for the e-mails in question. If there are no applicable entries present, it usually indicates that the pop.php cron job isn't set up  or is unable to successfully import the e-mails due to one or more of the below reasons:
+The first step is to check the ticket import logs in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs''' or, prior to WHMCS 8.0, '''Utilities > Ticket Mail Import Log''' in the WHMCS admin area. Look for any entries for the e-mails in question. If there are no applicable entries present, it usually indicates that the pop.php cron job isn't set up  or is unable to successfully import the e-mails due to one or more of the below reasons:
 * Verify that Pop3 and IMAP is enabled for the applicable Gsuite inbox as described in the Configuration section above and that the /crons/pop.php cron job has been created and is running every 5 minutes.
@@ Line 40: / Line 40: @@
 * To make absolutely sure that the server's firewall is not blocking your connection attempts, run this telnet command from the server using SSH:    '''telnet gmail-pop.l.google.com 995'''
 ===Too many login failures===
-* Double-check the username and password entered on the Support Department configuration (Setup > Support > Support Departments > Edit) are correct.
+* Double-check the username and password entered on the Support Department configuration are correct. You can find these at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Support Departments''' or, prior to WHMCS 8.0, '''Setup > Support > Support Departments'''.
 * Adjust the Gmail account settings to allow [https://support.google.com/accounts/answer/6010255?hl=en-GB less secure apps]. This allows external applications such as WHMCS to authenticate to the account via username and password.
 * Check the Recent Activity page in Gmail to see whether the login attempt was blocked at their end: [https://support.google.com/accounts/answer/6063333?hl=en ‘Suspicious sign in prevented’ email].

@@ Line 50: / Line 50: @@
-If you are still having issues after verifying the suggested troubleshooting steps above, then you will need to contact Google or visit their discussion forums for GSuite.  It is possible they may be blocking your server from accessing their mail servers.
+If there are any issues after verifying the suggested troubleshooting steps above, it will be necessary to contact Google or visit their discussion forums for GSuite.  It is possible they may be blocking your server from accessing their mail servers.
-==Final thoughts==
+==Workaround for those without SSL==
-===Workaround for those without SSL===
+In some cases, it may be necessary to work around your server not properly handling SSL for POP3. To do so, create another POP3 e-mail account at a different domain name outside GSuite (that does not require SSL to pick up via POP3), and then have your GSuite e-mail forward to that e-mail address. Then in WHMCS, use POP3 to pick up the e-mail at the POP3 account that does not require SSL.  The user will never notice since they send all e-mails to your GSuite address, and receive e-mails "from" your Google Apps address (or whatever address you have assigned in WHMCS for that support department).

← Older revision		Revision as of 20:17, 29 December 2018
Line 50:		Line 50:


−	If you are still having issues after verifying the suggested troubleshooting steps above, then you will need to contact Google or visit their discussion forums for ~~Google Apps~~. It is possible they may be blocking your server from accessing their mail servers.	+	If you are still having issues after verifying the suggested troubleshooting steps above, then you will need to contact Google or visit their discussion forums for GSuite. It is possible they may be blocking your server from accessing their mail servers.

	==Final thoughts==		==Final thoughts==