A transactional email is what your system sends someone because of something they did: an order confirmation, an access code, a delivery notice. In Content βΊ Transactional you write those emails in the dashboard, and the integrated system only says which template to use and with which values. At Casa Moura CafΓ©s, the online store sends the pedido-confirmado template on every purchase β and when Renata wants to change a sentence, she changes it here, without asking for a change in the store's code.
Create a template
Click New template and fill in:
- Key β the name the system sends to choose the template. Lowercase letters, numbers and hyphens only, unique in the account, and it cannot change after creation. Choose it with the integrator in mind:
pedido-confirmado, nottemplate1. - Name β how your team recognizes the template in the list.
- Active template β see below what happens when you turn it off.
- Subject β accepts variables, like the other fields.
- HTML content β with the Preview tab to check it and the toolbar with Generate with AI, Use template and Save as template.
- Plain text version, in the Plain text tab β optional. It shows in email clients that do not display HTML and helps the spam score.
The template does not store a sender: it comes from the system's call or, if the call does not say, it is the account's default sender.
Variables: the contract with the system
Where a value from the call goes, write its name between double braces: {{numero_pedido}}. Right below the subject, Detected variables shows, in real time, the list taken from the subject, the HTML and the plain text version. That list is exactly what the call must send β no more, no less:
- if the call does not send a variable the template uses, the send is refused;
- if the call sends a variable the template does not use, the send is refused too.
The rule is strict on purpose: without it, the email would go out with a hole where the data should be β "Your order no. is confirmed" β and count as delivered.
Casa Moura's pedido-confirmado has the subject "Pedido {{numero_pedido}} confirmado" and, in the HTML, {{first_name}} and {{previsao_entrega}}. The store sends all three values on every purchase.
Three differences from campaigns
- Values come from the call, not from the contact profile. That is why the campaign variable list does not show here.
- There is no fallback value:
{{first_name|there}}is not recognized. If a piece of data may be missing, the system must send the alternative text. - The value goes in as text: HTML markup sent in a variable shows up written out in the email, not formatted.
Write the variable with no spaces inside the braces. {{ numero_pedido }} is neither detected nor replaced, and goes out like that in the email.
Changing a template that is in use
Saving applies from the next send. Changing copy, colors and layout is safe. What calls for agreeing in advance with whoever runs the integration is touching the variables:
- adding a variable makes current calls, which do not send it, start being refused;
- renaming or removing a variable makes the system send a name the template no longer uses β also refused.
Take special care with Use template: a marketing email template usually brings contact variables, such as {{unsubscribe_url}}, which here become requirements of the call. The screen warns you which ones came in; replace or remove those that make no sense here before saving.
Deactivate and delete
- Deactivate (turn off Active template) makes calls with that key be refused, but keeps the text. It is how you take a send offline and bring it back later.
- Delete does the same, with no way back. The key becomes free, and a new template with it answers in its place.
Where to go next
- Create and use email templates β the library behind Use template.
- Media library β the address of the images in the HTML.
- Personalize with variables β how variables work in campaigns, for comparison.
In short: create the template with a stable key, write variables without spaces and treat the detected variables list as a contract β the call sends exactly those β, agree with the integrator before changing them, and use the active switch to take a send offline without deleting the text.