Difference between revisions of "Messages/Emails"

Latest revision as of 18:23, 26 April 2022

Sending Emails to a Client

There are several ways to send email messages to your clients.

Client, Product, and Domain-Related

To send client, product, and domain-related email, go to the Summary tab of the client's profile.

Select New Message to send one-time emails that you compose individually and, optionally, save them as templates for future use.
Select a predefined email template to send existing messages for clients, products, and domains.

Invoice-Related

To send invoice-related emails, go to the desired invoice at Billing > Invoices.

Customise a Template Before Sending

You may sometimes wish to modify a predefined template before sending it.

To do this:

Select New Message as the email template in the steps for sending emails above.
For Load Message, choose the desired predefined template.
Customize the message.
Continue to send the message using that email type's method.

Automatic Mail

In version 5.0 and later, you can send emails automatically to your clients when they meet certain events or criteria. For example, sending a follow up email if a product is still in pending status x days after ordering, or upselling to clients with certain products, services, or addons: "You've got product x; you might be interested in product y"

You can do this at Utilities > Email Marketer.

Resending Emails to Clients

To resend an email:

Find the email you want to resend in the Email tab inside a client's profile or in the Email Message Log at Configuration () > System Logs or, prior to WHMCS 8.0, Utilities > Logs > Email Message Log.
Click the Resend icon for that message.
Edit the content and add any additional recipients.
Click Send Message.

Marketing and Mass Emailing

WHMCS provides multi-faceted bulk emailing tools. These vary from sending emails to every single client, to sending automated marketing campaigns to specific clients who meet certain criteria and have chosen to receive marketing emails from you.

For more information, see Marketing Emails Automation.

Contacts

You can use contacts to send a copy of a message to a different email address. When sending one-time or mass mails, contacts and sub-accounts that have the General email notification option enabled will receive a copy of any General mass emails for the master account holder.

If the contact has the Product email notification option enabled, they will receive copies of mass mails with the Product/Service email type. Similarly, contacts with Domain email notifications enabled will receive a copy of Domain type mass mails. Finally, when sending invoice related emails, the contact will receive a copy if they have the Invoice email notification option enabled.

The recipients list won't include contacts when composing the message, but if it includes their master account and they have the appropriate email permission, they will receive a copy.

Language

Assuming email templates are configured in multiple languages, the language used when sending an email will depend on the type of recipient.

Emails sent to admins, such as order notifications, will use the default system language. Set this in the Localisation tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings.

Emails sent to a clients, such as invoices and payment reminders, will use the the language selected in the client profile. If the client language is set to Default, the system default language will be used.
In WHMCS 8.0 and later, emails sent to users, such as password reset emails, will use the language selected by the user. This can be viewed when you navigate to Clients > Manage Users and click Manage User to edit the user. If this is set to Default, the system default language will be used.

If the system default language is invalid or deleted, WHMCS will default to English.

@@ Line 1: / Line 1: @@
-==Mass Mail==
+==Sending Emails to a Client==
-To send an email to a group of clients, go to Clients > Mass Mail.  You can then choose the criteria you want to filter on in order to select who the email will be sent to.  If you want to filter on product related criteria you must ensure you set the Email Type to be Product/Service related.  Likewise if you want to filter on domain related criteria you must set the Email Type to be Domain related.  By default the email type is General and so you can only filter on the client status criteria.
+There are several ways to send email messages to your clients.
-==Email Templates==
+=== Client, Product, and Domain-Related ===
-The Emails that WHMCS sends out to your customers can be fully customised in the email templates section of the WHMCS Configuration area.
+To send client, product, and domain-related email, go to the '''[[Clients:Summary_Tab|Summary]]''' tab of the client's profile.
-To view the merge fields that you can use in an email template to customise the email to that customer, click on the Merge Fields button towards the bottom of the window.
+* Select '''New Message''' to send one-time emails that you compose individually and, optionally, save them as templates for future use.
+* Select a predefined email template to send existing messages for clients, products, and domains.
-To display client custom fields in the email template, you use the format [Custom-Field Name] so if the field was called "VAT Number" you would put {$client_custom_field_vatnumber} into the email template for it to be displayed.  Likewise with product custom fields, you use the format {$service_custom_field_fieldname} and so if the field was called "Dedicated IP" you would put {$service_custom_field_dedicatedip}
+=== Invoice-Related ===
-==Sending Preset Emails to a Client==
+To send invoice-related emails, go to the desired invoice at '''Billing > [[Invoices]]'''.
-With WHMCS, it is possible to resend any of the automated emails in the general, product & domain categories manually should you need to.  In this article, we will look at how this is done.
+=== Customise a Template Before Sending ===
-* General Emails - To resend an email from the general category to a client such as the Welcome Email or Client Area Details Reminder, simply locate the client either through the search or clients list and click their name to proceed to the client summary for that client.  You will see an area labelled Send Email where you have a dropdown to pick any of the general emails and once selected, just click the Send button to send it.
+You may sometimes wish to modify a predefined template before sending it.
-* Product Emails - To resend a product related email, you need to tell WHMCS what product it's related to.  To do this, you need to locate the client, then click on to their Products/Services tab, select the product/service you want to send it for in the services dropdown menu and then scroll to the bottom of the page where you'll find a Send Message section.  From the dropdown menu you can select any of the product related emails in your system to resend to a client.
+To do this:
-* Domain Emails - To resend a domain related email, you need to tell WHMCS what domain you want to send it for.  To do this, like with product emails, you need to locate the client, but then click on to their Domains tab, select the domain you want to send it for and then scroll to the bottom of the page where you'll find a Send Message section.  From the dropdown menu you can select any of the domain related emails in your system to resend to a client.
+# Select '''New Message''' as the email template in the steps for sending emails above.
+# For '''Load Message''', choose the desired predefined template.
+# Customize the message.
+# Continue to send the message using that email type's method.
-==Sending a Custom Email to Clients==
+=== Automatic Mail ===
-To send a custom one off email to a client use the same process as above for the preset emails but instead of choosing an email template name, select the "New Message" option in the dropdown menu.
+In version 5.0 and later, you can send emails automatically to your clients when they meet certain events or criteria.  For example, sending a follow up email if a product is still in pending status x days after ordering, or upselling to clients with certain products, services, or addons: "You've got product x; you might be interested in product y"
+You can do this at '''Utilities > [[Email Marketer]]'''.
+==Resending Emails to Clients==
+To resend an email:
+# Find the email you want to resend in the '''[[Clients:Emails_Tab|Email]]''' tab inside a client's profile or in the '''Email Message Log''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' or, prior to WHMCS 8.0, '''Utilities > Logs > Email Message Log'''.
+# Click the '''Resend''' icon for that message.
+# Edit the content and add any additional recipients.
+# Click '''Send Message'''.
+==Marketing and Mass Emailing==
+WHMCS provides multi-faceted bulk emailing tools. These vary from sending emails to every single client, to sending automated marketing campaigns to specific clients who meet certain criteria and have chosen to receive marketing emails from you.
+For more information, see [[Marketing_Emails_Automation|Marketing Emails Automation]].
+==Contacts==
+You can use contacts to send a copy of a message to a different email address. When sending one-time or mass mails, contacts and sub-accounts that have the '''General''' email notification option enabled will receive a copy of any '''General''' mass emails for the master account holder.
+If the contact has the '''Product''' email notification option enabled, they will receive copies of mass mails with the '''Product/Service''' email type. Similarly, contacts with '''Domain''' email notifications enabled will receive a copy of '''Domain''' type mass mails. Finally, when sending invoice related emails, the contact will receive a copy if they have the '''Invoice''' email notification option enabled.
+The recipients list won't include contacts when composing the message, but if it includes their master account and they have the appropriate email permission, they will receive a copy.
+==Language==
+Assuming email templates are configured in multiple languages, the language used when sending an email will depend on the type of recipient.
+Emails sent to admins, such as order notifications, will use the default system language. Set this in the '''[[Localisation Tab|Localisation]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settings'''.
+* Emails sent to a clients, such as invoices and payment reminders, will use the the language selected in the client profile. If the client language is set to ''Default'', the system default language will be used.
+* In WHMCS 8.0 and later, emails sent to users, such as password reset emails, will use the language selected by the user. This can be viewed when you navigate to '''Clients > [[Manage Users]]''' and click '''Manage User''' to edit the user. If this is set to ''Default'', the system default language will be used.
+If the system default language is invalid or deleted, WHMCS will default to '''English'''.

Documentation