Skip to content
  • There are no suggestions because the search field is empty.

Setting up an Alert Server

Overview:

This article explains how to create an alert server in the Ditto Account Portal so Common Alerting Protocol (CAP) alerts can automatically display on your assigned Ditto receivers.

Note:

  • Alert servers are available on Ditto Premium and Elite plans.
  • Ditto only supports automated alerts integrated with a Common Alerting Protocol (CAP) server.
  • Ditto alerts take over the entire screen, even if digital signage is playing or someone is wirelessly mirroring to the display.

Before you begin

Determine whether your alert provider will use a Poll or Push configuration. This can usually be determined by either your alert provider needing a URL from Ditto (Push) or they provide their own URL to be used (Poll).

Create an alert server

  1. Log in to the Ditto Account Portal and click Alert Management in the left sidebar, then Alert Servers.
  2. Click New server.
  3. Enter a name for your alert server. This can be any name that helps you identify the CAP server in the Ditto Account Portal.
  4. Under Type, choose either Poll or Push. If you choose Push, Ditto will generate a secure push URL for your CAP server after you finish creating the alert server.
  5. If you chose Poll, enter the Server URL for your CAP alert server. The Request Type in the Ditto Account Portal will be set to GET by default.
  6. If you chose Poll and your alert provider requires authentication, switch on Requires authentication, then enter the Username and Password fields as well.
  7. Use the remaining fields to choose which CAP alerts will be displayed on your assigned room receivers. To see the filter menus, switch off Receive all alerts.
  8. In the Where card, click Add rooms & locations and select the Room(s) and/or Location(s) that should receive alerts from this server. Selecting a Location will send alerts to the Ditto receivers assigned to that Location, similar to how Ditto alerts can be sent to all receivers within a selected Location. If a room is already part of a selected location, it will only be alerted once. All sublocations of a selected location will also receive alerts from this server.
  9. Click Create server.
  10. If you created a Push server, Ditto will now provide the generated push URL. It appears under Inbound push URL on the new server's page. Click Copy.
  11. Copy that URL into your alert provider’s configuration to complete the integration. Your alert provider should use POST when sending alerts to Ditto.

Configure alert preferences

These settings let you control the alert content Ditto will subscribe to and display, such as:

  • Default expiration
  • Statuses
  • Severities
  • Urgencies
  • Certainties
  • Event types

Ditto’s alerting experience is designed to let admins choose the severity of alerts and send them to the rooms or locations that are impacted.

Important:
The Default expiration setting determines how long Ditto will display a CAP alert when the alert itself does not include an expiration time. If the CAP server sends a cancelled alert, Ditto will dismiss it immediately regardless of the Default expiration setting.

Test the Alert Server

After your alert server has been created, it is a good idea to send a few test alerts from your alert provider to make sure everything is working as expected.

  1. In the Ditto Account Portal, click Alert Management in the left sidebar, then Alert Servers, and click your alert server.
  2. Review the Recent Alerts section to confirm Ditto is receiving and processing alerts from your CAP server. This section can help you quickly verify details such as the alert type, category, severity, sender, sent time and status.
  3. Click the info button in the Details column of an alert to open the Emergency Alert Details view. This page is useful for confirming the full alert information Ditto received, including the identifier, sender, title, severity, urgency, certainty, created time, expiration time and whether the alert is currently active.

Additional information

Ditto supports both manual/custom alerts and automated CAP-based alerts. CAP integrations are intended to help organizations get messages out faster to their Ditto-enabled displays.