Manage app notifications

•
Environment: cloud
• 3 minutes to read
 • 3 minutes to read

Applications should ensure they don't attempt to connect to a particular tenant when the tenant is unavailable. SuperOffice offers both a pull and a push approach to get tenant status.

SuperOffice will also send you emails when there is a problem with your application. By default, these emails go to the technical contact of the application. However, you can also specify a list of addresses for error reporting.

Watch the walk-through on YouTube:

Tenant status

The State change URL is set in the advanced application configuration of each application.

  1. In the Developer Portal, go to your app page.

    To see the list of all apps:

    • Select Apps from the top menu, or
    • Go to your partner overview page.

  1. Select Configuration.

  2. Turn on Advanced.

  3. Select Notifications.

    Configure notifications -screenshot

  4. Enter the URL of your endpoint SuperOffice should push notifications to when a tenant changes status.

    https://www.awesomeapp.com/NotifyCustomerStateChange

    Optionally, turn on Configure per Environment to set different URLs for SOD, Stage, and Production.

    Configure notifications per environment -screenshot

  5. Select On/Off to activate the endpoint (turn on data traffic).

  6. Click Save Settings or OK.

  7. Request to publish the new configuration.

Note

You must set up a web service listening at the given URL and be prepared to parse notifications.

ERP sync, quote, and mirroring

For each endpoint you have configured SuperOffice to send data to, you can also subscribe to error emails.

To turn on/off error emails to the technical contact for an endpoint, update the advanced configuration of the application.

To receive error emails at different or more than one email addresses, update the application settings:

  1. On the app page, select Settings from the left menu or click the Edit button.

  2. Scroll to the bottom and enter one or more addresses in the Error reporting emails field.

    Application settings, error reporting emails -screenshot

    The addresses must be separated with a semicolon ( ; ), no spaces.

  3. Click Save Settings.

Note

You can update the email addresses in the application settings at any time. Technical contact will receive any notification mail if this field is blank.

Other errors

For other errors, such as when a customer reports a problem from the App Store, the technical contact will be notified if error reporting emails field is empty.

Read more