Changes for page Sending Bulk Messages from the Contract Report

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,123 +1,125 @@
1		-~== Overview ==
	1	+= =
2	2
	3	+== Overview ==
	4	+
3	3	Member Manager lets you send bulk emails and text messages to members directly from the Contract Report. This is useful when you want to message a specific contract group — for example, all members on a Frozen contract, all members in a specific program, or all members with contracts ending this month.
4	4
5	5	The feature uses the same email and SMS infrastructure as the Members tab, so opt-out preferences, communication settings, and personalization tokens all behave the same way.
6	6
7		-~-~-~-~-
	9	+----
8	8
9		-~== Before You Start ==
	11	+== Before You Start ==
10	10
11	11	Make sure your members have:
12	12
13		-~* Email addresses on file with the TCPA email opt-in checked (for emails)
14		-~* Mobile phone numbers on file with the TCPA text opt-in checked (for texts)
15		-~* Reminders preference set to a value that allows the channel you're sending on:
16		-~** ~*~*Nothing~*~* → receives neither email nor text
17		-~** ~*~*Email Only~*~* → receives email only
18		-~** ~*~*Text Only~*~* → receives text only
19		-~** ~*~*Both~*~* → receives both
	15	+* Email addresses on file with the TCPA email opt-in checked (for emails)
	16	+* Mobile phone numbers on file with the TCPA text opt-in checked (for texts)
	17	+* Reminders preference set to a value that allows the channel you're sending on:
	18	+** **Nothing** → receives neither email nor text
	19	+** **Email Only** → receives email only
	20	+** **Text Only** → receives text only
	21	+** **Both** → receives both
20	20
21	21	Members who don't meet these requirements will be filtered out automatically and excluded from the send. The recipient count shown before send already reflects this filtering.
22	22
23		-~-~-~-~-
	25	+----
24	24
25		-~== Step-by-Step ==
	27	+== Step-by-Step ==
26	26
27		-~=== 1. Run a Contract Report Query ===
	29	+=== 1. Run a Contract Report Query ===
28	28
29		-Navigate to ~*~*Reports → Contract Report~*~*. Set your filters (status, program, location, contract dates, etc.) and run the query.
	31	+Navigate to **Reports → Contract Report**. Set your filters (status, program, location, contract dates, etc.) and run the query.
30	30
31		-~=== 2. Switch to the Detail View ===
	33	+=== 2. Switch to the Detail View ===
32	32
33		-The bulk messaging buttons only appear on the ~*~*Detail~*~* view, not the Summary view.
	35	+The bulk messaging buttons only appear on the **Detail** view, not the Summary view.
34	34
35		-~{~{info}}
	37	+{{info}}
36	36	If you ran the query on Summary and then switched to Detail, re-run the query on Detail before clicking the messaging buttons.
37		-~{~{/info}}
	39	+{{/info}}
38	38
39		-~=== 3. Choose Your Action ===
	41	+=== 3. Choose Your Action ===
40	40
41	41	Four buttons appear at the top of the report:
42	42
43		-~|=Button|=What It Does|
44		-~|~*~*Email All Found~*~*|Sends an email to every member in the current result set|
45		-~|~*~*Email Selected~*~*|Sends an email to only the members you've checked in the table|
46		-~|~*~*Text All Found~*~*|Sends a text to every member in the current result set|
47		-~|~*~*Text Selected~*~*|Sends a text to only the members you've checked in the table|
	45	+|=Button|=What It Does|
	46	+|**Email All Found**|Sends an email to every member in the current result set|
	47	+|**Email Selected**|Sends an email to only the members you've checked in the table|
	48	+|**Text All Found**|Sends a text to every member in the current result set|
	49	+|**Text Selected**|Sends a text to only the members you've checked in the table|
48	48
49		-~{~{info}}
	51	+{{info}}
50	50	If a member has multiple contracts that match your query, they will only receive one message — the system deduplicates by member ID before sending.
51		-~{~{/info}}
	53	+{{/info}}
52	52
53		-~=== 4. Compose Your Message ===
	55	+=== 4. Compose Your Message ===
54	54
55		-~*~*For emails:~*~*
	57	+**For emails:**
56	56
57		-~* (Optional) Pick an existing template from the dropdown to pre-fill the subject and body.
58		-~* Enter a subject line.
59		-~* Edit the body in the rich text editor. You can use bold, italics, lists, links, and images the same way you would when emailing from a member profile.
60		-~* Use personalization tokens to customize each message:
61		-~** ~*~*#FIRST NAME#~*~* — member's first name
62		-~** ~*~*#LAST NAME#~*~* — member's last name
63		-~** ~*~*#LOGIN#~*~* — member's portal login
	59	+* (Optional) Pick an existing template from the dropdown to pre-fill the subject and body.
	60	+* Enter a subject line.
	61	+* Edit the body in the rich text editor. You can use bold, italics, lists, links, and images the same way you would when emailing from a member profile.
	62	+* Use personalization tokens to customize each message:
	63	+** **#FIRST NAME#** — member's first name
	64	+** **#LAST NAME#** — member's last name
	65	+** **#LOGIN#** — member's portal login
64	64
65		-~*~*For texts:~*~*
	67	+**For texts:**
66	66
67		-~* Enter your message as plain text.
68		-~* A character counter shows you how long the message is. Stay under 160 characters for a single SMS segment — longer messages will be sent as multiple segments and may cost more.
69		-~* Personalization tokens (#FIRST NAME#, etc.) work in texts too.
	69	+* Enter your message as plain text.
	70	+* A character counter shows you how long the message is. Stay under 160 characters for a single SMS segment — longer messages will be sent as multiple segments and may cost more.
	71	+* Personalization tokens (#FIRST NAME#, etc.) work in texts too.
70	70
71		-~=== 5. Preview the Recipient Count ===
	73	+=== 5. Preview the Recipient Count ===
72	72
73	73	The dialog shows you how many members will actually receive the message after TCPA and reminders filtering is applied. This is your final send count — use it to sanity-check the audience size before you click Send.
74	74
75		-~=== 6. Send ===
	77	+=== 6. Send ===
76	76
77		-Click ~*~*Send~*~*. The message dispatches through MSI's normal email (SendGrid) and SMS (Mobiery) infrastructure. You'll see a confirmation when the send is complete, including the final recipient count.
	79	+Click **Send**. The message dispatches through MSI's normal email (SendGrid) and SMS (Mobiery) infrastructure. You'll see a confirmation when the send is complete, including the final recipient count.
78	78
79		-~-~-~-~-
	81	+----
80	80
81		-~== Frequently Asked Questions ==
	83	+== Frequently Asked Questions ==
82	82
83		-~*~*Why is my recipient count lower than my report results?~*~*~\~\
84		-The count shown before send is after TCPA and reminders filtering. Members without opt-in or with reminders set to Nothing (or to a channel that doesn't match what you're sending) are automatically excluded.
	85	+**Why is my recipient count lower than my report results?**
	86	+\\The count shown before send is after TCPA and reminders filtering. Members without opt-in or with reminders set to Nothing (or to a channel that doesn't match what you're sending) are automatically excluded.
85	85
86		-~*~*Can I save a draft and come back to it later?~*~*~\~\
87		-No. The compose dialog resets when you close it. Compose and send in one session.
	88	+**Can I save a draft and come back to it later?**
	89	+\\No. The compose dialog resets when you close it. Compose and send in one session.
88	88
89		-~*~*Where do bulk sends show up afterwards?~*~*~\~\
90		-Each send is logged to the system's message log with the recipient count, channel (email or SMS), and source = contract_report. They are not currently distinguished from member-tab messages in the standard message reports — that's a planned enhancement.
	91	+**Where do bulk sends show up afterwards?**
	92	+\\Each send is logged to the system's message log with the recipient count, channel (email or SMS), and source = contract_report. They are not currently distinguished from member-tab messages in the standard message reports — that's a planned enhancement.
91	91
92		-~*~*Can a member be messaged twice if they have multiple contracts?~*~*~\~\
93		-No. The system deduplicates by member ID before sending. If a member has 3 matching contracts, they receive 1 message.
	94	+**Can a member be messaged twice if they have multiple contracts?**
	95	+\\No. The system deduplicates by member ID before sending. If a member has 3 matching contracts, they receive 1 message.
94	94
95		-~*~*What happens if a member's phone number or email is invalid?~*~*~\~\
96		-Bad addresses fail per-recipient — the rest of the send continues normally. The send count returned reflects only successful dispatches.
	97	+**What happens if a member's phone number or email is invalid?**
	98	+\\Bad addresses fail per-recipient — the rest of the send continues normally. The send count returned reflects only successful dispatches.
97	97
98		-~*~*Can I use this on other reports?~*~*~\~\
99		-Not yet. The Contract Report is the first report wired up to bulk messaging. The backend supports any report; additional reports can be added as a future enhancement.
	100	+**Can I use this on other reports?**
	101	+\\Not yet. The Contract Report is the first report wired up to bulk messaging. The backend supports any report; additional reports can be added as a future enhancement.
100	100
101		-~*~*Why don't I see the buttons?~*~*
	103	+**Why don't I see the buttons?**
102	102
103		-~* You may be on the Summary view — switch to Detail.
104		-~* You may not have permission for messaging on this report — check with your account administrator.
105		-~* You may have switched views without re-running the query — re-run it on Detail.
	105	+* You may be on the Summary view — switch to Detail.
	106	+* You may not have permission for messaging on this report — check with your account administrator.
	107	+* You may have switched views without re-running the query — re-run it on Detail.
106	106
107		-~-~-~-~-
	109	+----
108	108
109		-~== What This Feature Does NOT Do (Yet) ==
	111	+== What This Feature Does NOT Do (Yet) ==
110	110
111	111	These items were in the original feature plan but are not in this release:
112	112
113		-~* ~*~*Pre-send breakdown by contract status~*~* — you don't currently see a breakdown by Active, Frozen, Cancelled, etc. before confirming.
114		-~* ~*~*Multi-contract transparency~*~* — no expandable list showing which members have multiple contracts.
115		-~* ~*~*Reporting differentiation~*~* — message reports don't currently separate contract-based sends from member-based sends.
	115	+* **Pre-send breakdown by contract status** — you don't currently see a breakdown by Active, Frozen, Cancelled, etc. before confirming.
	116	+* **Multi-contract transparency** — no expandable list showing which members have multiple contracts.
	117	+* **Reporting differentiation** — message reports don't currently separate contract-based sends from member-based sends.
116	116
117	117	If any of these are important to your workflow, please let your CSM know.
118	118
119		-~-~-~-~-
	121	+----
120	120
121		-~== Need Help? ==
	123	+== Need Help? ==
122	122
123		-If you run into trouble, contact MSI Support and reference ~*~*Member Manager Sprint 33 / Bulk Messaging from Contract Report~*~*.
	125	+If you run into trouble, contact MSI Support and reference **Member Manager Sprint 33 / Bulk Messaging from Contract Report**.