Webhook notifications for Visma Cloud Services Status

[#1]

One of the most high-demand feature requests, webhook notification system is now available at https://status.visma.com

With this feature, Visma Cloud Services Status page can send notifications via webhooks when there are incidents & scheduled maintenance or status update on a component status. Webhooks contain information about the Product / Component / Status these changed.

We would highly appreciate your feedback about this feature, so please feel free to inform us after implementing this.

How to enable webhook notifications ?

After navigating to the https://status.visma.com , please follow the steps shown below respectively.

Immediately afterwards, you'll receive an email from "noreply@statuspage.visma.com" that is informing you about Webhook subscription confirmation.

If Status.Visma is unable to communicate with your Http listener domain, it will be sending you another email as a warning.

For further information please see the following articles. 

• What is a component?
• Enable webhook notifications (JSON Schema)

[Trygve Storrønningen1]

This is very welcome 🙂

I did not get to test it yest, just want to add one important issue just in case it is not covered.

All responses should contain current version of Visma.net ERP Financials.

Status warnings on updates should contain current version, new version and planned date of new version

Is this already in place?

[Yıldırım]

Implementation is covering entire components these are available at Visma Cloud Services Status page.
Please have a look at the following articles to get information in details about  component status changes / update types and json response body.

• What is a component?
• Enable webhook notifications (JSON Schema)

In the case of maintenance notification, following fields will give you information about the schedule.

"scheduled_for":null,
"scheduled_until":null,

There is no standard field for version information since the maintenance window may vary depending on its component and type. (Technical maintenance/patch / version release / etc.) 

We'll inform notification providers to include "Current  & Release version" information in the notification body text.

...
"incident_updates":[
{
"body":  "string"
...
}

[AliMKhan]

@Trygve Storrønningen1 

Thank you for your feedback. We will add current version(8.25.49.1020 ), next version (8.26.x) and the time when the maintenance will be completed in the message. Stay tuned.

[AliMKhan]

Was anyone able to try this out?
Feedback?

[Thomas Skjørten]

I logged all the webhook-messages that was sent during the upgrade to 8.26. In total 8 notifications was sent:

21:31 - Incident update - Scheduled maintenance for Visma.net ERP 

22.30 - Component update - Visma.net ERP API - Under maintenance 

22.30 - Component update - Visma.net ERP - Under maintenance 

22.30 - Incident update - Visma.net ERP API - Maintenance in progress 

22.55 - Incident update - Visma.net ERP API - Still under maintenance 

01.35 - Component update - Visma.net ERP - Operational 

01.35 - Component update - Visma.net ERP API - Operational 

01.35 - Incident update - Visma.net ERP - Completed 

An example of the Incident update:

{
  "meta": {
    "unsubscribe": "http://status.visma.com/?unsubscribe=9j1hhlv61p90",
    "documentation": "https://help.statuspage.io/knowledge_base/topics/webhook-notifications",
    "generated_at": "2020-11-09T20:31:24.480Z"
  },
  "page": {
    "id": "zvpknzcr6znl",
    "status_indicator": "none",
    "status_description": "All Systems Operational"
  },
  "incident": {
    "name": "Scheduled maintenance for Visma.net ERP",
    "status": "scheduled",
    "created_at": "2020-11-06T16:49:26.024+01:00",
    "updated_at": "2020-11-09T21:30:30.935+01:00",
    "monitoring_at": null,
    "resolved_at": null,
    "impact": "maintenance",
    "shortlink": "https://stspg.io/dvqy02dtggw5",
    "scheduled_for": "2020-11-09T22:30:00.000+01:00",
    "scheduled_until": "2020-11-10T05:30:00.000+01:00",
    "scheduled_remind_prior": true,
    "scheduled_reminded_at": "2020-11-09T21:30:30.935+01:00",
    "impact_override": null,
    "scheduled_auto_in_progress": true,
    "scheduled_auto_completed": true,
    "metadata": {},
    "started_at": "2020-11-06T16:49:26.016+01:00",
    "id": "67kvyh0xn9xh",
    "page_id": "zvpknzcr6znl",
    "incident_updates": [
      {
        "status": "scheduled",
        "body": "Maintenance will begin as scheduled in 60 minutes.",
        "created_at": "2020-11-09T21:30:30.246+01:00",
        "wants_twitter_update": false,
        "twitter_updated_at": null,
        "updated_at": "2020-11-09T21:30:30.246+01:00",
        "display_at": "2020-11-09T21:30:30.246+01:00",
        "deliver_notifications": true,
        "tweet_id": null,
        "id": "bd4ppzq438c6",
        "incident_id": "67kvyh0xn9xh",
        "custom_tweet": null,
        "affected_components": null
      },
      {
        "status": "scheduled",
        "body": "We will be undergoing scheduled maintenance from Monday, November 9th, 22:30 CEST until Tuesday, November 10th, 05:30 CEST. The version 8.25.49.1020 will be upgraded to 8.26.08.1036.",
        "created_at": "2020-11-06T16:49:26.074+01:00",
        "wants_twitter_update": false,
        "twitter_updated_at": null,
        "updated_at": "2020-11-06T16:49:26.074+01:00",
        "display_at": "2020-11-06T16:49:26.074+01:00",
        "deliver_notifications": true,
        "tweet_id": null,
        "id": "30tpfrxjcn11",
        "incident_id": "67kvyh0xn9xh",
        "custom_tweet": null,
        "affected_components": [
          {
            "code": "3hbtn55fszt8",
            "name": "Visma.net ERP - Visma.net ERP",
            "old_status": "operational",
            "new_status": "operational"
          },
          {
            "code": "k6jrxjnvv3zt",
            "name": "Visma.net ERP - Visma.net ERP API",
            "old_status": "operational",
            "new_status": "operational"
          }
        ]
      }
    ],
    "postmortem_body": null,
    "postmortem_body_last_updated_at": null,
    "postmortem_ignored": false,
    "postmortem_published_at": null,
    "postmortem_notified_subscribers": false,
    "postmortem_notified_twitter": false,
    "components": [
      {
        "status": "operational",
        "name": "Visma.net ERP",
        "created_at": "2017-01-23T12:03:34.891+01:00",
        "updated_at": "2020-11-06T15:54:27.262+01:00",
        "position": 1,
        "description": null,
        "showcase": false,
        "start_date": null,
        "id": "3hbtn55fszt8",
        "page_id": "zvpknzcr6znl",
        "group_id": "m8vwr4m9rzx6"
      },
      {
        "status": "operational",
        "name": "Visma.net ERP API",
        "created_at": "2017-01-31T10:23:50.403+01:00",
        "updated_at": "2020-11-02T12:53:13.580+01:00",
        "position": 4,
        "description": null,
        "showcase": false,
        "start_date": null,
        "id": "k6jrxjnvv3zt",
        "page_id": "zvpknzcr6znl",
        "group_id": "m8vwr4m9rzx6"
      }
    ]
  }
}

An example of a Component Update:

{
  "meta": {
    "unsubscribe": "http://status.visma.com/?unsubscribe=9j1hhlv61p90",
    "documentation": "https://help.statuspage.io/knowledge_base/topics/webhook-notifications",
    "generated_at": "2020-11-09T21:30:34.358Z"
  },
  "page": {
    "id": "zvpknzcr6znl",
    "status_indicator": "maintenance",
    "status_description": "Service Under Maintenance"
  },
  "component": {
    "status": "under_maintenance",
    "name": "Visma.net ERP API",
    "created_at": "2017-01-31T09:23:50.403Z",
    "updated_at": "2020-11-09T21:30:33.575Z",
    "position": 4,
    "description": null,
    "showcase": false,
    "start_date": null,
    "id": "k6jrxjnvv3zt",
    "page_id": "zvpknzcr6znl",
    "group_id": "m8vwr4m9rzx6"
  },
  "component_update": {
    "old_status": "operational",
    "new_status": "under_maintenance",
    "created_at": "2020-11-09T21:30:33.583Z",
    "component_type": "Component",
    "state": "sn_created",
    "id": "ndtfcmbh649y",
    "component_id": "k6jrxjnvv3zt"
  }
}