Using mHero

Sending Messages

Introduction

With mHero,sending messages requires creating a workflow from an Interactive Messaging Application like Rapidpro and this workflow will then be accessible in iHRIS or any Human Resource Health Information System (HRHIS) which is CSD compliant for sending to a health worker. This article will be based on iHRIS as an example of a Human Resource Health Information System which is compliant to CSD and Rapidpro as an example of an Interactive Messaging Application. There are two ways for starting a workflow through iHRIS,one is called Bulk Workflows (starting a workflow to multiple participants) and the other one is individual workflow (starting a workflow to one participant).

Starting A Workflow in iHRIS

1. Starting a workflow through Bulk Workflows
   To send a workflow to multiple participants follow these steps:
   • click the home button and then click mHero link which is located at the bottom like in the picture below
     
   • A window will open that has a section to start Bulk Workflows,select any report under Bulk Workflows section and then click the Select Participants button to load all health workers.
     
   • At the bottom of the report there are filters which can be used to filter health workers to be sent a workflow. Select a workflow that should be started (located at the very bottom) and then click the Start Flow button
     
2. Starting a workflow through individual workflow
   This is done by accessing a health worker's profile. These are the steps to start a workflow to an individual participant.
   
   • Click on the Search Records link which is located at the left hand panel,then click the Search People link. Use filters to search for a specific health worker and then click the name of the health worker to open the profile.
   
   
   • Under the health Worker profile,click the mHero logo which is located at the top right corner.
   
   
   • Select a workflow to be started to this health worker and then click the Start Workflow button.

Workflow Results Pulling And Results Reporting

Introduction

When a workflow is started in iHRIS,all the SMS communication exchange between a Health Worker and Rapidpro are stored inside Rapidpro.These SMSs needs to be pulled into iHRIS for reporting.

Pulling Workflows Results From Rapidpro

The following steps outlines how Workflows results can be pulled from Rapidpro to iHRIS:

1. Click the Home button and then click the mHero link located at the bottom of the home page
2. under the Generate Workflows Results section,select a workflow to generate its results or select the All Workflows option to generate results of all workflows for all health workers involved
3. Click the Generate Results button to start the process

mHero Reports in iHRIS

By the time this article was created there were three mHero reports as listed below:

1. Workflow Response Data
2. Workflow Overview Report
3. Health Worker Initial Response Report

These reports belongs to the mHero Reports section which can be accessed by clicking the View Reports link.

Workflow Response Data

This report shows a series of messages that was sent to health workers (grouped in a workflow) and responses of those messages by health workers. Below is a sample of a Workflow Response Data Report;

1. First Name: Is the initial name of the health worker.
2. Last Name: Is the surname of the health worker.
3. Middle Name: Are other names of a health worker.
4. Session Number: Is a unique number that is given to a group of health worker participated in a single workflow start. This is number is generated everytime a workflow is started and it is assigned to everyone that was involved in that particular workflow. The session number is useful in a situation where one workflow have been started multiple times in a single day,you can filter by session number to obtain health workers who were involved in each different run of the same workflow. The session is in the format YYYY-MM-DD-XX,where YYYY is the year,MM is the Month,DD is the day for which the workflow was started and XX is the unique number which is generated every time a workflow is run.
5. Workflow Name: Is the name of the workflow that was started to a health worker.
6. Message Sent On: Is the date and time for which a particular message was sent to a health worker.
7. Message Arrived On: Is the date and time for which a particular message was delivered to a health worker.
8. Message Text: Is the text message that was sent or received to/from a health worker.
9. Message Type: This can be 'Request' or 'Response',Request is the message that was sent to a health and Response is the message that was received from a health worker.
10. Flow Start Date: This is the date for which a workflow was started to a health worker.
11. Flow Start Time: This is the time for which a workflow was started to a health worker.
12. Flow Completed: This shows whether or not a health worker responded to all messages of a workflow. It is Yes if a workflow was complete and No if a workflow was not complete.
13. Step Number: Every Message and expected Response that is created in Rapidpro,it is called a step and is given a unique number called step number. Have a look at the picture below
    

Related Pages

MHero Installation and Configuration