Skip to main content

Portal URL Documentation

This document describes public portal URLs that can be opened directly in a web browser.
They are intended for easy integration into third-party software, such as buttons, links, notifications, or external systems that need to open specific sections of the portal.

Base URL:
https://portal.ng-sos.com

Incident Overview​

Opens the overview of active incidents.

URL

/incident-list

Description

  • Opens the incident overview page
  • No url or query parameters

Example

Create Incident (Pre-filled Form)​

Opens the incident creation form with predefined values.

URL

/create-incident

Query Parameters​

NameTypeRequiredDescription
RequestedIncidentIdUUIDYesID of the new incident
PhoneNumberstringYesCaller phone number

Example​

Typical Use Cases

  • Creating an incident from an external system
  • Deep-linking from a telephony or CRM system

Open Incident​

Opens a specific incident.

URL

/open-incident

Query Parameters​

NameTypeRequiredDescription
idUUIDYesIncident identifier

Example​

Typical Use Cases

  • Opening an incident from notifications
  • Direct links from third-party applications

Notes

  • This is the supported way to link to an incident. Which page the portal opens is an internal detail and may change; this URL is kept working across such changes.
  • An unknown or malformed id shows the portal's page not found screen.

Incident Archive​

Opens the incident archive with filtering options.

URL

/incident-archive

Query Parameters​

NameTypeRequiredDescription
FromISO 8601 datetimeNoStart date and time
ToISO 8601 datetimeNoEnd date and time
PhoneNumberstringNoCaller phone number
CallerNamestringNoCaller name

Example​

Typical Use Cases

  • Reviewing incident history
  • Audit and reporting purposes

Integration Notes​

  • All URLs are intended to be opened in a web browser
  • Query parameters must be URL-encoded
  • Authentication and authorization are handled by the portal itself