Post a Message Micro-app
Finding messages sent by users
Overview
The Post a Message Micro-app is a generic micro-app that allows employees to post messages to authorities deemed appropriate by management.
The micro-app is configured to create cloud communication messages on a configured channel. In order to allow regular employees to submit messages the channel should be made public for reading and only the appropriate groups should be marked as able to subscribe to it.
The employee composing the message will receive a copy of the idea as a cloud comm card and will be able to see the interactions, comments/answers, that occur for that idea.
Configuring the Post a Message Micro-app
- First, assign the ONE Cloud Communication Post a Message micro-app to the role the users a customer wants to communicate will be assigned to.\
- Configure the channel a customer wishes employees to use for communication
- See section about configuring channels
- Configure the micro-app instance so it sends to the appropriate channel.
- The title given to the application instance will be the title that is displayed when running the application.
- See section about available configuration options.
Available configuration options
Configuration options are set in the application instance configuration form.
|
Configuration option name |
Expected |
Description |
|
TargetChannelName |
String |
The name of the channel the micro app should use when sending out the question. |
|
TargetGroupIds |
Guids separated by comma if more than one. |
The id (Guid) of the group or groups you want the application to target when sending the question. These are not mandatory. |
|
SendPushNotification |
True or False |
Indicates if a push notification should be sent to the targets of the message when it is sent. |
|
SummaryTruncationLength |
Integer |
Indicates how many characters of the question should be used to create the summary card of the message. |
|
BannerImageUrl |
url |
Indicates a url to a custom banner image you want to use in the app instead of the default provided one. |
|
PostTextLabel |
String |
The label showed on top of the post message and title fields. |
|
ShowTitle |
True or False |
When set to True the user is asked to enter a title for his message. If set to False then the title will not be asked. It will be created by truncating the post message at 150 characters. |
|
TitleWatermark |
String |
The watermark text showed in the title field. |
|
PostActionLabel |
String |
The label showed for the action button that will be used to send the message. |
|
PostTextWatermark |
String |
The watermark text showed in the post message field. |
|
MarkAsImportant |
True or False |
When set to true the user messages will be set as important. |
|
SendCardToAuthor |
True or False |
When set to true the author of the message will also receive the card. |
|
ShowPictureUpload |
True or False |
When set to false the picture upload isn’t available in the micro-app. |
|
PictureUploadLabel |
String |
The label showed on the picture chooser |
|
SuccessLabel |
String |
The message showed when the submit was succesful |
|
SuccessLabelTitle |
String |
The title showed for the success message |
|
ErrorLabel |
String |
The message showed when the submit was not succesful |
|
ErrorLabelTitle |
String |
The title showed for the error message |
|
ShowMultiPictureUpload (Optional) |
True or False (Default: False) |
If is set to "true" the user can upload multiple images for that post instead of just a single. |
|
ShowSocial (Optional) |
True or False (Default: False) |
Provides the user options to disable like and comments. |
|
ShowContact (Optional) |
True or False (Default: False) |
Provides the user options to provide contact details like name, e-mail and phone. |
|
ShowMentions (Optional) |
True or False (Default: False) |
If is set to "true" the user can select others to mention them in the post. |
|
TargetChannelName (Optional) |
|
Name of channel targeted is a required channel |
Localizable configuration elements
Some configuration elements are localizable. This means a user can specify a different text for depending on the current language of the user. To localize the text of one of the options, add .[language code] at the end of the parameter name. Always keep a version without localization as this will serve as default and add the same parameter with the extra language code for other languages.
Example: TextFormat = default, TextFormat.fr = French.
Configuring channels for employee communication
Channels are configured in the Portal > Cloud Comm > Channels form.
Define a channel where all employees can write to and only certain groups can actually subscribe to receive the communications from those employees.
Figure 1 - Configuring a public write / private read channel
In the above image you can see that we configured a public channel called Cloud Comm Questions. For that channel only users in the Cloud Comm Managers group will be allowed to subscribe and therefore receive messages targeted to the Cloud Comm Questions channel.
Note: Channels are subscription base so if users do not subscribe they will not receive the messages. To force all users in the configured group to get the message you can make the channel mandatory in which case all users in the configured group will always receive all the messages.
Cloud communication card
When a user submits an emergency with the micro-app a cloud communication message is sent to the channel. Users subscribed to that channel will get the message and will be able to interact with the author of the question by commenting and liking. The author will also have received that card so he will also be able to interact. The emergency micro-app automatically sends out push notification also.
Micro-app
Finding messages sent by users
To find all messages that have been submitted by your users go to the Portal > Cloud Comm > Messages form. The messages form offers filters that will allow you to find all messages sent on the channel you configured to receive the messages.
Figure 2 - The messages form filtering on a channel
Comments
0 comments
Article is closed for comments.