Skip to content

Commit 0559573

Browse files
committed
docs: Add page on message usage
1 parent 56cc11b commit 0559573

File tree

2 files changed

+92
-1
lines changed

2 files changed

+92
-1
lines changed

docs/messages.md

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
---
2+
id: messages
3+
title: Messages
4+
sidebar_label: Messages
5+
---
6+
7+
Messages (emails) are the primary method of communication with your applicants and attendees. Your organizing team can send messages directly to various segments of your applicants, in addition to automated, continuous messages in response to certain events (e.g. upon accepting or checking-in an applicant).
8+
9+
This takes the place of traditional email list/campaign software by integrating directly with your applicant data and admissions process.
10+
11+
## Types of messages
12+
13+
### Bulk messages
14+
15+
These emails are single-use, "broadcast"-style messages set out to segments (or all) of your applicants.
16+
17+
#### Recipient segments
18+
19+
Multiple recipient groups can be chosen. These include:
20+
21+
* **Status** — Incomplete, complete, accepted, denied, RSVP'd, etc
22+
* **School** — Confirmed or accepted students from a given school
23+
* **Bus-list** — Passengers signed up for a given bus
24+
* **Custom (SQL) lists** — Custom SQL-based queries built in Blazer
25+
26+
The input supports auto-complete; start typing to search and select.
27+
28+
#### Custom SQL recipients with Blazer
29+
30+
If the pre-built options for recipients don't fit your needs, you can also build your own email list using SQL in the Blazer tool.
31+
32+
>The `user_id` column **must** present in the SQL results for emails to be sent.
33+
34+
1. Open Blazer (http://your-site/blazer)
35+
2. Create a new query (with a name)
36+
37+
Examples:
38+
39+
`SELECT user_id FROM questionnaires WHERE school_id=123`
40+
41+
`SELECT id as user_id FROM users WHERE provider='mlh'`
42+
43+
(additional fields can be included, but won't be used for email purposes)
44+
45+
3. Click "Run" to preview your results, or "Create" to save the query
46+
4. Go back to the message (http://your-site/manage/messages) and select the Blazer query
47+
5. Save the message. On the message detail page, you should see the # of expected recipients.
48+
49+
### Automated messages
50+
51+
Automated emails can also be sent out upon certain events happening. All events and their descriptions are listed at http://your-site/manage/messages, which include:
52+
53+
* **Questionnaire status** — Upon being accepted, denied, RSVP'd, etc
54+
* **Bust list** — Becoming a passenger or bus captain
55+
56+
These messages are sent immediatley upon an applicant entering the given state. For example, when an admin marks someone as "accepted," they will immediately receive any automated messages assocaited with the "Questionnaire Status: Accepted" event.
57+
58+
## Message formatting
59+
60+
Messages support full markdown & HTML.
61+
62+
### Template variables
63+
64+
Message bodies can make use of template variables to help personalize and streamline emails. These include information such as `{{first_name}}` and `{{last_name}}`, URLs such as `{{apply_url}}` and `{{rsvp_url}}`, and logical conditions such as `{{bus_list_exists?}}`. The full list of variables, their explanations, and example values can be found at the bottom of the message edit page.
65+
66+
Templating is powered by [mustache](https://mustache.github.io/mustache.5.html).
67+
68+
Example:
69+
70+
```md
71+
## RSVP Confirmation
72+
73+
Hey {{first_name}},
74+
75+
Thank you for your RSVP to {{hackathon_name}}! We can't wait to see you.
76+
77+
{{#bus_list_exists?}}
78+
You've also signed up for the {{bus_list_name}} bus. Keep an eye out for more information closer to the event for pickup times & locations.
79+
{{/bus_list_exists?}}
80+
81+
Let us know if you have any questions in the meantime.
82+
83+
\- The {{hackathon_name}} Team
84+
```
85+
86+
## Message template
87+
88+
The overall message template is used for all outgoing emails and provides the basic structure & style for your emails. A basic template is included for you by default, but can be customized if you need it.
89+
90+
Visit http://your-site/manage/messages/template for more details.
91+

website/sidebars.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"docs": {
3-
"HackathonManager": ["running-a-hackathon", "busses", "questionnaires"],
3+
"HackathonManager": ["running-a-hackathon", "busses", "questionnaires", "messages"],
44
"API Usage": ["api"],
55
"Deployment": [
66
"deployment",

0 commit comments

Comments
 (0)