{"id":24,"date":"2026-09-09T04:25:38","date_gmt":"2026-09-09T04:25:38","guid":{"rendered":"https:\/\/nirohelp.com\/docs\/24\/notification-emails\/"},"modified":"2026-09-16T15:19:27","modified_gmt":"2026-09-16T09:19:27","slug":"notification-emails","status":"publish","type":"nirohelp_doc","link":"https:\/\/nirohelp.com\/docs\/email-notifications\/notification-emails\/","title":{"rendered":"Notification emails and placeholders"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">NiroHelp sends an email for every meaningful ticket event. All of it is editable under <strong>NiroHelp \u2192 Settings \u2192 Emails<\/strong>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">The seven emails<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Email<\/th><th>Sent to<\/th><th>When it goes out<\/th><\/tr><\/thead><tbody><tr><td>Login verification code<\/td><td>Visitor<\/td><td>A 6-digit login code was generated.<\/td><\/tr><tr><td>Magic link login<\/td><td>Visitor<\/td><td>A one-click login link was generated.<\/td><\/tr><tr><td>New ticket \u2014 to client<\/td><td>Client<\/td><td>A ticket is created.<\/td><\/tr><tr><td>New ticket \u2014 to agent<\/td><td>Agent<\/td><td>A ticket is created. <strong>Skipped when no agent was assigned.<\/strong><\/td><\/tr><tr><td>Agent replied \u2014 to client<\/td><td>Client<\/td><td>An agent answers the ticket.<\/td><\/tr><tr><td>Client replied \u2014 to agent<\/td><td>Agent<\/td><td>A client answers the ticket.<\/td><\/tr><tr><td>Ticket resolved \u2014 to client<\/td><td>Client<\/td><td>The ticket is marked <strong>Resolved<\/strong>. Other status changes send nothing.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Each has three editable fields: <strong>Header<\/strong>, <strong>Subject<\/strong> and <strong>Body<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"1035\" height=\"671\" src=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/login-verification.webp\" alt=\"login verification\" class=\"has-border-color has-ast-global-color-0-border-color wp-image-138\" style=\"border-width:2px\" srcset=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/login-verification.webp 1035w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/login-verification-300x194.webp 300w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/login-verification-1024x664.webp 1024w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/login-verification-768x498.webp 768w\" sizes=\"auto, (max-width: 1035px) 100vw, 1035px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Blanking a body does not stop the email.<\/strong> The screen says &#8220;leave any field blank to skip that piece&#8221;, but the plugin does not check &#8211; an email with an empty body goes out instead. Genuinely stopping one from sending needs a developer, or a mail plugin that can filter by subject.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Placeholders<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">These are replaced when the email is sent, and work in any of the three fields.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Placeholder<\/th><th>Replaced with<\/th><th>Available in<\/th><\/tr><\/thead><tbody><tr><td><code>##site_name##<\/code><\/td><td>Your site title.<\/td><td>every email<\/td><\/tr><tr><td><code>##client_name##<\/code><\/td><td>The client&#8217;s display name.<\/td><td>the five ticket emails<\/td><\/tr><tr><td><code>##agent_name##<\/code><\/td><td>The assigned agent&#8217;s display name.<\/td><td>the five ticket emails<\/td><\/tr><tr><td><code>##ticket_id##<\/code><\/td><td>The ticket&#8217;s number.<\/td><td>the five ticket emails<\/td><\/tr><tr><td><code>##ticket_subject##<\/code><\/td><td>The ticket title.<\/td><td>the five ticket emails<\/td><\/tr><tr><td><code>##ticket_link##<\/code><\/td><td>A one-click link that signs the client in and opens the ticket.<\/td><td>the five ticket emails<\/td><\/tr><tr><td><code>##ticket_product##<\/code><\/td><td>The products on the ticket, comma-separated.<\/td><td>the five ticket emails<\/td><\/tr><tr><td><code>##ticket_priority##<\/code><\/td><td>The urgency. Empty when the client left it blank.<\/td><td>the five ticket emails<\/td><\/tr><tr><td><code>##code##<\/code><\/td><td>The 6-digit verification code.<\/td><td>Login verification code only<\/td><\/tr><tr><td><code>##link##<\/code><\/td><td>The one-click login link.<\/td><td>Magic link login only<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The ticket placeholders only work in the five ticket emails. Putting <code>##client_name##<\/code> in the verification-code email leaves the text as-is, because at that point no client has been identified yet. Basic HTML in a body survives; scripts do not.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Branding<\/h2>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"1224\" height=\"400\" src=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/email-branding.webp\" alt=\"email branding\" class=\"has-border-color has-ast-global-color-0-border-color wp-image-137\" style=\"border-width:2px\" srcset=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/email-branding.webp 1224w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/email-branding-300x98.webp 300w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/email-branding-1024x335.webp 1024w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/email-branding-768x251.webp 768w\" sizes=\"auto, (max-width: 1224px) 100vw, 1224px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Two fields under <strong>Emails \u2192 Branding<\/strong> apply to every email:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Email logo<\/strong> \u2014 an image, shown at the top.<\/li>\n\n\n\n<li><strong>Email footer text<\/strong> \u2014 the small line at the bottom. Its default is a copyright line built from the current year and your site name.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Who the email comes from<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">NiroHelp sends through WordPress, so the sender address is whatever WordPress uses &#8211; usually something like <code>wordpress@your-domain<\/code>, which many mail providers treat with suspicion.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Install an SMTP plugin<\/strong> \u2014 WP Mail SMTP, FluentSMTP or similar &#8211; and set your real sending address there. NiroHelp needs no configuration for it, and this is the single biggest fix for &#8220;our notification emails go to spam&#8221;.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Testing them<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The fastest loop is to file a ticket as a client and reply as an agent, on a staging site with a mail-catching plugin installed.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Do not send test mail to a real client address from a copy of your live site.<\/strong> These emails carry working one-click login links.<\/p>\n","protected":false},"author":1,"featured_media":0,"template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"nirohelp_product":[],"nirohelp_topic":[6],"class_list":["post-24","nirohelp_doc","type-nirohelp_doc","status-publish","hentry","nirohelp_topic-email-notifications"],"_links":{"self":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc\/24","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc"}],"about":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/types\/nirohelp_doc"}],"author":[{"embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/media?parent=24"}],"wp:term":[{"taxonomy":"nirohelp_product","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_product?post=24"},{"taxonomy":"nirohelp_topic","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_topic?post=24"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}