Event Notifications Settings

Enable Event Notifications

Settings

Common Questions

Kiosk Pro allows you to set up email notifications for specific events within the app using your own email servers.

For security reasons, we recommend setting up a separate email account to send these alerts rather than using your primary email address. This does have to be a valid, working email address, but you can set up a single email account and use it for multiple iPads. Since the email subject line always includes the Unique iPad ID from Kiosk Pro settings (if it is set), you can differentiate which kiosk is having an issue in that way without setting up multiple email addresses.


Power Supply Change

This toggle allows you to receive email notifications when the power status changes.

Default: Off

Email on Power Supply Change can be a useful tool for notification if the iPad loses external power due to a system-wide power outage, a blown breaker, a pulled plug or theft. This feature will also send a notification when external power is restored.

This setting can only be used in conjunction with the SMTP Server Settings which must be set up for email to be sent.


Battery Level Change

This setting allows you to receive email notifications when the battery level changes. You can control when you want to receive an email notification by setting different zones.

  • Normal Zone - ranges from 100% to the percentage you set for the Low %.
  • Low Zone - ranges from the Low % to the percentage you set for the Critical %.
  • Critical Zone - ranges from the Critical % to 0%.

You can choose whether to receive an email notification when the battery level enters a zone, either from Discharging or Charging, by enabling the appropriate toggle switches.

You can create two zones instead of three by setting only one of the percentages. The Normal Zone will then range from 100% to whichever percentage you set, and the Low/Critical Zone will be from the percentage you set to 0%. In this case, Kiosk Pro will use the email toggles in the zone with the set percentage.

You can also choose to receive an email notification for each zone when the iPad is charging or when the iPad is unplugged.

This setting can only be used in conjunction with the SMTP Server Settings which must be set up for email to be sent.


Remote Update of Settings

This toggle allows you to receive email notifications when the settings are successfully updated remotely via XML file.

Default: Off

Email on Remote Update of Settings can allow you to confirm that settings were updated correctly when immediate access to the physical kiosk is not available.

This setting can only be used in conjunction with the SMTP Server Settings which must be set up for email to be sent.


Remote Update of Local Files

This toggle allows you to receive email notifications when the kiosk successfully downloads and unzips new local content.

Default: Off

Email on Remote Update of Local Files allows the user to confirm when remote update of local files occurs successfully. The email generated will be tagged with the Unique ID of the kiosk sending and includes a list on the files that have been added to the kiosk.

This setting can only be used in conjunction with the SMTP Server Settings which must be set up for email to be sent.


Motion Detection

This toggle allows you to receive email notifications when the iPad's accelerometer detects the iPad has been moved.

Default: Off

The email generated will be tagged with the Unique ID of the kiosk sending the notification and the local timestamp of the iPad itself.


Switch between Cellular Data & WiFi

Added in version 7.6

This toggle allows you to receive email notifications when the iPad switches between using cellular data and WiFi, making it easier to avoid expensive data plan overages. 

Default: Off

The email generated will be tagged with the Unique ID of the kiosk sending the notification, the local timestamp of the iPad itself, and the name of the network the iPad is currently connected to.

Notifications are not sent for WiFi-only devices or devices with cellular data disabled - as these emails are generated by the app itself, there is no way to trigger an email while the device is offline and the notification would only be possible to send when the issue had been already been resolved with the device being reconnected to the Internet.  If you need a notification of offline status, we recommend looking at our  Remote Management Server subscription, which can trigger notifications based on missed heartbeats from the app. 


Send Event Notifications Through

Event notifications can be sent using your own email servers or Zapier, a service which connects many popular web apps, including Gmail, Twitter, and Slack.

Options:

  • SMTP Email Server (default)
  • Zapier Webhook

SMTP Email Server Settings

These settings allow Kiosk Pro to connect to your SMTP server to send email alerts on your behalf. We recommend setting up an email address specifically for this purpose, rather than using your primary email account.

From Email

This must be a valid and properly formatted email address capable of generating new email via SMTP.

This email will be the account referenced in all of the SMTP settings (excluding To Email) and will appear as the email account the notification is sent from.

Example: ipad@example.com

To Email

This must be a valid and properly formatted email address. This is the account that will receive the notification emails.

This setting only supports a single email address. If you want to send alerts to multiple addresses, you'll need to set up automatic forwarding from the email address used here to the other email addresses.

Example: tech@example.com

SMTP Server

This setting refers to an IP or web address assigned by the email host/provider.

Example: smtpout.secureserver.net

SMTP Ports

This setting allows you to control which SMTP ports are used to communicate. You should not change this setting from the default, which is '25; 465; 587', unless it is necessary. When Kiosk Pro tries to send a message, it attempts to send through the first port listed (by default, port 25). If for some reason, the initial port is not open, it tries to send through the next port from list and so on.  

Requires Authentication

This toggles the authenticity requirement. By default, this is set to On. If your mail server does not require a username and password to send mail, you may switch this to OFF.

Username

This setting refers to the account sending the email. This information is given by your email host/provider.

Example: The Username for ipad@example.com is ipad.

Password

This setting refers to the password of the account sending the email.

Enable SSL

This setting provides an extra layer of security while sending your email. By default this option is set to Off.


Test

The test button allows you to send a test email to check and see if your settings are correct and the app is able to successfully send email on your behalf. If there is a problem, we attempt to return information that may be helpful in troubleshooting as follows:

Code Description Suggestion
-5 Timeout sending message. Sending email requires a connection to the Internet - please check your Internet connection. If you are connected to the Internet and are still seeing this error, your email server may be down - please try sending your message again later.
-4 The connection to the server was interrupted. Sending email requires a connection to the Internet - please check your Internet connection. If you are connected to the Internet and are still seeing this error, your email server may be down - please try sending your message again later.
-3 Unable to connect to the server. Sending email requires a connection to the Internet - please check your Internet connection. If you are connected to the Internet and are still seeing this error, your email server may be down or there could be an issue with your server's security certificates - please try sending your message again later.
-2 Unsupported login mechanism. Your server's security setup is not supported, please contact your system administrator or use a supported email account like MobileMe.
1 Error resolving host. Check your SMTP Host name
530 Relay rejected. Your server probably requires a username and password.
535 Invalid username or password. Go to Email Preferences in the application and re-enter your username and password.
550 To address rejected. Please re-enter the To: address.
555 General error that returns "Failed to send email." This is a non-specific error returned by the SMTP server. If this is returned, you may want to do additional testing of your SMTP configuration using  https://www.smtper.net (free) or using the SMTP Tester app ($1.99 on the App Store). You might also get in touch with the team running your SMTP server to see if they have any other specific suggestions.

The above errors are generated by the SMTP library we use to send email. While much more rare, an error can also be generated directly by the iOS operating system (NSOSStatusErrorDomain) - this means that you may see other errors without descriptions or suggestions provided.


Zapier Webhook URL

To create a Zapier Webhook URL, you’ll need to sign up with Zapier.

Zapier offers a free plan that will work for event notifications for small deployments with up to 5 zaps and 100 events per month. For larger deployments or ones that need access to filtering or premium apps, they offer paid plans starting at $20/month. More information is available on their pricing page.

Once you’ve created an account with Zapier, open your dashboard and click ‘Make a Zap!’ to open a new Zap editor. From there:

  1. Click into the search bar and type ‘webhook’, then select ‘Webhooks by Zapier’ from the filtered results.
  2. Click ‘Catch Hook’ and then ‘Save + Continue’.
  3. Leave the ‘Pick off a Child Key’ field empty and click ‘Continue’.
  4. Copy the webhook shown.

Now that you have a webhook URL, you need to trigger it from within Kiosk Pro to verify that it’s working. To do this:

  1. Open Kiosk Pro’s settings and enter the new webhook URL in the Zapier Webhook URL setting.
  2. Turn on Enable Event Notifications > Power Supply Change.
  3. Set Send Event Notifications Through > Zapier Webhook.
  4. Run the kiosk presentation.
  5. Connect and/or disconnect the iPad from a power source to trigger the event notification.
  6. Return to your Zapier editor and click "Okay, I did this" to trigger a check for successful webhook connection.
  7. Once the webhook is verified, you can set up an action to be triggered in another app when an event notification is sent.

Still stuck? How can we help? How can we help?