Tiledesk Developer Hub
WebsiteCommunityTutorialsGet started
  • Introduction
  • Community
  • Ask for Support
  • Public Roadmap and Changelog
  • Tutorials
  • Widget
    • Widget SDK
    • Javascript API: Methods
    • Javascript API: Attributes
    • Javascript API: Listeners/Events
    • Widget Authentication
    • Widget Angular integration
    • Widget React integration
    • Widget for Android with WebView
    • Widget for iOS with WKWebView
    • Widget for Flutter with WebView
    • Widget for React with WebView
    • Widget for Wix Website platform
    • Tutorials
      • Hide widget
      • Show/Hide widget programmatically
      • Force widget loading without user interaction
      • Mobile positioning
      • Custom size (width/height)
      • Installing widget on selected pages
    • Conversation Embedded Apps
      • Payment App Tutorial
      • Prechat form App Tutorial
    • Advanced
      • Preset the Widget on a specific Department
      • Authentication Flow
      • Widget protocol specs
      • Prechat Form JSON specs
      • Prevent multiple conversations
      • Old versions
        • Web SDK v4
  • External Chatbot
    • Introduction
    • Hello World tutorial
    • Chatbot to Human handoff
    • Send Text Buttons
    • Advanced Tutorials
      • Introduction
      • Tutorial 1 - Dialogflow as external chatbot
      • Tutorial 2 - Buttons and images
      • Tutorial 3 - Automatic human handoff with fallback intent
      • Tutorial 4 - Explicit Human handoff with user intent
      • Tutorial 5 - Gracefully handling operating hours during handoff
      • Generate Dialogflow Google Credentials file
    • Rasa tutorials
      • Rasa Tutorial 1 - Rasa as external chatbot
  • Resolution bot
    • Introduction
    • Quickstart
    • Webhook service
    • Rich messages
    • Tutorials
      • Chatbot chooser (multilanguage)
      • Department chooser
      • Order info (webhook)
  • APIs
    • REST APIs
      • Introduction
      • Authentication
      • Requests
      • Leads
      • Messages
      • Activities
      • Projects
      • Team
      • User
      • Analytics
      • Canned responses
      • Tags
      • Events
      • Jwt
      • Labels
      • Images
      • Files
      • Segments
      • Chatbots
      • Knowledge Bases
        • Knowledge Base
        • Contents
        • Question & Answer
      • Management Api
        • Departments
        • Groups
    • NodeJS SDK
    • Webhooks
      • Subscriptions
    • Conversation Messages APIs tips
    • Realtime API
    • JWT Authentication
      • JWT Custom authentication Tutorial
    • Tutorials
      • REST API
        • Sending and receiving messages with Tiledesk APIs
        • PHP Tiledesk REST API example
        • Import multiple messages into Tiledesk using REST APIs from third party app
      • Webhooks
        • Custom Request assignment
        • Request transcript on close
  • Apps
    • Build Custom App - Quick start
    • External Channels integration flow diagram
    • Telegram integration tutorial
  • Dashboard & AgentChat SDK
    • Dashboard SDK
    • Agent Chat SDK
  • Architecture
    • Architecture overview
    • Components list
    • Bot Design diagram
    • Multi Channel Message Flow
  • Installation
    • Installation
    • Running Tiledesk using Docker Compose
    • Running Tiledesk with Kubernetes using Helm
    • Choosing Hardware
  • Configuration
    • Chat21 channel configuration
    • Email parameters and templates configuration
    • Configure the logging system
Powered by GitBook
On this page
  • Enable the email subsystem
  • SMTP configuration
  • Email template configuration

Was this helpful?

  1. Configuration

Email parameters and templates configuration

PreviousChat21 channel configurationNextConfigure the logging system

Last updated 1 year ago

Was this helpful?

Use this information to configure the email services for the on-premise installation for outbound email to manage all emails sent from Tiledesk to users such as project invitations, email verification, subscriptions and notifications. Tiledesk uses to send the emails.

Enable the email subsystem

To enable the email service set the follow env property to true of your tiledesk-server component. The default value is false.

EMAIL_ENABLED=true

SMTP configuration

The following properties can be configured for the Outbound SMTP subsystem type:

  • EMAIL_HOST=YOUR_EMAIL_HOST Specifies the host name (defaults to "localhost") of the SMTP host, that is, the host name or IP address of the server to which email should be sent.

  • EMAIL_USERNAME=YOUR_EMAIL_USERNAME Specifies the user name of the account that connects to the smtp server.

  • EMAIL_SECURE=true #defaults to 587 if is secure is false or 465 if true If true the connection will use TLS when connecting to server. If false (the default) then TLS is used if server supports the STARTTLS extension. In most cases set this value to true if you are connecting to port 465. For port 587 or 25 keep it false.

  • EMAIL_PORT=25 Is the port to connect to (defaults to 587 if is secure is false or 465 if true)

  • EMAIL_PASSWORD=YOUR_SMTP_PASSWORD Specifies the password for the user name used in EMAIL_USERNAME.

  • EMAIL_FROM_ADDRESS=FROM_EMAIL_ADDRESS Specifies the email address from which email notifications are sent. This setting is for emails that are not triggered by a user, for example, activity notification emails.

  • EMAIL_BASEURL= This is the dashboard endpoint. Default value is :

Email template configuration

In Tiledesk you can customize the emails template using the following env variables (multiline strings) of your tiledesk-server component :

  • EMAIL_ASSIGN_REQUEST_HTML_TEMPLATE Email sent to notify a new request in the assigned mode.

  • EMAIL_ASSIGN_MESSAGE_EMAIL_HTML_TEMPLATE Email sent to notify a new request in the assigned mode for inbound email channel.

  • EMAIL_POOLED_REQUEST_HTML_TEMPLATE Email sent to notify a new request in the pooled mode.

  • EMAIL_POOLED_MESSAGE_EMAIL_HTML_TEMPLATE Email sent to notify a new request in the pooled mode for inbound email channel.

  • EMAIL_NEW_MESSAGE_HTML_TEMPLATE Email sent to the requester to notify a new message when the requester is offline

  • EMAIL_TICKET_HTML_TEMPLATE Email sent to the requester to notify a new message for inbound email channel.

  • EMAIL_FOLLOWER_HTML_TEMPLATE Email sent to the request follower to notify an update.

  • EMAIL_DIRECT_HTML_TEMPLATE Email sent for direct message.

  • EMAIL_RESET_PASSWORD_HTML_TEMPLATE Email sent when a user reset the password.

  • EMAIL_PASSWORD_CHANGED_HTML_TEMPLATE Email sent when the password is changed.

  • EMAIL_EXUSER_INVITED_HTML_TEMPLATE Email sent when a agent invites an existing platform user.

  • EMAIL_NEWUSER_INVITED_HTML_TEMPLATE Email sent when a agent invites a new user.

  • EMAIL_VERIFY_HTML_TEMPLATE Email sent when an agent signup on the platform.

  • EMAIL_SEND_TRANSCRIPT_HTML_TEMPLATE If the property "Transcript by email" is enabled this email is sent automatically at the end of each chat to the requester.

Please refer to these guides for multi-line env variables:

You can find the default email templates under the folder of the tiledesk-server project

for Kubernetes

NodeMailer
https://YOOURDOMAIN.com/dashboard
https://panel.tiledesk.com/v3/dashboard
template/email
Yaml multi-line
Helm multi-line control