CommCare Messaging allows you to group cases (contacts) to allow broadcast surveys or messages, similar to a mobile worker group.
When to Use a Case Group
Case groups are most useful in combination with Broadcast messages.
Often they can be used to communicate with cases in a specific region, or a subset of patients.
For example, a case manager wants to easily communicate with the 20 participant cases under their supervision.
For example, notify all participants in a study of a particular side effect or notify all HIV+ participants that a new service is available.
Creating a Case Group
- Go to Messaging > Case Groups
- Type in the name of your group (ex. Patients and click the "+ Create Group" button.
- Click on the Group Name link to edit the cases within the group.
There are two ways to add cases to the group.
- Manually With Identifier: Type in an identifier for the case (phone number, an external ID specified when creating case or the actual case ID). If specifying the phone number, you need to specify the full phone number (including country code with no spaces and no + symbol). Then click on the + Add Case button. If the case can't be found, an error will be displayed.
- Through Excel: Download the cases_bulk_example.xlsx file. In the file, type each case to add to the group as a separate row. You can use the phone number, external ID or actual case ID. If the case can't be found, an error will be displayed.
Note: To link back to the case data page, select the case name.
If you want to add cases to a case group in Bulk upload cases,
Select the link and download the cases.
Make the necessary change, and use the column header case_identifier. The case ID can be found in a case export or on the individual case_data page.
Upload the new list to add to the case group.
Editing a Case Group
Use the Manage Cases button to open the Case Group.
You can use the + Remove button to remove cases from the group and the + Add Case button to add additional cases.
You can can also using the Excel import functionality to bulk add phone numbers.
If you want to remove all cases from the group, its easiest to delete the group and create it again.