Configure the hosted gateway for cloud services

Use this gateway to set up devices using the AtHoc or OEM Cloud Delivery Service. After configuring this gateway, you can set up telephony (TAS), email (OPM), and SMS.

  1. In the navigation bar, click The Settings icon.
  2. In the Devices section, click to open one of the following gateways, based on information supplied by your BlackBerry AtHoc services representative:
    • AtHoc Cloud Delivery Service (East)
    • AtHoc Cloud Delivery Service (West)
    • OEM Cloud Delivery Service (East)
    • OEM Cloud Delivery Service (West)
  3. Click Copy default settings at the top of the screen.

    The default templates for the services appear in the SMS and Email template fields.

  4. Enter the user name and password values provided to you by BlackBerry AtHoc customer support.
  5. Optionally, for TAS, you can enter a Caller ID (ANI) value to override the default value for the account.

    The value should be a valid phone number or extension that is 4-16 numeric characters.

  6. For the SMS (texting) template, replace the existing template, with the following template:

    SMS template

  7. Optionally, modify the SMS XML template fields for your organization by adding placeholders.

    The following table describes the parameters that you can add to either the SMS or the Email template. The placeholders values are preset:

    Placeholder

    Required

    Purpose and Values

    [MessageBody]

    Yes

    The contents of the SMS message (the alert text.)

    [MessageTitle]

    Yes

    The title of the SMS message.

    [PublishedAt]

    No

    The time when the alert is published.

    [PublishedBy]

    No

    The operator account name that sends the alert.

    [RecipientName]

    No

    The name of recipients the alert is sent to.

    [ResponseOptions]

    No

    The response options provided for the recipient of the text message. If empty, the Response Option instruction line does not appear in the alert. The default is Reply:, but can be customized text like “Select a response.”

    [SelfServiceUrl]

    No

    Link to the user’s Self Service screen.

    [Severity]

    No

    The value of the Severity field for the alert.

    [SystemName]

    No

    The name of the current organization.

    [TargetUrl]

    No

    The URL in the optional "More Info Link" field, provided for more information.

    [Type]

    No

    The category of the alert, such as Safety.

    [OrganizationName]

    No

    The organization name that is displayed in the BlackBerry AtHoc title pane.

  8. Optionally, if you use the hosted email service, you can configure a custom "From" address in the From Display Name field. The From Display Name must include a valid email address in angle brackets. For example, XYZ Alerts<Alerts@xyz.com>.
    Note: The From Display Name email domain must be registered with the AtHoc Cloud Delivery system before use. Using an invalid email address will prevent emails from being delivered.

After setting up the Cloud Delivery Services Gateway, you can configure the related devices from the Devices screen.