EMAIL Maker

EMAIL Maker Manual · Chapter 8

Additional features – EMAIL Maker for Vtiger CRM

8.1 Chat with Assistant

The Email Maker AI Assistant is built directly into Email Maker and helps users create, redesign, and improve email templates more efficiently.

The assistant uses the content from the currently opened template section and can also work with Email Maker variables. It can help generate a new template, update an existing template, improve the design, or add missing parts such as a product block.

Token usage

Each user has 500,000 AI tokens per month included in the Email Maker/Packages subscription.

Tokens are used when the AI Assistant processes prompts and generates responses. The token limit is reset automatically every month.

No external API key is required. The AI Assistant is already integrated into Email Maker, so users do not need to configure any third party AI service.

The current token usage is visible directly in the AI Assistant area. Users can see the usage in the progress bar and also as a percentage value.

Where to find the AI Assistant

In the Email Maker Template Editor, there is a new AI tab.

Inside this tab, users can enter prompts and send them to the AI Assistant. Based on the prompt, the assistant can generate a new Email template or modify the currently opened template.

This makes template creation and editing easier, especially when users want to improve the structure, layout, or visual design of a Email template.

Email Maker AI preview
Email Maker AI preview

Example prompts

Users can enter prompts such as:

Email Maker AI prompts
Email Maker AI prompts

Generating content

After entering a prompt, click the Send button.

The AI Assistant will generate a response based on the current template content, available variables, and the user prompt.

After the response is generated, the user can choose how to use the result.

Available actions

Insert

The Insert button inserts the generated content into the template.

This option is useful when the user wants to add new content without replacing the existing template section.

Replace

The Replace button replaces selected template content with the generated result.

History of AI responses

The full history of prompts, responses, and available actions is displayed below the chat window.

Each generated response remains available in the history. This allows the user to return to an earlier result and use it again.

For example, if the user makes a mistake in step 4, but the result from step 3 was correct, the user can use the Replace action from step 3 and restore that version into the template.

Important notes

AI generated content should always be reviewed before final use.

Some results may require additional adjustments, especially when working with Email Maker variables, product blocks, or complex template structures.

Users should check that all variables are correct and that the basic Email Maker Maker template rules are followed.

The AI Assistant may not always create the perfect result from the first prompt. In some cases, users may need to refine the prompt or continue with additional instructions.

The AI model will continue to be improved so that it better supports customer requirements and makes everyday Email template creation faster and easier.

8.2 Default CC and BCC Recipients

Starting from Email Maker version 4.65, it is possible to define default CC and BCC email addresses directly in an email template.

This option is available in the Emails tab when creating or editing an Email Maker template.

When CC or BCC email addresses are added to the template, they are automatically loaded into the Compose Email window after the template is selected. This helps users prepare emails faster and ensures that predefined recipients are added consistently.

Multiple email addresses can be entered and separated by commas.

Important note

This feature applies only to emails created manually through the Compose Email window.

It does not apply to workflow emails.
For workflows, CC and BCC recipients must be configured directly in the workflow action settings.

Vtiger - Default CC and BCC Recipients in Email Templates
Vtiger – Default CC and BCC Recipients in Email Templates

8.3 Prevent emails from being sent

Prevent emails from being sent

This feature was added on November 12, 2024. To use it, please ensure you have installed or updated our FREE Emails extension to version 0.32.

Description

The newly added feature allows you to prevent emails from being sent if they contain banned words that you define. You can also choose to block emails entirely based on specific templates from Email Maker, PDF Maker, and Email Marketing. If a banned word appears in the content or body of an email, it will not be sent to the recipient.

This feature is ideal for maintaining professional communication with clients, avoiding offensive language, or blocking certain emails from being sent entirely.

Key benefits:

  • Keep control over your outgoing emails
  • Supports workflows
  • Works seamlessly with PDF Maker, Email Maker, and Email Marketing extensions
  • Allows you to define multiple banned words, not just one
  • Option to prevent emails from being sent based on the template used
  • Emails blocked from sending are still created in the system under the Emails extension, allowing you to review the reason they weren’t sent

What is required?

  • Emails extension version 0.32 or higher required
  • Our extensions that use mailing functions, such as PDF Maker, Email Maker, and Email Marketing
  • Ensure all extensions are up to date
  • Supports Vtiger versions 7.x and 8.x
  • Installer requirements should meet recommended values

How does it work?

A/ Prevent emails from being sent with defined banned words

This feature enables you to block emails from being sent if they contain specific banned words that you define. This is useful for ensuring professional communication and avoiding the use of prohibited or sensitive language in outgoing messages.

  1. Go to Vtiger folder, open file config.inc.php
  2. Add following code with your banned word/s:

    $ITS4YouEmails_BannedWords = [‘word1’, ‘word2′,’word3’,];

    Prevent emails from being sent

  3. Save the config.inc.php file

Now, when you try to send an email—let’s say via Email Maker—and the template or body content includes the word “bannedword,” the email will not be sent, and the following message will appear:Prevent emails from being sent

B/ Prevent emails from being sent at all for specific template

Prevents emails from being sent entirely for a specific template by using the following code: #ITS4YouEmails_Do_Not_Send_Mail#

  1. Open any template you want and add to body code

    #ITS4YouEmails_Do_Not_Send_Mail#

  2. Save the template.
  3. Go to record module and try to send email using a template we defined code in.

Following message should appear:
Prevent emails from being sent

8.4 Campaigns and EMAIL Maker

With the EMAIL Maker module you can now use Campaigns in a more effective way. We added a feature where you can send e-mail to Contacts which are added to your Campaign.

Follow simple steps to send a Campaign e-mails to selected Contacts:

  1. First create or choose already created Campaign and click on Contacts Campaign email – Campaigns and EMAIL Maker
    You will be redirected to Campaign Contacts view like you can see on the following picture:

    Campaigns and EMAIL Maker
    Campaigns and EMAIL Maker

  2. Next you have to add Contact/s to Campaign. You have 3 options here how to add Contacts:
    a.) Select Contact/s via Campaigns and EMAIL Maker button.
    b.) Add Contact/s via Campaigns and EMAIL Maker button.
    c.) Load Contacts from the already created Contact List Campaigns and EMAIL Maker
  3. Now select Contacts which will be receiving e-mails. You can use the check – box where all contacts will be selected or you can check – box contacts separately:

    Campaigns and EMAIL Maker
    Campaigns and EMAIL Maker

  4. When you selected Contacts proceed by clicking on the Campaign email – Campaigns and EMAIL Maker button.
  5. On the next Screen you have to choose which E-mail fields will be used. Also, you can choose the EMAIL MAKER template you already created. The process is shown on following picture:

    Campaigns and EMAIL Maker
    Campaigns and EMAIL Maker

  6. In the last step you will be redirected to Compose email window. Here you can see which Contacts you added in the Contacts List field. Also, you can edit the template you did choose for your Campaign. When you are done with editing or adding additional recipients press Send email button – Campaigns and EMAIL Maker button.

    Campaigns and EMAIL Maker
    Campaigns and EMAIL Maker

8.5 Export and import templates

Export and import of the email templates makes it easy to work with EMAIL Maker templates by migration process or moving templates from development to productive installation.
In order to export EMAIL templates to external sources in EMAIL Maker tool do following steps:

  1. In the EMAIL Maker ListView page select one or more templates which would you like to export.
  2. Click on Actions button – Export and import templates and “Export”.
  3. In the File Download pop-up dialog select “Save File”.
  4. Click to save the templates in *.xml file format.
Export of the templates
Export of the templates

To import email templates from external sources click on Actions button – Export and import templates and “Import”. After click the new import page will appear on the screen.

Import EMAIL templates page
Import EMAIL templates page

In the Import pdf templates page, browse the EMAIL Maker template-related data in *.xml format and then click the button. It will take a few seconds to complete the import. The imported templates can be found in the EMAIL Maker ListView page.

8.6 Custom functions

If you need a special treatment of vtiger data in your template, you can use custom (your own) functions. There is a folder „functions“ under [vTigerROOT]/modules/EMAILMaker/resources, where you can place your own .php file with functions which would you like to use. This file will be included automatically. Inside this folder is file „its4you.php“, which contains our functions. These functions are descibed below and are provided for you for free. Do not modify this file, because by next version it will be overwritten. If you would
like to use your own functions, please create your own file/files, it means create new .php file under [vTigerROOT]/modules/EMAILMaker/resources/functions and place here your functions. In order to insert custom function into template provide following:
1. Go to EditView, and in Other information tab select custom function from selectbox „Custom functions“. As example in the picture below its4you_if is selected.
2. Click button . It adds function in form [CUSTOMFUNCTION|functionname|param1|param2|…|CUSTOMFUNCTION] or [CUSTOMFUNCTION_AFTER|functionname|param1|param2|…|CUSTOMFUNCTION].
3. Finally you have to define function name and parameters of the function as shown in the picture below.

Custom functions
Custom functions

In the above example function with 5 parameters was used, i.e. [CUSTOMFUNCTION|functionname|param1|param2|param3|param4|param5|CUSTOMFUNCTION]. It is possible to use functions without parameters as well. In this case use just notation [CUSTOMFUNCTION|functionname|CUSTOMFUNCTION].

Here you can find list of functions available for EMAIL Maker:

  • addToCFArray
  • implodeCFArray
  • addToCFArrayALL
  • implodeCFArrayALL
  • sumCFArray
  • sumCFArrayAll
  • datefmt
  • pdfmakerGetEntityName
  • isInMultiselectbox
  • its4you_if
  • its4you_relatedlist
  • getTemplateId
  • its4you_getContactImage
  • its4you_formatNumberToPDF
  • its4you_formatNumberFromPDF
  • its4you_multiplication
  • its4you_deduct
  • its4you_sum
  • its4you_divide
  • its4you_nl2br
  • setCFGNumberValue
  • sumCFGNumberValue
  • deductCFGNumberValue
  • mathCFGNumberValue
  • showCFGNumberValue
  • its4you_unsubscribeemail
  • setCFNumberValue
  • sumCFNumberValue
  • deductCFNumberValue
  • mathCFNumberValue
  • showCFNumberValue
  • semantic_ru
  • num2str_ru

Following sections contain short description of some our its4you_* functions which you can use in your Email templates.

More info how to add own custom function you can find in our blog: How to create own Custom function for PDF Maker or EMAIL Maker?

8.7 Pay by Square

With Email Maker you can use the feature Pay by Square easy and load a values for payments from the records via variables used in the template.

Paying with Square is more than a mobile cash register. It also offers free apps for making payments with your smartphone and using bank apps for sending money to your friends or clients.

In order to use the Pay by Square in your templates. Please follow steps below:

  1. Open your template (in our example we will use Invoice module)
  2. In the template go to Other information tab and then Custom functions, search for payBySquare function
    Email maker – Pay by Square
  3. Insert the function where you want it in to your template, function should look like by default:

    ​​​​​​​[CUSTOMFUNCTION|payBySquare|iban|amount|currency|vs|ss|cs|note|due_date|size|CUSTOMFUNCTION]

  4. Custom function has own parameters which should be replaced with values or variables, see an example:

    [CUSTOMFUNCTION|payBySquare|SK2811110000009999983002|$TOTAL$|$CURRENCYCODE$|1234567890|1234567890|1234|$INVOICE_DESCRIPTION$|$INVOICE_DUEDATE$|100|CUSTOMFUNCTION]

  5. When the parameters are added, Save the template and you can sent it or do additional operations.

This is how Pay by Square QR code looks like:

pay by square pdf maker
Email Maker – Pay by Square QR Code

Parameters of the custom function definition:

​​​​​​​[CUSTOMFUNCTION|payBySquare|iban|amount|currency|vs|ss|cs|note|due_date|size|CUSTOMFUNCTION]

  • iban = iban of the person / organization which will be receiving a payment, you can aswell use a variable and load a Custom field from Vtiger CRM which has this value filled
  • amount = payment amount, same here can be used variable from an Invoice module like $TOTAL$
  • currency = currency in which payment should be made, we suggest using a $CURRENCYCODE$ variable which will load specific record symbol of the currency
  • vs = variable symbol
  • ss = specific symbol
  • cs = constant symbol
  • note = payment note for recipient
  • due_date = most of the payments need to have a due date, so it has to be filled, we suggest using Due Date variable $INVOICE_DUEDATE$ (each module has own variable for due date)
  • size = size of the QR code symbol, here you define only one number for example 200 means = 200 x 200

Pay by Square Note: Some of the parameters can be removed if not needed, for example:

​​​​​​​[CUSTOMFUNCTION|payBySquare|iban|amount|currency||||note|due_date|size|CUSTOMFUNCTION]

You need only delete the text like “vs/ss/cs” but keep the separators “|”

8.9 Default PDFMaker Template for EMAILMaker

Default PDFMaker Template for EMAILMaker This feature is available from version 0.46 and higher.

Users can set that when sending an email via email maker, the PDF Maker template for the given module is automatically assigned.

Default PDFMaker Template for EMAILMaker Only one template can be loaded per time.

So how does this all works?

  1. Make sure to have selected same module for both Email Maker and PDF Maker templates
  2. Then navigate to PDF Maker template, in our case we choose the Contacts module, and click on the Settings tab and then check “Set as default”:
    You can select Detail view or List view, based on this setting the template will be added to the Email Maker compose email
    PDF maker – Default PDFMaker Template for EMAILMaker
  3. Then go to your record for which you want to send email, click on Send email with email maker button – Default PDFMaker Template for EMAILMaker and you can see that the template of PDF Maker was automatically attached:
    Default PDFMaker Template for EMAILMaker
  4. You can still remove the template if you like by clicking on: Default PDFMaker Template for EMAILMaker
    or Add new templates.

Default PDFMaker Template for EMAILMaker Only one template can be loaded per time.

Need help with EMAIL Maker?

Our support team answers questions about installation, templates and settings.