Available from CRM.COM R9.0.0
This method returns information related with an alert. A single alert is returned by each call
Resource URL
Parameters
Name | Type | Description | |||||||||
token | String | The token retrieved from the login method | |||||||||
| alert_identifier (mandatory) | Alert Identifier | The identifier of the alert that should be returned as a result. The allowed alert Identifier fields are the following:
| |||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
|---|---|---|
id | String | The ID of the retrieved alert |
number | String | The number of the retrieved alert |
| life_cycle_state | String | The life cycle state of the retrieved alert which can be SUCCESSFUL or REJECTED |
| type | String | The type of the retrieved alert which can be EMAIL or SMS |
| entity | String | The name of the entity that was communicated through the alert. The supported entities are the following:
|
| entity_id | String | The ID of the entity that was communicated through the alert |
| subject | String | The subject of the retrieved alert. This is applicable only if the type is EMAIL |
| content | String | The content of the retrieved alert |
| recipient_email_address | String | The email address of the recipient. This is applicable only if the type is EMAIL |
| recipient_phone_number | Number | The phone number of the recipient. This is applicable only if the type is SMS |
| error_code | String | The code of the error that occurred while sending the alert. This is applicable only for rejected alerts |
| error_description | String | The description of the error that occurred while sending the alert. This is applicable only for rejected alerts |
| recipient | User Object | The recipient user of the retrieved alert |
| alert_definition | Alert Definition Object | The alert definition that was used to send the alert |
| workflow_rule | Workflow Rule Object | The workflow rule that triggered the alert |
| log_information | Log Information Object | The log information of the retrieved alert |
Referred Objects Response Data
Examples
HTTP Method: GET
Request:
Response:
{
"status":
{
"message": "",
"description": "",
"code": "OK"
},
"data":
{
"entity": "ACTIVITIES",
"number": "7",
"recipient_email_address": "m_ioannou@crm.com",
"subject": "Test Alert ACT000366 ",
"log_information":
{
"updated_date": "2015-11-03T16:44:32",
"created_date": "2015-11-03T16:44:21",
"created_by_unit":
{
"community_name": "Internal Community",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"group_name": "Main Group",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"updated_by_unit":
{
"community_name": "Internal Community",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"group_name": "Main Group",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": "sakkascy1986@hotmail.com"
},
"updated_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": "sakkascy1986@hotmail.com"
}
},
"life_cycle_state": "SUCCESSFUL",
"alert_definition":
{
"life_cycle_state": "EFFECTIVE",
"type": "EMAIL",
"id": "26D38E26DE6647529FDCCBFD0F2F7C48",
"name": "Send Alert To created By User",
"alternative_code": "CREATED_BY_USER"
},
"entity_id": "78F2C4952DF14A38B7F789393AC84EDC",
"content": " Mr Ioannou132 Marios your activity with number ACT000366 was created
with sub location
with job location
with lead ",
"recipient":
{
"person_name": "m_ioannou",
"username": "m_ioannou",
"id": "C5D6D95C71C4484F9168A5444FC928EF",
"email": "m_ioannou@crm.com"
},
"type": "EMAIL",
"id": "D5C9543925F54A9199D1F451AB03B909",
"workflow_rule":
{
"life_cycle_state": "EFFECTIVE",
"id": "5DB96A77C25B4D19A65C4515D4E0D394",
"name": "Workflow Rule Activity On Update",
"alternative_code": "Upd_Act"
}
}
}