Invitations and reminders
Murmle can email people an invitation to a session, with its join link and a calendar file, and send reminders and follow-ups afterwards. Sending is done through the workspace API; the console does not have a screen for it.
Sending
All of these act on one session and need the presenter, creator, admin or owner role:
| Step | API | What it does |
|---|---|---|
| Add recipients | POST /api/v1/sessions/{id}/recipients | Up to 500 email addresses per call, with the language to write to them in. |
| Send invitations | POST /api/v1/sessions/{id}/invitations | Sends to every recipient not yet invited. Each invitation has a calendar file (invite.ics) attached. |
| Send a reminder | POST /api/v1/sessions/{id}/reminders | Sends to every recipient. |
| Send a follow-up | POST /api/v1/sessions/{id}/follow-ups | Sends to every recipient. |
| Check outcomes | GET /api/v1/sessions/{id}/invitations | Each recipient's status, and the mail provider's own message when a send failed. |
Each send reports how many were sent, suppressed and failed. A failure is reported per recipient with the provider's words - "mailbox full" calls for a different response from "domain does not exist". Reminders are sent when you ask for them; nothing is sent on a schedule.
The calendar file is also available on its own from GET /api/v1/sessions/{id}/invitations/calendar.
Its times are in UTC, so calendar applications show the right local time to everyone.
Languages and templates
Built-in messages exist in English, French, Portuguese and Swahili. A workspace can write its own
template for each kind of message and language, using the placeholders {title}, {join_url},
{join_code} and {unsubscribe_url}.
For each recipient, the language comes first and customisation second:
- the workspace's template in the recipient's language;
- the built-in message in that language;
- the workspace's English template;
- the built-in English message.
So a workspace that has customised its English invitation but not its Swahili one sends a Swahili reader the built-in Swahili, not the customised English.
Opting out
| Message | Can be opted out of |
|---|---|
| Invitation | No. It carries the join link, so suppressing it could lock someone out of a session they were asked to attend. |
| Reminder | Yes |
| Follow-up | Yes |
A person who has opted out does not receive reminders or follow-ups from any workspace. Such sends are counted as suppressed.
Invitations and anonymity
An invitation list is not a participant list. Murmle has no link between the people it emailed and the participants who joined, in any privacy mode - so "who has not answered yet?" cannot be answered except by asking people in an identified session. Email addresses are stored encrypted.