Microsoft Teams-meldingen configureren

AI/BI-dashboards ondersteunen het verzenden van geplande momentopnamen naar Microsoft Teams-kanalen. Hierdoor kunnen teams dashboardupdates rechtstreeks in hun Teams-werkruimte ontvangen. Op deze pagina wordt uitgelegd hoe u een Microsoft Teams-app maakt en een Teams-kanaal configureert als een meldingsbestemming. Dashboardeditors kunnen deze meldingsbestemming vervolgens als abonnee toevoegen aan geplande dashboards. Zie Een Slack- of Microsoft Teams-kanaal abonneren voor informatie over het toevoegen van een Teams-kanaal als abonnee.

Teams-abonnementen bieden dashboardoverzichten met:

• Een PNG-snapshot van het dashboard dat direct in het kanaal zichtbaar is
• Een directe koppeling om het dashboard te openen in Azure Databricks
• Een PDF-momentopnamebijlage in de berichtenthread

Requirements

U moet over de volgende machtigingen beschikken:

• U moet een Azure Databricks-werkruimtebeheerder zijn om meldingsbestemmingen te configureren.
• Je moet de juiste rechten hebben om apps te registreren en beheerderstoestemming te geven in Microsoft Entra ID. Je moet ook een Azure Bot-resource kunnen aanmaken in de Azure Portal, een Teams-app toevoegen en Power Automate-workflows in Microsoft Teams kunnen maken.

Tijdens het installatieproces verzamelt u verificatiereferenties van Microsoft om de Azure Databricks-meldingsbestemming te configureren.

Nadat u de meldingsbestemming hebt geconfigureerd, kan elke gebruiker met CAN EDIT-machtigingen op een dashboard de Teams-bestemming als abonnee toevoegen aan de planningen die ze beheren.

Stap 1: Een Microsoft Teams-app maken en configureren

Registreer een Microsoft Entra ID-app, maak een Azure-bot die aan die app gekoppeld is, en voeg een Teams-app voor de bot toe aan je kanaal.

Registreer een Microsoft Entra ID-app

1. Ga naar het Microsoft Entra-beheercentrum.
2. Klik op Applications > App-registraties > Nieuwe registratie.
3. Voer een naam in voor de app en klik op Registreren.
4. Kopieer op de overzichtspagina van de app de toepassings-id (client). Je hebt deze waarde nodig om de Azure Bot te maken en de Azure Databricks notificatiebestemming te configureren.

App-machtigingen configureren in Microsoft Entra-id

1. In het Microsoft Entra-beheercentrum, met je appregistratie geselecteerd, klik je op API-rechten in de linker zijbalk.
2. Klik op Een machtiging toevoegen.
3. Klik in Microsoft API's op Microsoft Graph-toepassingsmachtigingen>.
4. Voeg de volgende machtigingen toe:
   • Files.Read.All
   • Sites.ReadWrite.All
5. Klik op Machtigingen toevoegen.
6. Klik op Beheerderstoestemming verlenen om de machtigingen voor uw organisatie te verlenen.

Een verificatiegeheim maken

1. In het Microsoft Entra-beheercentrum, met je app-registratie geselecteerd, klik je op Certificaten & geheimen.
2. Klik op Clientgeheimen > Nieuw clientgeheim.
3. Voer een beschrijving in en selecteer een verloopperiode.
4. Klik op Toevoegen.
5. Kopieer de waarde van het zojuist gemaakte geheim. Deze waarde wordt slechts eenmaal weergegeven en u hebt deze nodig om de doelmelding van Azure Databricks te configureren.

De tenant-id ophalen

1. Ga in het Microsoft Entra-beheercentrum, terwijl uw app-registratie is geselecteerd, naar Overzicht.
2. Kopieer de directory-ID (tenant). U hebt deze waarde nodig om het doel van de Azure Databricks-melding te configureren.

Maak een Azure Bot voor de app aan

Maak een Azure Bot-resource aan die gebruikmaakt van de Microsoft Entra ID-app die je hebt geregistreerd.

1. Ga naar het Azure Portal en klik op Create a resource.
2. Zoek naar Azure Bot, selecteer de Azure Bot-kaart en klik op Aanmaken.
3. Selecteer onder Microsoft App ID'Gebruik bestaande appregistratie' en voer het applicatie-ID (client) in van de app die je hebt geregistreerd.
4. Vul de resterende vereiste velden in en klik dan op Beoordelen + aanmaken > Aanmaken.
5. Wanneer de uitrol is voltooid, klik je op Ga naar bron.

Verbind de bot met Microsoft Teams

Voeg het Microsoft Teams-kanaal toe aan de bot, maak vervolgens een Teams-app voor de bot en voeg die toe aan je kanaal. Voor de volledige procedure, zie Verbind een bot met Microsoft Teams in de Azure Bot Service documentatie.

1. Open in de Azure Bot-bron Instellingen > Kanalen en klik op Microsoft Teams.
2. Ga akkoord met de servicevoorwaarden. Selecteer op het tabblad Berichten de cloudomgeving van je bot en klik vervolgens op Toepassen.
3. Maak een Teams-app aan voor de bot, pak deze in en upload deze naar Microsoft Teams. Voor instructies, zie Publiceer je bot in Teams.
4. Voeg de Teams-app toe aan het kanaal waar je dashboardmeldingen wilt ontvangen.

De URL van het Teams-kanaal ophalen

1. Navigeer in Microsoft Teams naar het doelkanaal.
2. Klik op het hamburgermenu ••• naast de kanaalnaam.
3. Klik op Koppeling kopiëren. Zorg ervoor dat u de kanaal-URL kopieert en niet de Teams-URL. U hebt deze URL nodig om het doel van de Azure Databricks-melding te configureren.

Een binnenkomende webhook voor het kanaal maken

1. Volg de stappen van Microsoft om een binnenkomende webhook te maken met Workflows for Microsoft Teams, door de Stuur webhook-alerts naar een kanaaltemplate te gebruiken en het bestemmingskanaal te selecteren.
2. Kopieer en sla de gegenereerde webhook-URL op. U hebt deze URL nodig om het doel van de Azure Databricks-melding te configureren.

Stap 2: De meldingsbestemming configureren in Azure Databricks

Maak een meldingsbestemming in uw Azure Databricks-werkruimte die verwijst naar uw Microsoft Teams-kanaal.

1. Meld u aan bij uw Azure Databricks-werkruimte.

2. Klik op uw gebruikersnaam in de rechterbovenhoek van de werkruimte.

3. Selecteer Instellingen in de vervolgkeuzelijst.

4. Klik in de sectie Werkruimtebeheerder op het tabblad Meldingen .

5. Klik op Beheren in de sectie Meldingsbestemmingen .

6. Klik op Bestemming toevoegen.

7. Selecteer Microsoft Teams in de vervolgkeuzelijst van het doeltype.

8. Voer de volgende gegevens in:

   • Naam: Een beschrijvende naam voor deze Teams-kanaalbestemming
   • Webhook-URL van Microsoft Teams: de webhook-URL van de binnenkomende Teams-webhook
   • App ID: De applicatie (client) ID uit je Microsoft Entra ID app-registratie
   • Verificatiegeheim: de waarde van het clientgeheim van Microsoft Entra-id
   • Kanaal-URL: de kanaal-URL van Microsoft Teams
   • Tenant ID: De directory (tenant) ID van Microsoft Entra ID

9. Klik op Create.

Gebruikers kunnen deze Teams-meldingsbestemming nu toevoegen als abonnee aan dashboardplanningen.

Zie Een Slack- of Microsoft Teams-kanaal abonneren voor instructies over het abonneren op Teams-kanalen voor dashboardplanningen.

Probleemoplossingsproces

Gebruik de volgende stappen om veelvoorkomende fouten met Microsoft Teams-meldingen op te lossen.

Ontbrekende PDF-bijlage

Als de Teams-melding wordt weergegeven zonder een PDF-bijlage, controleert u of:

• De applicatie (client) ID is correct geconfigureerd in de notificatiebestemming
• Het verificatiegeheim is geldig en is niet verlopen
• De app heeft de vereiste Files.Read.All machtigingen en Sites.ReadWrite.All machtigingen gekregen in Microsoft Entra ID
• Beheerderstoestemming is verleend voor de API-machtigingen

Melding wordt niet weergegeven

Als meldingen niet worden weergegeven in uw Teams-kanaal:

• Controleer of de URL van de webhook juist is en overeenkomt met het doelkanaal
• Controleer of het authenticatiegeheim de clientgeheimwaarde van Microsoft Entra ID gebruikt en niet de geheime ID.
• Controleer of de Teams-app voor de bot is toegevoegd aan het bestemmingskanaal
• Zorg ervoor dat de kanaal-URL juist is
• Controleer of de tenant-id overeenkomt met uw Microsoft-organisatie
• Controleer of de planning actief is en niet is onderbroken

Volgende stappen

• Abonneer Teams-kanalen op dashboardplanningen. Een Slack- of Microsoft Teams-kanaal abonneren
• Configureer Slack-meldingsbestemmingen. Zie Slack-meldingen configureren
• Configureer e-mailmeldingsbestemmingen. Zie Meldingsbestemmingen beheren