Schnellstart – Chats abrufen und Nachricht senden

Überblick

Dieser Leitfaden soll Sie bei der Erstellung eines funktionierenden Beispiels unterstützen, das verschiedene Microsoft Teams-Aktivitäten verwendet, einschließlich der Aktivitäten Get Chats, Get Chat Members, Send Message und Get Message .

Mit diesem Arbeitsbeispiel können Sie die Verbindung mit Ihrer registrierten Microsoft Teams-Anwendung schnell überprüfen und sich mit den Eingabe-/Ausgabedatentypen der Aktivität vertraut machen.

Nachdem Sie die Schritte in dieser Anleitung ausgeführt haben, verfügen Sie über eine Automatisierungs-Sequence, die Folgendes ausführt:

1. Stellt eine Verbindung mit Ihrer registrierten Microsoft Teams-Anwendung (Microsoft Teams Scope) her.
2. Ruft alle Ihre Chats ab (Get Chats).
3. Ruft die Mitglieder jedes Ihrer Chats ab (For Each und Get Chat Members).
4. Sucht den Chat, der ein bestimmtes Chatmitglied enthält, und sendet eine Nachricht (If, Assign und Send Message).

5. Überprüft, ob die Nachricht erfolgreich gesendet wurde, indem die Nachrichten-ID und der Nachrichteninhalt abgerufen und ausgegeben werden ( Get Message and Write Line).

   
   

   

   
   

Voraussetzungen

Bevor Sie beginnen:

1. Schließen Sie die Schritte zum Einrichten von Microsoft Teams ab.
2. Erstellen oder verwenden Sie einen Chat, senden Sie mindestens eine Chatnachricht.

Schritte

Erstellen Ihres Projekts

1. Fügen Sie die Aktivität Microsoft Teams Scope zu Ihrem Projekt hinzu.

2. Geben Sie die AnwendungsID für Ihre registrierte Anwendung ein.

   • Weitere Informationen finden Sie im Abschnitt Registrieren Ihrer Anwendung in der Setup- Anleitung.

3. Wählen Sie aus der Dropdownliste Authentifizierungstyp den anwendbaren Authentifizierungsablauf aus (z. B. InteractiveToken).

   • Weitere Informationen finden Sie auf der Aktivitätsseite „ Unattended vs. Attended “ auf der Aktivitätsseite Microsoft Teams Scope .

4. Fügen Sie die Aktivität Get Chats nach der Aktivität Microsoft Teams Scope hinzu.

   1. Erstellen und geben Sie eine Chat[] -Variable für Ihren Chat-Wert ein (z. B. myChats).
      • Wählen Sie beim Erstellen Ihrer Variablen Microsoft.Graph.Chat als Variablentyp aus.
   2. Fügen Sie eine For Each -Aktivität nach der Aktivität Get Chats hinzu.
   3. Wählen Sie in der Eigenschaft Typ des Arguments Microsoft.Graph.Chat aus.
   4. Geben Sie in der Eigenschaft Werte die Variable Chat[] ein, die Sie für die Aktivität Get Chats erstellt haben (z. B. myChats).

5. Fügen Sie in der Aktivität For Each eine Assign -Aktivität hinzu.

   1. Erstellen und geben Sie eine String -Variable für die An -Eigenschaft ein (z. B. chatId)

   2. Geben Sie in der Eigenschaft Wert ( Value ) item.Id ein.

      • Das Erstellen und Zuweisen des item.id- Werts zu dieser Variablen ermöglicht ihre Verwendung in einer späteren For Each -Aktivität mit einem anderen Argumenttyp.
   3. Fügen Sie die Aktivität Get Chat Members nach der Aktivität Assign hinzu .
   4. Geben Sie in der Eigenschaft ChatID Item.Id ein, um die Mitglieder für jeden Chat abzurufen.
   5. Erstellen und geben Sie eine ConversationMember[] -Variable für Ihren ChatMembers- Wert ein (z. B. myChatMembers).
      • Wählen Sie beim Erstellen Ihrer Variablen Microsoft.Graph.ConversationMember als Variablentyp aus.
   6. Fügen Sie eine weitere For Each- Aktivität nach der Aktivität Get Chat Members hinzu.
   7. Wählen Sie in der Eigenschaft Typ des Arguments Microsoft.Graph.ConversationMember aus.
   8. Geben Sie in der Eigenschaft Werte die Variable ConversationMember[] ein, die Sie für die Aktivität „ Get Chat Members “ erstellt haben (z. B. myChatMembers).

6. Fügen Sie in der For Each -Aktivität eine If -Aktivität hinzu.

   1. Geben Sie in der Eigenschaft Bedingung einen Wert ein, um einen bestimmten Chat nach Mitglied zu identifizieren (z. B. item.DisplayName="Sarah Connor")

7. Fügen Sie die Aktivität Nachricht senden ( Send Message ) im Sequence-Block Then hinzu.

   1. Geben Sie in der Eigenschaft ChatId die Variable String ein, die Sie für die Zuweisen ( Assign )-Aktivität erstellt haben (z. B. chatId).
   2. Geben Sie Ihren Text ein, den Sie senden möchten (z. B. „Ich möchte nur Hallo sagen“).
   3. Geben Sie in der Eigenschaft BodyType BodyType.Text ein.
   4. Erstellen und geben Sie eine String -Variable für Ihren NachrichtenID-Wert ein (z. B. newMessageId)
      
      

      

      
      

Testen Sie Ihr Projekt

1. Um zu testen, dass Ihre Aktivitäten Ihre Chats und Chat-Mitglieder abgerufen und eine Nachricht gesendet haben, fügen Sie eine Write Line- Aktivität nach der Aktivität Send Message hinzu.

   1. Geben Sie in der Eigenschaft Text die Variable String ein, die Sie für die Aktivität Nachricht senden ( Send Message ) erstellt haben (z. B. newMessageId).

2. Fügen Sie die Aktivität Get Message nach der Aktivität Write Line hinzu.

   1. Geben Sie in der Eigenschaft ChatId die Variable String ein, die Sie für die Zuweisen ( Assign )-Aktivität erstellt haben (z. B. chatId).
   2. Geben Sie in der Eigenschaft NachrichtenID die Variable String ein, die Sie für die Aktivität Nachricht senden erstellt haben (z. B. newMessageId).
      3. Erstellen und geben Sie eine ChatMessage -Variable für Ihren Nachrichtenwert ein (z. B. newMessage).
      • Wählen Sie beim Erstellen Ihrer Variablen _Microsoft.Graph.ChatMessage_ als Variablentyp aus.
   3. Fügen Sie eine weitere Write Line- Aktivität nach der Aktivität Get Message hinzu.
   4. Geben Sie in der Eigenschaft Text die Variable ChatMessage ein, die Sie für die Aktivität Get Message erstellt haben, und hängen Sie .Body.Content an das Ende an (z. B. newMessage.Body.Content)

3. Klicken Sie auf Ausführen und überprüfen Sie, ob das Fenster Ausgabe ( Output ) die ID und den Inhalt der gesendeten Nachricht enthält.

   
   

   

   
   

Alles erledigt!

Wenn Sie bereit sind, lesen Sie die anderen Schnellstartanleitungen , um sich mit den verschiedenen Microsoft Teams-Aktivitäten vertraut zu machen.

Weitere Informationen zu den Microsoft Teams-Aktivitäten (einschließlich Beispieleigenschaftseingaben/-ausgaben) finden Sie auf den folgenden Aktivitätsseiten mit einer vollständigen Aktivitätsliste und Links zu den Aktivitätsdetailseiten.

• Kanäle
• Chats
• Messages
• Teams