Messaging
Notifications
This manual is a draft and may change.
What it does
Notifications is the app behind every message your site sends. It keeps a record of what was sent and what failed, retries failures on its own, and lets each member choose how they want to be told about things. Your staff can look at the log but cannot change it.
Who uses it
- Your staff use the Outbound log, Retries and Email templates tabs to see what went out.
- Your members use Notifications in their account to choose email or in-app notices.
Setup
- Ask your 1vsM contact to install Notifications on your site.
- Make sure your administrator has the email settings and the scheduled workers running, so queued messages are sent and failures are retried.
- Give anyone who should read the logs the access they need to see the Notifications tabs.
- Open Email templates and preview each template to check how your messages look.
- Send yourself a test notice, then look for it in Outbound log.
Admin tasks
Outbound log
- Open Outbound log under Notifications.
- Use the status filter (All, Pending, Processing, Sent, Failed, Cancelled) and the channel filter (All channels, Email, In-app, Webhook, SMS).
- Read each row: ID, Created, Channel, Topic, To, Status, Attempts, Scheduled / sent, Last error. Message text is never shown.
- Below the table, Email audit log (latest 20) shows When, To, Subject, Result and Error.
Retries
- Open Retries. It lists messages waiting for another attempt or given up on, with State, Attempts, Next attempt and Last error.
- Failed messages are retried automatically: first after 1 minute, then the wait doubles, up to 6 hours. After the last attempt a message stays here as dead. Nothing is re-sent from this page.
Email templates
- Open Email templates and press Preview on a template.
- The page shows the placeholders and a sample of the email. Nothing is sent from here.
Member view
Members see a Notifications tab in their account when the site has set it up. It says "Choose how we reach you for each kind of notification. Security alerts are always on." and shows a table with a row for each kind and a column for each channel (In-app and Email). Press Turn on or Turn off to change a choice. Security rows show "Always on". If the member has a phone number on file, a Text messages section lets them stop text messages.
Styling it to your brand
This app takes its colours, fonts and corners from the brand profile you enter once in 1vsm.com's Brand intake. It applies to every app automatically, so there is nothing to set up inside this app.
Troubleshooting
- A message is not delivered. Look in Outbound log for its status and Last error, then in Retries to see when the next attempt is.
- A message shows as dead. All attempts failed. Fix the cause, such as a wrong address or mail settings, and send it again from the source.
- The tabs do not appear. Your login needs an administrator, notify manager or notify viewer role.
- A member cannot change a choice. They see "That choice is not available." for kinds they cannot switch, or "Your session expired. Reload the page and try again."
- The Email audit log is empty. No email has been logged yet.
- A template preview is blank. No template is installed.
FAQ
Can I resend a failed message from the log? No. These screens are read only.
Can members turn off everything? No. Security notices are always on.
Can I see the text of a message? No. Message bodies are never shown in the log.
How long are messages kept? Sent messages for 30 days and failed ones for 7 days by default.
Can I edit the email template? Not from these screens.
What to connect
These accounts make the app work with your own services. Enter them once in Set up your site in your account.
- Telegram — optional. Posting announcements to your Telegram channel and receiving alerts there.
- Outgoing email — needed. Receipts, confirmations, newsletters and form replies sent from your own address.