Difference between revisions of "Email Importing"
From WHMCS Documentation
m (Fixed Email Importing Integrations link) |
|||
| (4 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
Email importing is distinct from email piping and requires a different configuration. We recommend using email importing instead of email piping if you use any control panel other than cPanel or if you want to import email from multiple domains. | Email importing is distinct from email piping and requires a different configuration. We recommend using email importing instead of email piping if you use any control panel other than cPanel or if you want to import email from multiple domains. | ||
| − | |||
| − | |||
| + | Begin by configuring your support ticket departments. You can do this 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'''. Add each of your departments and the email addresses that you assigned to them. | ||
| + | |||
<div class="docs-alert-info"> | <div class="docs-alert-info"> | ||
<strong>RFC 3834</strong><br /> | <strong>RFC 3834</strong><br /> | ||
In WHMCS 8.1 and later, the system sends support emails with RFC 3834-compliant headers by default. | In WHMCS 8.1 and later, the system sends support emails with RFC 3834-compliant headers by default. | ||
| − | * You can disable this at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' in the '''Mail''' tab. | + | * You can disable this at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' in the '''[[Mail Tab|Mail]]''' tab. |
* Regardless of your settings, WHMCS will not accept email that contains the <tt>Auto-Submitted</tt> header via email piping or email importing. | * Regardless of your settings, WHMCS will not accept email that contains the <tt>Auto-Submitted</tt> header via email piping or email importing. | ||
</div> | </div> | ||
| + | |||
| + | ==Email Importing Service Providers== | ||
| + | |||
| + | In addition to traditional POP3 or IMAP service providers, WHMCS supports email importing via Gmail in WHMCS 8.1 and higher and via Microsoft® services in WHMCS 8.6 and higher. These integrations provide access to your mail provider via secure protocols. Some mail providers require you to use these capabilities or have announced a requirement for it in the future. | ||
| + | |||
| + | To use these service providers, you will need to both configure your mail service provider and create an app for it via either the Google console or Microsoft Azure®. For more information, see [[Email Importing Integrations]]. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==Configuring Email Importing== | ==Configuring Email Importing== | ||
| − | + | ||
[[File:Cron piping.png|thumb|The cron command]] | [[File:Cron piping.png|thumb|The cron command]] | ||
| − | + | ||
To configure email importing for a support department: | To configure email importing for a support department: | ||
| − | + | ||
# Set up your email accounts: | # Set up your email accounts: | ||
| − | #* For email | + | #* For POP3 or IMAP, create a unique email account on your mail server for each support department. This must be a mailbox; an alias is not sufficient. |
| − | #* For | + | #* For Google or Microsoft, configure your mail service provider and create an app for it: |
| + | #** For steps to enable Google, see [https://help.whmcs.com/m/support_tools/l/1328652-setting-up-pop3-importing-with-oauth-via-google Setting Up POP3 Importing via Google]. | ||
| + | #** For steps to enable Microsoft, see [https://help.whmcs.com/m/support_tools/l/1600723-setting-up-importing-via-microsoft Setting Up Importing via Microsoft]. | ||
# In WHMCS, navigate to '''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, navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]''' or, prior to WHMCS 8.0, '''Setup > Support > Support Departments'''. | ||
# Create a new department and enter the top section of information or, for existing departments, click '''Edit'''. | # Create a new department and enter the top section of information or, for existing departments, click '''Edit'''. | ||
| − | # Enter the email information for the department | + | # Enter the email information for the department: |
| − | ## Select a '''Service Provider' | + | ## Select a '''Service Provider'''. |
| − | ## Enter | + | ## Enter the appropriate details for your service provider. |
| − | + | ## If you selected ''OAuth2'' as your '''Authentication''' type for '''Google''', enter your '''Email Address''' and the '''ClientID''' and '''Client Secret''' that you generated. Then, click '''Connect'''. | |
| − | |||
| − | ## | ||
| − | |||
| − | |||
# Set up a cron job to run the <tt>pop.php</tt> file using the '''Ticket Importing using Mail Importing (POP3/IMAP)''' command on the '''Support Departments''' page every few minutes. We recommend that you set this to run every five minutes. | # Set up a cron job to run the <tt>pop.php</tt> file using the '''Ticket Importing using Mail Importing (POP3/IMAP)''' command on the '''Support Departments''' page every few minutes. We recommend that you set this to run every five minutes. | ||
| − | + | ||
<div class="docs-alert-info"> | <div class="docs-alert-info"> | ||
The system will delete email in the source mailboxes upon successful import into WHMCS. | The system will delete email in the source mailboxes upon successful import into WHMCS. | ||
</div> | </div> | ||
Latest revision as of 18:00, 9 February 2023
Email importing is distinct from email piping and requires a different configuration. We recommend using email importing instead of email piping if you use any control panel other than cPanel or if you want to import email from multiple domains.
Begin by configuring your support ticket departments. You can do this at Configuration () > System Settings > Support Departments or, prior to WHMCS 8.0, Setup > Support > Support Departments. Add each of your departments and the email addresses that you assigned to them.
RFC 3834
In WHMCS 8.1 and later, the system sends support emails with RFC 3834-compliant headers by default.
- You can disable this at Configuration () > System Settings > General Settings in the Mail tab.
- Regardless of your settings, WHMCS will not accept email that contains the Auto-Submitted header via email piping or email importing.
Email Importing Service Providers
In addition to traditional POP3 or IMAP service providers, WHMCS supports email importing via Gmail in WHMCS 8.1 and higher and via Microsoft® services in WHMCS 8.6 and higher. These integrations provide access to your mail provider via secure protocols. Some mail providers require you to use these capabilities or have announced a requirement for it in the future.
To use these service providers, you will need to both configure your mail service provider and create an app for it via either the Google console or Microsoft Azure®. For more information, see Email Importing Integrations.
Configuring Email Importing
To configure email importing for a support department:
- Set up your email accounts:
- For POP3 or IMAP, create a unique email account on your mail server for each support department. This must be a mailbox; an alias is not sufficient.
- For Google or Microsoft, configure your mail service provider and create an app for it:
- For steps to enable Google, see Setting Up POP3 Importing via Google.
- For steps to enable Microsoft, see Setting Up Importing via Microsoft.
- In WHMCS, navigate to Configuration () > System Settings > Support Departments or, prior to WHMCS 8.0, Setup > Support > Support Departments.
- Create a new department and enter the top section of information or, for existing departments, click Edit.
- Enter the email information for the department:
- Select a Service Provider.
- Enter the appropriate details for your service provider.
- If you selected OAuth2 as your Authentication type for Google, enter your Email Address and the ClientID and Client Secret that you generated. Then, click Connect.
- Set up a cron job to run the pop.php file using the Ticket Importing using Mail Importing (POP3/IMAP) command on the Support Departments page every few minutes. We recommend that you set this to run every five minutes.
The system will delete email in the source mailboxes upon successful import into WHMCS.