New documentation available re: Muting

Hallo, we are happy to announce that high level functional documentation on muting is now available on the documentation site. Muting is a feature that temporarily silences tasks and SMS schedules for a person or a household. This feature is commonly used when a person or household has temporarily relocated or refused services.

A number of projects have already deployed this feature and we hope that this additional documentation would help inform the community how the muting feature functions.

Feel free to suggest any additional information that may be missing.

6 Likes

We would love to learn more about how Muting is being used. What scenarios does your project use the muting functionality for?

1 Like

Hi @michael
In the Jamii ni Afya project, it’s typical for a pregnant woman to leave her residence and go to her parents’ home to give birth. When the mother and newborn are ready to return home, the CHV mutes both profiles in the app, indicating that they are returning home after delivery.

2 Likes

Hello @michael
In Living Goods we also have scenarios where a supervisor might temporarily need to mute a CHW area. This might happen if the CHW is not able to attend to the area either due to e.g., a personal emergency, spoilt/lost device etc.

PS. In this scenario, once a CHW is muted, all households (HHDs) that they cover are also muted. But we had an issue reported around this:

  • Currently when unmuting this CHW, this didn’t cascade to the CHW’s households on the CHW’s end. And they had to manually unmute all these HHDs
  • How do we separate originally muted households (pre-muting of the CHW). That is; households that the CHW had already muted by themselves. So that if the unmuting cascades, these HHDs still remain muted?

So we have explored workarounds for this. Does CHT natively support this?

2 Likes

Currently when unmuting this CHW, this didn’t cascade to the CHW’s households on the CHW’s end. And they had to manually unmute all these HHDs

From CHT 3.2.0, both muting and unmuting should automatically cascade to children contacts in the hierarchy. However, before CHT 3.12.0 the muted contacts would only be displayed as muted in the UI for offline users after they had synced to the server. After 3.12.0, when an offline user mutes a contact, the UI will immediately show the contact as muted (even if the user has not synced yet). (And all of this also applies to the UI changes expected when unmuting a contact.)

How do we separate originally muted households (pre-muting of the CHW). That is; households that the CHW had already muted by themselves. So that if the unmuting cascades, these HHDs still remain muted?

Unfortunately, I do not think this is currently supported by the CHT. I have logged a new issue to track this feature request. Please have a look and feel free to respond with any additional details/clarification/suggestions (either here or directly on the issue).

2 Likes

Hi @Kymoraa … can you tell us a little more about why the supervisor mutes the CHW area? I understand that the CHW is not able to attend to their area, but I’m curious the main reasons you need to mute the CHW’s area during this period. Is this more about how the CHW’s tasks get handled, the Supervisor’s tasks, or perhaps other things related to analytics, payments, etc…?