# Message templates and the delivery log

## Purpose
Keep reusable message templates for your account, and check what Assessor.io sent to
whom and what happened to it.

## Who this is for
Account administrators and campaign managers. The sidebar entry appears for members
who can view, send or manage communications: of the built-in roles, **Account Manager**
and **Campaign Manager**. A campaign manager sees it only when their role is assigned
for the whole account, not for one campaign.

## Open the page

Sidebar **People & settings** › **Communications**. The page has two tabs:
**Templates** and **Delivery log**.

Reminders are not set up here. Their settings are in each campaign's **Reminders and
follow-ups** section, and you send them from the campaign; see
[Add people to a campaign](/operate/tenant-admin/add-people-to-a-campaign).

## Templates

**Message templates** lists the subjects and bodies you send more than once:
**Name** (with the subject beneath it), **Scope**, **Channel**, **State** and
**Updated**.

### Create a template
1. Choose **New template**.
2. Fill in:
   - **Name**: what the template is for. Only staff see it.
   - **Channel**: **Email** or **In app**.
   - **Subject**: optional; the email's subject line.
   - **Body**: the message.
3. Choose **Create template**.

A template needs a name and a body. The text is sent exactly as you write it: there are
no merge fields, so a template cannot fill in each person's name.

### Account templates and campaign templates
A template belongs either to the account or to one campaign, and it is offered only
where it belongs:

- **Templates created on this page are account templates.** They are offered when you
  compose a message from **Team & Access**, on its **Communications** tab.
- **Campaign templates are created from the campaign**: when you compose a message on
  the campaign's participant list, type a name under **New template name** and choose
  **Save template**. They are offered in that campaign's compose panel and in its
  **Send a follow-up** dialog.

So an account template does not appear inside a campaign, and a campaign template does
not appear in another campaign. This page lists both kinds; a campaign template shows
**Campaign** and the campaign's ID under **Scope**.

### Edit or archive a template
Each row has two buttons at its end, to edit the template and to archive it.

- **Editing** changes the template for future messages only. A campaign template stays
  with its campaign.
- **Archiving** asks you to confirm: "Archived templates stop appearing when composing
  a message. Nothing already sent is affected." An archived template is kept, and shows
  again when you tick **Include archived**. You can still edit it there, but there is
  no way to bring it back into use.

## Delivery log

The **Delivery log** tab has two views of what was sent: **Mail transport** and
**Broadcasts**.

### Mail transport
Every email Assessor.io queued for your account: invitations, reminders, shared
reviews, registration notices and broadcasts. One row per message:

| Column | What it shows |
| --- | --- |
| **Recipient** | The address, and the subject beneath it |
| **Message** | What kind of message it was, for example **Invitation** or **Reminder** |
| **State** | **Queued**, **Sending**, **Retrying**, **Sent**, **Failed** or **Suppressed** |
| **Attempts** | How many times the mailer tried |
| **Outcome** | The error, or the last thing the email provider reported: **Delivered**, **Bounced**, **Complaint** or **Dropped** |
| **Provider message** | The email provider's reference for the message |
| **Queued** | When it was queued |

Filter by **State**, or by **Recipient email** (any part of the address). The list
shows 50 messages at a time; **Load more** adds the next 50.

**Suppressed** means the address was held back on purpose, not that sending failed:
the address had bounced, complained or unsubscribed. On a campaign's **Engagement**
tab, such a person is marked **Do not email**.

The mailer retries a failed send by itself, up to three attempts in all. There is no retry
button on this view.

### Broadcasts
One row per recipient for each message sent from a compose panel or a reminder wave:
**Recipient**, **Status** (**Queued**, **Sent**, **Failed** or **Retryable**),
**Attempts**, **Last attempt**, **Outcome** and **Queued**. An invitation or a shared
review is not a broadcast, so it appears only under **Mail transport**.

To retry a failed broadcast, use the **Retry** button in the **Delivery status** list
of the compose panel you sent it from.

## Who can do what

| To | You need |
| --- | --- |
| See the templates and the delivery log | Permission to view communications |
| Create, edit and archive templates | Permission to manage communication templates |

Of the built-in roles, **Account Manager** and **Campaign Manager** hold both.

## Limits and gotchas
- **No merge fields.** Write templates so they read well to everyone who gets them.
- **Only email is sent.** A message on the **In app** channel is recorded in the
  delivery log, but it is not emailed to anyone. Use **Email** for anything a person
  must receive.
- **No language variants.** A template has one subject and one body. The automatic
  emails Assessor.io writes itself (invitations, reminders) follow each person's
  language; see
  [What language your emails go out in](/operate/tenant-admin/transactional-email-language).

## Related pages
- [Add people to a campaign](/operate/tenant-admin/add-people-to-a-campaign): reminders,
  follow-ups and the consent-needed reminder.
- [Track recruitment progress](/operate/tenant-admin/track-recruitment-progress)
- [Send events to your own systems with webhooks](/operate/tenant-admin/webhooks)
- [Account administrator home](/operate/tenant-admin/tenant-admin-home)
