Send Message
This operation is used to send different type of messages to users in the application.
Current Implementation
The supported type of messages are email and alert.
In order to be able to use this operation, a user must have 'send_messages' permission.
The current implementation delegates the actual message sending to Action Agent. This is an asynchronous operation. The current implementation will not wait until Action Agent comes back before returning to the client. The implication of this is that if Action Agent fails in delivering the message, the client of this operation is not notified.
Parameters
Base URL: /communication/send
Parameters:
| Name | Type | Mandatory | Description |
|---|---|---|---|
| token | String | Yes | Security Token obtained before. |
| userId | String | Yes | The id of the logged in user. |
| type | ENUM | No | Possible values: ['email', 'alert']. Default value: "email". This parameter identifies the type of message that must be sent. |
| senderId | String | If type == 'email' -> No If type == 'alert' -> Yes | Id of the user used as sender. For messages of type 'email', this parameter is not mandatory. In this case, the sender is set as the receiver. |
| receiverId | String | Yes | Id of the user that must receive the message. |
| templateId | String | Yes | Id of the template that should be used for the message. |
| ... | String | No | All the parameters (all the previously listed and any other parameter used in the invocation of this operation) are used as variables for the selected template. The template then could have, for example, the following variables: {userId}, {type}, {username}, {doctor}, etc. |
API Sample
Happy Scenario
Not enough Permissions
In the case poda doesn't have 'send_messages' permission, the operation returns a 403 (Forbidden) error with the body "Not enough permissions.".
0 Comments