| MESSAGING_CONVERSATION_MANAGE | MESSAGING Endpoint | |
| /rpc/messaging/?method=MESSAGING_CONVERSATION_MANAGE | ||
| Object: 50. Click here for more information. | ||
| Add or remove a conversation eg blogs, wikis etc. |
| PARAMETERS | TYPE | NOTES | |
| DataReturn | Text | A comma delimited list of advanced search fields to be returned after a successful save | |
| Id | Numeric | ||
| Remove | Numeric | Pass '1' to remove the item | |
| AlertEmailComment | Text (2000) | Used for building a formatted email when a user adds a comment. See AlertEmailMessage for more details. | |
| AlertEmailFrom | Text (100) | If not set, messaging@mydigitalstructure.cloud is used as default. | |
| AlertEmailMessage | Text (4000) |
A default message is sent out to all participants (where EmailAlert = Y). However, if you want more control over the contents of the email that is sent, you can build your own HTML template. Note: If the post is a comment, and AlertEmailComment is not set, then it uses this template is used for it. You can use either '.' or '_' as delimeters in the tags. The available tags are: [[CONVERSATION.POST.COMMENT.CREATEDUSERTEXT]] [[CONVERSATION.POST.COMMENT.ID]] [[CONVERSATION.POST.COMMENT.GUID]] [[CONVERSATION.POST.COMMENT.MESSAGE]] |
|
| AlertEmailSubject | Text (500) | As per AlertEmailMessage, you can control the subject of the email alert that is sent out. Then available tags are: [[CONVERSATION.TITLE]] [[CONVERSATION.POST.CREATEDUSERTEXT]] [[CONVERSATION.POST.SUBJECT]] [[CONVERSATION.POST.COMMENT.CREATEDUSERTEXT]] |
|
| AlertUrl | Text (200) | a default URL to access the message is built. However, as per other fields above, you can have more control. The available tags are: [[CONVERSATION.ID]] [[CONVERSATION.POST.ID]] [[CONVERSATION.POST.COMMENT.ID]] [[URL]] (The caller's URL e.g. http://mydsondemand.com) |
|
| AllowSMSAlerts | Text (1) | Y / N [default]. Can participants request a SMS when an update is made. | |
| EmailAlertDefault | Text (1) | Y / N [default]. Should the participants default to receiving an email with each comment. | |
| Favourite | Text (1) | Y / N [default]. Use in searches to show favourite conversations. | |
| IncludeMessageInEmailAlert | Text (1) | Y / N [default]. In the default alert, should the message be included. | |
| Notes | Text (2000) | ||
| Object | Numeric | See CORE_OBJECT_SEARCH. | |
| ObjectContext | Numeric | ||
| ParticipantCan | Numeric | 1=Add Posts & Comments [default], 2=Add Comments Only, 3=View Only, 4=Add Posts Only. Note: The owner can always Post | |
| ParticipantsCanManageParticipants | Text (1) | Y / N [default]. By default, only the owner can add and remove participants. | |
| Sharing | Numeric | 1=Added Participants & User Roles [default], 2=Everyone (Public), 3=Internal | |
| Status | Numeric | 1=Open [default], 2=Closed | |
| Title | Text (50) | If blank, it will default to current date, time. |
| RETURN | ||
| id | Numeric | |
| status | ADDED, REMOVED |
| EXAMPLES | |
| 1 | jQuery /jscripts/1blankspace.messaging.conversation.001.js |