VDX SMS Gateway — Implementeringsguide¶

Denne guide er til tredjeparts-systemer, der skal sende SMS med mødelink og følge leveringsstatus via VDX SMS Gateway Service.

API'et er knyttet til et gyldigt booket VDX-møde (UUID i path) for at undgå misbrug. Adgang sker via OAuth2 access token fra VDX Keycloak med rollen meeting-admin eller meeting-user.

Bemærk: Denne guide dækker kun v2-endpoints (/sms/v2/...). Callback-endpointet (/sms/v1/callback) er til intern SMS-gateway og er ikke inkluderet.

Hvem er guiden til?¶

Eksterne udviklere og leverandører uden adgang til VDX-kodebasen
Teams der skal sende mødelinks via SMS fra booking- eller patientapps
Integrationer der allerede opretter møder via MedCom Video API og vil tilbyde SMS-invitation

Arkitektur — overblik¶

flowchart LR
    subgraph client [Din app]
        Backend[Backend]
    end
    Keycloak[VDX Keycloak]
    VideoAPI[MedCom Video API]
    SmsAPI[SMS Gateway v2]

    Backend -->|OAuth2 login| Keycloak
    Backend -->|POST /v2/meetings| VideoAPI
    VideoAPI -->|meeting uuid| Backend
    Backend -->|"POST /sms/v2/meeting/{uuid}"| SmsAPI
    Backend -->|"GET /sms/v2/meeting/{uuid}"| SmsAPI

Indholdsfortegnelse¶

Integrationsguide og support¶

Side	Beskrivelse
Integrationsguide	Kom i gang, autentificering, møde-UUID-krav, SMS-flow og best practices
Support	Kontakt, fejlrapportering og OpenAPI-kontrakt

API-reference¶

Sektion	Beskrivelse
Endpoints	Base URLs, headers, endpoint-detaljer og curl-eksempler
Modeller	Request/response-modeller (smsRequest, smsResponse, smsStatus)

Anbefalet læserækkefølge¶

Integrationsguide — start med Kom i gang og Autentificering
Send SMS-flow → POST /sms/v2/meeting/{uuid}
Modeller — beskedformat og %meeting_url%-placeholder
Leveringsstatus

Ændringshistorik¶

Dato	Ændring
2026-06-27	Første version af VDX SMS Gateway integrationsguide i mkdocs_webapp