Forbind Gmail

Gmail-integrationen gør det muligt at hente nye mails ind i Deskova-indbakken og sende svar tilbage via den samme Gmail-konto. Brug en Google-konto, der ejer den mailbox, virksomheden vil bruge til kundeservice.

1. Opret eller vælg Google Cloud-projekt

1. Gå til Google Cloud Console.
2. Opret et projekt til Deskova eller vælg et eksisterende projekt.
3. Aktiver Gmail API under APIs & Services.
4. Konfigurer OAuth consent screen med app-navn, support-email og de domæner, der skal bruge integrationen.

2. Opret OAuth client

Opret en OAuth 2.0 Client ID af typen Web application.

Tilføj redirect-URL:

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

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

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

3. Scopes

Deskova anmoder om disse scopes:

• https://www.googleapis.com/auth/gmail.readonly
• https://www.googleapis.com/auth/gmail.send
• https://www.googleapis.com/auth/gmail.modify
• openid
• email
• profile

Scopes bruges til at læse indbakken, sende svar, markere mails som læst og hente den tilsluttede email-adresse. Tokens gemmes krypteret.

4. Miljøvariabler

Sæt disse miljøvariabler i produktion:

GOOGLE_OAUTH_CLIENT_ID
GOOGLE_OAUTH_CLIENT_SECRET

Hvis installationen bruger ældre navne, understøtter Deskova også GOOGLE_EMAIL_OAUTH_CLIENT_ID og GOOGLE_EMAIL_OAUTH_CLIENT_SECRET.

5. Forbind i Deskova

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

Troubleshooting

Redirect URI mismatch

Kontroller at URL'en i Google Cloud Console matcher miljøet præcist. Sti, domæne og protokol skal være identiske.

Refresh token mangler

Kør OAuth-flowet igen og kontroller, at consent screen er korrekt konfigureret. Deskova bruger access_type=offline og prompt=consent for at få refresh token.

Gmail API er ikke aktiveret

Hvis token exchange virker, men inbox-polling fejler, skal Gmail API være enabled for projektet i Google Cloud Console.