Pre-requisites

You will require the following:

1. A customer-facing support email address that receives customer queries.
2. A new Slack channel to route emails to, which is different from your existing triage channel.

Configuration

🚧

IT administrator is required to configure DNS settings and activate email forwarding

Step 1 - Setup email redirection

In the Thena web app settings, provide your support email address and select the channel where you want to receive and respond to emails from the dropdown menu.

📘

Note that this will be the channel meant only for receiving and responding to emails. You will continue to receive emails marked as Thena requests on your configured Slack triage channel.

Step 2 - Update DNS settings

You must set up the DNS settings by adding new records to your domain. The values for each hostname are displayed on the Thena web app. The table below provides examples of how a hostname would appear.

Please refer to the image below, where the Hostname, Record type, Priority, and Expected values are populated. You need to set up these values on your DNS platform.

Setup on the DNS platform

Google (Squarespace)

• Navigate to DNS settings in Squarespace
• Add the TXT and MX records using the 'Add more to this record' action

🚧

In Squarespace, the domain name is appended by default to the hostname. Consider removing your domain while copying the hostname from the Thena Webapp. For instance, if your domain is acme.com, use smtp.domainkey.thena instead of smtp.domainkey.thena.acme.com.

---

AWS Route 53

• Navigate to DNS settings in Route 53
• Add the TXT & MX records using the 'Add another record' action

🚧

In Route 53, the domain name is appended by default to the hostname. Consider removing your domain while copying the hostname from the Thena Webapp. For instance, if your domain is acme.com, use smtp.domainkey.thena instead of smtp.domainkey.thena.acme.com.

---

GoDaddy

• Navigate to DNS settings in GoDaddy
• Add the TXT & MX records using the 'Add another value' action

---

Cloudflare

• Navigate to DNS settings in Cloudflare
• Add the TXT & MX records using the 'Add record' action

---

Verification

Click "Verify" on the Thena web app to proceed after completing the DNS setup.

Once you click on 'Verify,' the status of each record should update, and you will be redirected to the next screen.

---

Step 3 - Add auto-forward logic

The last step requires you to set up email forwarding from your current support email address to the email address provided by Thena in the Thena web app. To do this, follow the steps outlined below.

Setup in Email platforms

• Access your email platform settings -> Forwarding/Rules section
• Add Rule/Forwarding address
• In the 'From' field, input your mapped email, and in the 'Forward to' field, input [email protected]

Delete mapped email

You can delete your mapped email at any time, as long as you have another email already mapped. If you need to edit the only mapped email, first add the new email, then remove the original one.

🚧

For email forwarding, your IT admin may have to whitelist Thena's domain and enable auto-forwarding to other domains

📘

Your existing email address will continue to receive emails after the auto-forward setup

Instructions for Gmail and Outlook

Gmail

• Navigate to Gmail settings
• View All Settings -> Forwarding and POP/IMAP
• Add a forwarding address (If Thena's email address has not been previously configured)
• Set Forward a copy of incoming email to to [email protected]

📘

Gmail will send a verification link that you'll need to authorize, after adding a forwarding address

🚧

Make sure to head back to the Forwarding and POP/IMAP tab and enable the Forwarding radio button

Allow members outside your organization

🚧

Navigate to the domain or group settings and make the following updates

Outlook

1. Navigate to Admin Panel -> Click Show All -> Select Exchange
2. Navigate to Mail flow -> Click Rules -> Add a Rule -> Create a new 'Rule'
3. In Set rule conditions, enter a name for the rule and the information below
   1. Apply this rule if 'The recipient' -> is this person [email protected]
   2. Redirect the message to ->is this person [email protected] -> Save
   3. Click Next -> Set Rule Settings -> Next -> Review and Finish
4. Enable the rule by clicking on the Rule in the Rules page and taking the relevant action.

👍

Once your setup is completed, you can add auto forwarding logic to multiple emails belonging to the same domain to setup email integration on

---

Email forwarding channel

You have the option to change the configured Slack channel. If changed, all future incoming emails will be directed to the newly selected channel.

📘

Updating this channel will only mean updating the email communication channel. Your triage will continue to receive emails marked as Thena requests.

❗️

Switching your Slack channel will result in replies on the old channel not triggering emails. This happens because the email feature becomes associated with the newly configured channel.

---

AI-enabled spam filter

Thena's AI stops spam emails from reaching Slack, keeping communication smooth and focused. It is recommended that you disable it during testing to allow a thorough assessment of all email interactions.

🚧

Spam blocking is disabled by default

---

Additional email support

This feature allows you to forward emails to Thena from multiple email addresses. To add additional emails, follow the outlined steps:

1. Enter the email address in the provided field and click "Add & verify."
2. Verified emails will appear in the list below.
3. Click on the sync button to sync these emails and allow forwarding.
4. You can also remove an email mapping, which will stop forwarding emails to Thena from that address.

---

Use cases

Email <> Slack - Bidirectional conversation flow

Once the setup is configured, all emails will be forwarded to the configured Slack channel. Your support agents can reply to the email from Slack, and your customer will receive the response on the email where they originally reached out.

Emails as Thena requests

Thena routes emails received in your configured Slack channel, identifying them as requests, and sends internal notifications on the configured triage channel.

After receiving the request, you can perform standard actions such as adjusting its priority, responding, assigning it, and more.

Reply-to support in customer emails

When end-customers submit a form on your dashboard or other interfaces inputting their email address to receive replies on, Thena enables you to send replies seamlessly by receiving these form submissions via email. This allows you to respond directly from either Slack or the Thena web app, ensuring that the email reply is sent from the configured email address to the customer's chosen email address.

🚧

Customer inputted email address should be populated under the "Reply-to" header after form submission.

Google group support

In order to use your Google group email as the support email configuration in Thena, follow the outlined steps:

1. Add your support as one of the members to the group. This will ensure all emails to your support alias make their way to Thena.
2. If you have any workflows in your app where a user is taken to email (Eg. to file a bug or request support), please make sure you have set up a reply-to header. This can be done using a third party service or by setting replies to go to the author (this is a Google group setting).

FAQs

How long does verifying the DNS after making the relevant changes take?

The verification process may range from one minute to up to twenty-four hours.

What if my email attachment is too large for Slack?

If the email attachment surpasses Slack's size limits, we provide a link to our encrypted store (you can also configure your own S3 bucket) to view or download the attachment.

What does the product do in case of a failed email post?

In case of a failed post, the system will attempt to repost the email twice. If still unsuccessful, an error notification will be sent via a Slack DM and displayed on the channel. This will include an option to retry the post manually.

How are known domains or customers identified?

When an email is received from a known customer domain (one recognized on Slack), the system associates that email with the corresponding customer account, ensuring its visibility on Kanban, App Home, and other channels.

Can I set multiple emails to be routed on Thena?

Once you complete the setup with one email ID, you can configure auto-forwarding on multiple email IDs belonging to the same domain. You must add auto-forwarding to those emails, and your setup is ready.

If I already have a DMARC policy, do I need to modify it?

If your DMARC policy has strict verification for subdomains with aspf=s; adkim=s;, you will need to update your DMARC policy to use relaxed verification instead. This can be done by updating your DMARC policy to instead use the following values: aspf=r; adkim=r;.