Skip to main content

Customize email notifications in Chatwoot

Chatwoot allows customization of email notifications in self hosted installations.

To customize the email notifications, follow the instructions below. Inorder to update the content, you have to add a new template in the Database, here is how you can do it.

1. Login into the rails console.​

For Heroku installation, login to your account, go to the app. Click on "More", select "Run Console" from the dropdown menu. Enter the following command and hit run

heroku run rails console

For Linux VM installations, go to directory where Chatwoot code is available. If you have used the installation script, the default path is /home/chatwoot/chatwoot. Run the following command.

RAILS_ENV=production bundle exec rails console

2. Create a new template for the emails. Execute the following commands.​

email_template = EmailTemplate.new
email_template.name = 'conversation_assignment' # Accepts conversation_assignment, conversation_creation
email_template.body = '// Enter your content'
email_template.save!

Variables​

Template would receive 3 variable

  1. user - Use {{ user.name }} to get the username.
  2. conversation - Use {{ conversation.display_id }} to get the conversation ID
  3. action_url - This is the URL of the conversation.

Default content​

Default content of the above template is as shown below

1. Conversation Assignment​

<p>Hi {{user.available_name}},</p>
<p>Time to save the world. A new conversation has been assigned to you</p>
<p> Click <a href="{{action_url}}">here</a> to get cracking.</p>

2. Conversation Creation​

<p>Hi {{user.available_name}}</p>

<p>Time to save the world. A new conversation has been created in {{ inbox.name }}</p>
<p>
Click <a href="{{ action_url }}">here</a> to get cracking.
</p>

We use Liquid templating engine internally, so all valid operators can be used here.