Skip to main content

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:

StepAPIWhat it does
Add recipientsPOST /api/v1/sessions/{id}/recipientsUp to 500 email addresses per call, with the language to write to them in.
Send invitationsPOST /api/v1/sessions/{id}/invitationsSends to every recipient not yet invited. Each invitation has a calendar file (invite.ics) attached.
Send a reminderPOST /api/v1/sessions/{id}/remindersSends to every recipient.
Send a follow-upPOST /api/v1/sessions/{id}/follow-upsSends to every recipient.
Check outcomesGET /api/v1/sessions/{id}/invitationsEach 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:

  1. the workspace's template in the recipient's language;
  2. the built-in message in that language;
  3. the workspace's English template;
  4. 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​

MessageCan be opted out of
InvitationNo. It carries the join link, so suppressing it could lock someone out of a session they were asked to attend.
ReminderYes
Follow-upYes

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.