Forutsetninger
Før du starter, sørg for at du har følgende tilganger og verktøy:
- Azure Administrator-tilgangDu trenger administrator-tilgang til Azure Active Directory
- Microsoft Teams AdministratorTilgang til Microsoft Teams admin center for app-installasjon
- Preppio Enterprise-kontoEn aktiv Preppio Enterprise-konto med integrasjonstillatelser
Opprett App Registration i Microsoft Azure
Registrer en ny applikasjon i Azure Active Directory
- 1Logg inn på Azure Portal (portal.azure.com)
- 2Naviger til 'Azure Active Directory' > 'App registrations'
- 3Klikk på 'New registration'
- 4Velg 'Accounts in any organizational directory (Any Azure AD directory - Multitenant)'
- 5Noter Application (client) ID og Directory (tenant) ID
Generer Secret Key
Opprett en sikker nøkkel for autentisering
- 1I Azure Portal, gå til din app registration
- 2Naviger til 'Certificates & secrets'
- 3Klikk på 'New client secret'
- 4Sett gyldighetstid og beskrivelse
- 5Kopier verdien umiddelbart - den vises kun én gang
Tildel API-tillatelser
Gi applikasjonen nødvendige Microsoft Graph-tillatelser
- 1Gå til 'API permissions' i din app registration
- 2Klikk på 'Add a permission'
- 3Velg 'Microsoft Graph' > 'Application permissions'
- 4Legg til nødvendige tillatelser for Teams og brukerdata
- 5Gi admin consent for tillatelsene
Sett opp Azure Bot Service
Opprett og konfigurer Azure Bot Service
- 1I Azure Portal, søk etter 'Bot Services'
- 2Klikk på 'Create' for å opprette en ny bot
- 3Koble boten til din tidligere opprettede app registration
- 4Sett messaging endpoint til: https://preppapp.com/api/messages
- 5Aktiver Microsoft Teams-kanalen
Konfigurer Preppio Applikasjon
Sett opp integrasjonen i Preppio-dashbordet
- 1Logg inn på Preppio-dashbordet
- 2Gå til 'Integrations' > 'Microsoft Teams'
- 3Opprett en ny bot eller integrer med eksisterende
- 4Spesifiser bot-navn, beskrivelse og ikoner
- 5Legg inn Application Client ID, Directory Tenant ID og Secret Key
Last ned og installer App Package
Distribuer bot-appen til Microsoft Teams
- 1Last ned app-pakken fra Preppio
- 2Gå til Microsoft Teams admin center
- 3Naviger til 'Teams apps' > 'Manage apps'
- 4Last opp app-pakken (.zip-fil)
- 5Noter App ID fra den installerte appen
Fullfør integrasjonen
Aktiver boten i ønskede Teams-grupper
- 1Gå tilbake til Preppio-dashbordet
- 2Legg inn App ID i integrasjonsinnstillingene
- 3Legg til boten i ønskede Microsoft Teams-grupper
- 4Test integrasjonen ved å sende en testmelding
- 5Konfigurer automatiseringsregler og arbeidsflyter
Viktige merknader
- Secret Key vises kun én gang i Azure Portal. Sørg for å kopiere og lagre den sikkert.
- Admin consent er påkrevd for API-tillatelser. Kontakt din Azure-administrator hvis nødvendig.
- Test integrasjonen grundig i et test-miljø før produksjonsdistribusjon.
Feilsøking
Boten svarer ikke i Teams
Sjekk at messaging endpoint er riktig konfigurert og at Azure Bot Service er aktiv.
Autentiseringsfeil
Verifiser at Application ID, Tenant ID og Secret Key er riktig konfigurert i Preppio.
Kan ikke installere app i Teams
Sørg for at du har Teams-administratortilgang og at organisasjonens app-policyer tillater custom apps.
Neste steg
Etter vellykket integrasjon kan du:
- Konfigurere automatiske onboarding-arbeidsflyter
- Sette opp proaktive påminnelser og oppfølging
- Integrere med andre HR-systemer og verktøy