Events

Information about event types produced by Dialogporten

Introduction

This contains reference information and examples of events produced by Dialogporten using Altinn Events.

For a functional overview, see getting started with events.

For step-by-step information on how to use Altinn Events with Dialogporten, see the user guides for detecting changes.

Event types

Type	Description
`dialogporten.dialog.created.v1`	A new dialog has been created.
`dialogporten.dialog.updated.v1`	An existing dialog has been updated.
`dialogporten.dialog.deleted.v1`	A dialog has been deleted.
`dialogporten.dialog.restored.v1`	A dialog has been restored.
`dialogporten.dialog.seen.v1`	A dialog has been seen (opened) by an end-user.
`dialogporten.dialog.transmission.created.v1`	A transmission has been created.

The above events are produced directly by Dialogporten. In addition, there are events emitted whenever the service owner updates the activity log.

Type	Description
`dialogporten.dialog.activity.created.v1`	A “dialog created” activity has been added.
`dialogporten.dialog.activity.closed.v1`	A “dialog closed” activity has been added.
`dialogporten.dialog.activity.information.v1`	Informational activity related to a dialog has been recorded.
`dialogporten.dialog.activity.transmission-opened.v1`	A transmission related to a dialog has been marked as opened.
`dialogporten.dialog.activity.payment-made.v1`	A payment activity within a dialog has been completed.
`dialogporten.dialog.activity.signature-provided.v1`	A signature has been provided for a dialog.
`dialogporten.dialog.activity.dialog-opened.v1`	A dialog has been marked as opened.
`dialogporten.dialog.activity.dialog-deleted.v1`	A dialog has been marked as deleted.
`dialogporten.dialog.activity.dialog-restored.v1`	A dialog has been restored.
`dialogporten.dialog.activity.sent-to-signing.v1`	A dialog has been sent to signing.
`dialogporten.dialog.activity.sent-to-form-fill.v1`	A dialog has been sent to form fill.
`dialogporten.dialog.activity.sent-to-send-in.v1`	A dialog has been sent to send in.
`dialogporten.dialog.activity.sent-to-payment.v1`	A dialog has been sent to payment.
`dialogporten.dialog.activity.form-submitted.v1`	A form associated with the dialog has been submitted.
`dialogporten.dialog.activity.form-saved.v1`	A form associated with the dialog has been saved.

Event format

As with all Altinn Events, the Cloud Events format forms the base of the events emitted by Dialogporten. Here is some examples of events:

Example 1 - dialog created

{
    "specversion": "1.0",

    // Unique event id
    "id": "91f2388f-bd8c-4647-8684-fd9f68af5b15",
    
    // See tables above for possible types
    "type": "dialogporten.dialog.created.v1",
    
    // Timestamp for when the event occured in Dialogporten
    "time": "2025-02-19T08:00:06.4014168Z",
    
    // urn:altinn:resource:{serviceResource}
    "resource": "urn:altinn:resource:super-simple-service", 
    
    // Dialog-ID
    "resourceinstance": "f4e6df3c-7434-44c3-875e-8dca1cdf0b20",
    
    // Party
    "subject": "urn:altinn:organization:identifier-no::991825827",

    // URL to activity in Dialogporten
    "source": "https://platform.altinn.no/dialogporten/api/v1/enduser/dialogs/f4e6df3c-7434-44c3-875e-8dca1cdf0b20",
    
    // These are additional fields, if present in the dialog (all are optional).
    "data": { 
        "process": "urn:some:process:id",
        "precedingProcess": "urn:some:preceding:process:id"
    }
}

Example 2 - dialog activity added

{
    "specversion": "1.0",

    // Unique event id
    "id": "91f2388f-bd8c-4647-8684-fd9f68af5b15",
    
    // See tables above for possible types
    "type": "dialogporten.dialog.activity.signature-provided.v1",
    
    // Timestamp for when the event occured in Dialogporten
    "time": "2025-02-20T13:04:02.6518542Z",
    
    // urn:altinn:resource:{serviceResource}
    "resource": "urn:altinn:resource:super-simple-service", 
    
    // Dialog-ID
    "resourceinstance": "f4e6df3c-7434-44c3-875e-8dca1cdf0b20",
    
    // Party
    "subject": "urn:altinn:organization:identifier-no::991825827",

    // URL to activity in Dialogporten
    "source": "https://platform.altinn.no/dialogporten.no/api/v1/enduser/dialogs/f4e6df3c-7434-44c3-875e-8dca1cdf0b20/activities/21241c7e-819f-462b-b8a4-d5d32352311a",
    
    // These are additional fields, if present. Only the activityId entry is always present for events
    // within the dialogporten.dialog.activity-namespace of events. All other fields are optional.
    "data": { 
        "activityId": "21241c7e-819f-462b-b8a4-d5d32352311a",
        "extendedActivityType": "additional-info-received",
        "process": "urn:some:process:id",
        "precedingProcess": "urn:some:preceding:process:id"
    }
}