Subscribing to notifications

You can configure Pexip Control Center to send email notifications each time an endpoint goes offline or comes back online. You do this by setting up a subscription that includes the email addresses the notifications will be sent to, and then adding one or more endpoints to the subscription.

Notification emails are sent from no-reply@pexip.me.

Notification events

Currently, a notification will be sent each time:

  • a video system has a successful SIP registration (status changes to "online")

  • a video system becomes unregistered (status changes to "offline")

One email is sent per endpoint event. If a number of endpoints in the same subscription go offline or come back online at the same time (for example, during a power outage), an email will be sent for each endpoint.

Notification limits

To protect against spam, there are limits to the number of notifications sent per subscription in a given time period:

  • 15 per minute
  • 100 per hour
  • 500 per day
  • 1500 per week
  • 4500 per thirty days

Any further notifications will be discarded.

Creating subscriptions

To set up notifications:

  1. From the menu on the left of PCC, select Settings > Notifications.

    The Notifications screen appears, showing a list of all existing subscriptions:

  2. From the right of the screen, select + Add subscription.

  3. The Subscription screen appears:

    1. Enter a descriptive Subscription name.
    2. Enter the email address that you want notifications sent to. To add more than one email address, select + Add recipient.

    3. Select Create.

  4. From the Notifications page, find the subscription you just created. From the menu to the right select Add/Edit video system(s):

  5. In the Video system field, search for and select the endpoint(s) you want to add and select Save:

Viewing and editing subscriptions

To view the details of a particular subscription, or to change the recipients or video systems associated with it, from the menu on the left, select Settings > Notifications. This takes you to the Notifications page where you see a list of all subscriptions.

Viewing associated video systems

To view all the video systems associated with each subscription, select the subscription. This expands it to show the list of video systems for which notifications will be sent. To hide the list, click on the notification again to collapse it.

Adding a video system to a subscription

Administrators can add multiple video system to an existing subscription in either of the following ways:

  • From the Notifications page (Settings > Notifications), search for the subscription and from the menu to the right select Add/Edit video system(s). Search for and select the video systems to add.

  • From the Video Systems page, search for the video system(s) to add, and check the box to the right of each of the video system names. A Bulk actions button appears at the top of the list — select this and then select Add to notification subscription:

Administrators can add an individual video system to an existing subscription as follows:

  • From the Video Systems page, search for and select the video system to add. Scroll down to the Notifications section and Expand it. You'll see any existing subscriptions for this video system. To add it to a subscription, select + Subscribe to.

End users can add their video endpoint to an existing subscription as follows:

  • Go to My account > Account settings and View the video system. Scroll down to the Notifications section and Expand it. You'll see any existing subscriptions for this video system. To add it to a subscription, select + Subscribe to.

Removing a video system from a subscription

Administrators can remove a video system from an existing subscription in either of the following ways:

  • From the Notifications page (Settings > Notifications), find and expand the subscription. You see all the video systems for that subscription. From the menu to the right of the video system to remove, select Remove from subscription.
  • From the Video Systems page, select the video system. Scroll down to the Notifications section and Expand it. You'll see the existing subscriptions for this video system. From the menu to the right of the subscription, select Remove from subscription.

End users can also remove their own video systems from a subscription:

  • Go to My account > Account settings and View the video system. Scroll down to the Notifications section and Expand it. You'll see the existing subscriptions for this video system. From the menu to the right of the subscription, select Remove from subscription.

Adding and removing email recipients

To view the list of current email recipients, from the menu to the right of the subscription select Edit subscription. The Subscription panel appears.

  • To add another email recipient, select + Add recipient and enter the email address.

  • To remove an email recipient, from the menu to the right of the email address select Delete.

    Email recipients can also unsubscibe themselves from the notification emails.

Deleting a subscription

To delete a subscription, from the menu to the right of the subscription select Delete subscription.

Unsubscribing from notifications

Individual email recipients can stop receiving notifications for a particular subscription by clicking on the "Click here to unsubscribe" link at the bottom of every email that is sent. This will remove their email address from the list of recipients in PCC for that subscription. Note that they will continue to receive notifications for any other subscriptions for which they are a recipient.

Alternatively, an administrator can remove the email recipient's address from the subscription.