Email in the TMS

This article outlines everything from default behavior and sending options to mailbox configuration and best practices for success.

Session: March 28, 2023
Delivered by: Tim Lucas

Overview

The TMS platform offers a flexible and robust email system, with two primary methods for sending:

1. SendGrid (Default)

  • Used when no mailbox is connected.
  • Delivery comes from a shared system-managed domain (e.g., mailer.tai-software.com).
  • Emails are not saved in the broker's "Sent" folder and are often delivered without proper “authority”.

2. Staff Mailbox

  • Personalized email sending through a connected account (Google, Microsoft, Front, or SMTP)
  • Sent messages appear in the staff member’s "Sent" folder or equivalent.
  • Uses proper email authority to reduce the risk of spam and undelivered mail.

Where Emails Can Be Sent in TMS

The system sends emails through several key functions:

Module

Description

Send Message

Compose and send messages directly from a shipment or shipment search.

Bulk Operations

Send messages about multiple shipments to one or more customers in a single click.

Invoice Delivery

Email invoices with attachments like BOLs or PODs.

Workflow Automation

Trigger automated notifications (e.g., booking confirmations, updates).

Reports

Send scheduled or manual reports to users or external recipients.

Notifications

Shipment alerts such as status updates, pickup, or out for delivery notifications.

Setting Up Staff Mailboxes

Staff mailboxes allow emails to be sent from individual or shared mailboxes. You can configure this by:

  1. Go to your LSP Staff profile or User dropdown in the navigation menu.
  2. Select Connect Email Provider.
  3. Choose from:
    • Google - Secure connection with OAuth and Google APIs
    • Microsoft - Secure connection with OAuth and SMTP Client
    • Front - Secure connection with OAuth and Front APIs
    • Other - requires manual setup (SMTP server, port, username, and password)

Note:

  • If using 2FA (Google or Microsoft), an app-specific password may be required for SMTP.
  • Once connected, the system will default to sending from the staff mailbox.

Benefits of Using Staff Mailboxes

  • Sent messages are available in the user's Sent folder.
  • Helps reduce the risk of spam or undelivered messages by using proper MX authority.
  • Enables better cross-team visibility when using shared mailboxes.

Email Activity Tracking

All sent emails are recorded in:

  • Shipment Activity Log – for shipment-specific emails.
  • Email Activity Log – for all emails sent by the current user.

You can see:

  • Status (sent, failed, delivered)
  • Timestamps
  • Recipients
  • Content (partial preview)

This is useful for:

  • Confirming whether or not a message was sent, the contents, and to whom.
  • Debugging delivery issues.
  • Tracking communication history.

Common Issues & Resolutions

 

Issue

Resolution

Email not sent

Check the mailbox connection or email activity log.

The customer didn’t receive the email

Confirm address, check spam folders, and verify mailbox connection.

Sent folder missing email

Ensure the message was sent using the staff mailbox config and not SendGrid.

Emails marked as spam

Ensure the message was sent using the staff mailbox config. If using SendGrid, ensure the proper MX and TXT records are configured on the Domain.

Best Practices

  • Always connect your mailbox for a better email experience.
  • Use clear subject lines and professional language.
  • Confirm delivery through email activity before assuming failure.
  • Work with your IT team to ensure domain authentication if needed.
  • Keep templates consistent and branded.