Microsoft Teams

Bekijk op Github

Microsoft 365 Teams is een collaboratief communicatieplatform dat chat, videoconferenties en bestandsdeling combineert, en een gecentraliseerde hub biedt voor teams om naadloos samen te werken. Het stelt organisaties in staat om efficiënt te verbinden, samen te werken en te communiceren, zowel op afstand als op kantoor.

Voordat je begint

Voordat je verbinding kunt maken, moet je ervoor zorgen dat je een Microsoft 365-account hebt.

Webhooks en acties gebruiken voor kanaalberichten

Als je webhooks en/of acties voor kanaalberichten wilt gebruiken, heb je goedkeuring van de beheerder van je organisatie nodig. Er zijn twee manieren om beheerderstoestemming te verlenen.

De eerste manier is om organisatiebrede beheerderstoestemming te verlenen aan de Blackbird-applicatie:

• Meld je aan bij het Microsoft Entra-beheercentrum als globale beheerder, beheerder voor bevoorrechte rollen of gebruiker met de machtiging om toestemmingen aan applicaties te verlenen.
• Ga naar Identity > Applications > Enterprise applications > All applications.
• Voer Blackbird in het zoekvak in en selecteer vervolgens de Blackbird-applicatie uit de zoekresultaten.
• Ga naar Security > Permissions.
• Klik op Grant admin consent for Blackbird.io International LLC.

De tweede manier is om de beheerderstoestemmingsworkflow te configureren:

• Meld je aan bij het Microsoft Entra-beheercentrum als globale beheerder.
• Ga naar Identity > Applications > Enterprise applications > Consent and permissions > Admin consent settings.
• Onder Admin consent requests, selecteer Yes voor Users can request admin consent to apps they are unable to consent to.
• Configureer de volgende instellingen:
  • Who can review admin consent requests - selecteer gebruikers, groepen of rollen die zijn aangewezen als beoordelaars voor beheerderstoestemmingsverzoeken. Beoordelaars kunnen beheerderstoestemmingsverzoeken bekijken, blokkeren of weigeren, maar alleen globale beheerders kunnen beheerderstoestemmingsverzoeken goedkeuren. Om verzoeken goed te keuren, moet een beoordelaar beschikken over de vereiste machtigingen om beheerderstoestemming te verlenen voor de aangevraagde applicatie. Mensen die als beoordelaars zijn aangewezen, kunnen inkomende verzoeken bekijken in het tabblad My Pending nadat ze als beoordelaars zijn ingesteld. Nieuwe beoordelaars kunnen niet handelen op bestaande of verlopen beheerderstoestemmingsverzoeken.
  • Selected users will receive email notifications for requests - e-mailmeldingen aan de beoordelaars in- of uitschakelen wanneer een verzoek wordt gedaan.
  • Selected users will receive request expiration reminders - herinneringsmails aan de beoordelaars in- of uitschakelen wanneer een verzoek bijna verloopt.
  • Consent request expires after (days) - geef aan hoe lang verzoeken geldig blijven.
• Klik op Save.

Verbinden

1. Navigeer naar apps en zoek naar Microsoft 365 Teams.
2. Klik op Add Connection.
3. Geef je verbinding een naam voor toekomstige referentie, bijvoorbeeld ‘Mijn organisatie’.
4. Onder Channel messages scope required specificeer Yes als je webhooks en/of acties voor kanaalberichten wilt gebruiken en No als dit niet het geval is. Verschillende machtigingen worden toegevoegd aan het autorisatieverzoek op basis van de waarde van deze verbindingsparameter.
5. Klik op Authorize connection.
6. Volg de instructies die Microsoft je geeft, en autoriseer Blackbird.io om namens jou te handelen.
7. Wanneer je terugkeert naar Blackbird, controleer of de verbinding is verschenen en de status Connected is.

Actions

Chat

• List chats geeft de lijst weer van chats waaraan de gebruiker deelneemt.
• Get chat message haalt een enkel bericht of een berichtantwoord op in een chat.
• Download files attached to chat message.
• Get the most recent chat messages.
• Send message to chat stuurt een nieuw bericht naar de gespecificeerde chat. Optioneel kun je een bestand bijvoegen van OneDrive en/of een bestand dat is verkregen als resultaat van de vorige actie.
• Delete message from chat.

Channel

• Get channel message haalt een enkel bericht of een berichtantwoord op in een kanaal.
• Download files attached to channel message.
• Send message to channel stuurt een nieuw bericht naar het gespecificeerde kanaal. Optioneel kun je een bestand bijvoegen van OneDrive en/of een bestand dat is verkregen als resultaat van de vorige actie.
• Reply to message in channel stuurt een antwoord op een bericht naar een specifiek kanaal. Optioneel kun je een bestand bijvoegen van OneDrive en/of een bestand dat is verkregen als resultaat van de vorige actie.

Users

• Get my user information haalt informatie op over het huidige account.
• List all users geeft een lijst weer van gebruikers in je organisatie.
• Get user.
• Get chat members geeft alle gesprekdeelnemers in een chat weer.

Events

• On message sent to chat wordt geactiveerd wanneer een nieuw bericht naar de chat wordt gestuurd.
• On message with attachments sent to chat wordt geactiveerd wanneer een nieuw bericht met bijlagen naar de chat wordt gestuurd.
• On user mentioned in chat wordt geactiveerd wanneer een nieuw bericht naar de chat wordt gestuurd waarin de gespecificeerde gebruiker wordt genoemd.
• On message sent to channel wordt geactiveerd wanneer een nieuw bericht naar het kanaal wordt gestuurd.
• On message with attachment sent to channel wordt geactiveerd wanneer een nieuw bericht met bijlagen naar het kanaal wordt gestuurd.
• On user mentioned in channel wordt geactiveerd wanneer een nieuw bericht naar het kanaal wordt gestuurd waarin de gespecificeerde gebruiker wordt genoemd.

Ontbrekende functies

In de toekomst kunnen we toevoegen:

• Webhooks voor online vergaderopnames en transcripties
• Webhooks voor chat-/kanaalleden
• Meer acties voor teams, kanalen, chats
• Acties voor online vergaderingen
• Acties voor diensten en roosters

Laat het ons weten als je hierin geïnteresseerd bent!