Send Message to Devices
This request sends a message to one or more devices using email, SMS or push notification (e.g., APNS).
Ivanti EPMM validates that the request has valid devices, and then sends the response. Ivanti EPMM sends the messages to the devices after sending the response. You can view the results of sending the messages by looking at Logs & Events | All Logs in the Admin Portal.
If some devices are invalid, the response lists them, but Ivanti EPMM will still send the message to the valid devices.
Examples:
Send an SMS to two devices based on UDID.
https://app027.auto.Ivanti.com/api/v1/dm/bulk/sendmessage?mode=sms&message=Hello World&deviceUuid=e6d4f5f0-d883-41d2-8e87-c76fb4ef4cde&deviceUuid=54bc5eb5-592c-472e-98d2-e859bd037fef
The resulting response:
<deviceManagementWebServiceResponse>
<messages/>
<message> Message sent successfully for all devices.</message>
</deviceManagementWebServiceResponse>
Send an SMS to a device based on Wi-Fi MAC address:
https://app027.auto.Ivanti.com/api/v1/dm/bulk/mac/sendmessage?mode=sms&message=Hello World&deviceWiFiMacAddress=00237696635F
1.URI: https:///api/v1/dm/bulk/sendmessage | |
|---|---|
Http Method: | POST |
Format: | xml, json |
Request: | |
deviceUuid | Required. List each device uuid as a query parameter that has the name deviceUuid. By default, the maximum number of device uuids you can list is 20,000. You can configure this value by setting the variable bulk.api.maxdeviceuuids in the file mifs.properties. This file is located in the directory /mi/tomcat-properties in the Linux system in which Ivanti EPMM is running. Warning: The name of this parameter is deviceUuid, with no “s” at the end. |
message | Required. |
subject | Valid only when the mode is email. |
mode | Required. Possible values: sms pns (indicates push notification service) |
| |
2.URI: https:///api/v1/dm/bulk/mac/sendmessage | |
Http Method: | POST |
Format: | xml, json |
Request: | |
deviceWiFiMacAddress | Required. List each Wi-Fi MAC address as a query parameter that has the name macAddress. |
message | Required. |
subject | Valid only when the mode is email. |
mode | Required. Possible values: sms pns |
| |
Response Status Code: | |
‘404 – No Data Found’ | There is no data. |
‘200 – OK’ | Data is present and the response is returned. |
Response: | |
< deviceManagementWebServiceResponse > | |
<messages> | |
<message>Message sent successfully for all devices.</message> | Status information. |
</messages> | |
<invalidDevices> | If the request contains one or more invalid device uuids, this field lists them. |
<uuid> 1ac8bd81-4ab9-4e3e-b3a8-0c4f70521d23</uuid> | |
<uuid> 623094f9-645b-4ecf-8840-78597cc1254b</uuid> | |
</invalidDevices> | |
</messageSentFailed> | Indicates the message was not sent for at least one specified device, due to, for example, an invalid device uuid. |
< /deviceManagementWebServiceResponse> | |
|
|---|