Forbind Microsoft 365

Microsoft 365-integrationen bruger Microsoft Graph til at hente Outlook-mails ind i Deskova og sende svar tilbage fra samme mailbox.

1. Opret App Registration

1. Gå til Azure Portal.
2. Åbn Microsoft Entra ID.
3. Vælg App registrations og opret en ny registration.
4. Brug multi-tenant, hvis flere Microsoft tenants skal kunne forbinde deres mailbox.
5. Opret en client secret under Certificates & secrets.

2. Redirect URL

Tilføj redirect-URL under Authentication:

https://deskova.ai/api/integrations/microsoft/callback

Til lokal test bruges den tilsvarende lokale URL, for eksempel:

http://localhost:3000/api/integrations/microsoft/callback

3. Graph scopes

Deskova anmoder om disse delegated scopes:

• Mail.Read
• Mail.Send
• offline_access
• openid
• email
• profile
• User.Read

Scopes bruges til at læse nye mails, sende svar, forny tokens og hente den tilsluttede email-adresse. Tokens gemmes krypteret.

4. Miljøvariabler

Sæt disse miljøvariabler i produktion:

MICROSOFT_OAUTH_CLIENT_ID
MICROSOFT_OAUTH_CLIENT_SECRET

Deskova bruger tenant common som standard. Hvis installationen skal låses til en tenant, kan MICROSOFT_EMAIL_OAUTH_TENANT_ID eller MICROSOFT_TENANT_ID sættes.

Ældre navne understøttes også:

MICROSOFT_EMAIL_OAUTH_CLIENT_ID
MICROSOFT_EMAIL_OAUTH_CLIENT_SECRET

5. Forbind i Deskova

1. Åbn Integrationer i Deskova.
2. Vælg Microsoft 365.
3. Klik Tilslut Microsoft 365.
4. Log ind med mailboxen, der skal håndtere kundemails.
5. Godkend Graph scopes og kontroller, at mailboxen vises som aktiv.
6. Send en testbesked fra integrationssiden.

Troubleshooting

Admin consent kræves

Nogle tenants kræver admin consent for Mail.Read eller Mail.Send. Kør consent-flowet som tenant-admin eller juster Entra-politikken.

Redirect URI mismatch

Kontroller at redirect-URL'en i App Registration matcher Deskova-URL'en præcist.

Mailbox-adresse mangler

Hvis Graph ikke returnerer mail, bruger Deskova userPrincipalName. Kontroller at brugeren har en aktiv Exchange Online-mailbox.