Vom Bot gesendete Nachrichten aktualisieren und löschen

Wichtig

Die Codebeispiele in diesem Abschnitt basieren auf Version 4.6 und höheren Versionen des Bot Framework SDK. Wenn Sie nach Dokumentation zu früheren Versionen suchen, lesen Sie den Abschnitt bots – v3 SDK im Ordner Legacy SDKs der Dokumentation.

Ihr Bot kann Nachrichten nach dem Senden dynamisch aktualisieren, anstatt sie als statische Momentaufnahmen von Daten zu behalten. Nachrichten können auch mithilfe der Bot Framework-Methode DeleteActivity gelöscht werden.

Nachricht aktualisieren

Sie können dynamische Nachrichtenaktualisierungen für Szenarien wie Umfrageaktualisierungen, das Ändern verfügbarer Aktionen nach einem Tastendruck oder jede andere asynchrone Zustandsänderung verwenden.

Es ist nicht erforderlich, dass die neue Nachricht mit dem ursprünglichen Typ übereinstimmt. Wenn die ursprüngliche Nachricht beispielsweise einen Anhang enthielt, kann die neue Nachricht eine einfache Textnachricht sein.

C#

• SDK-Referenz
• Beispielcodereferenz

Um eine vorhandene Nachricht zu aktualisieren, übergeben Sie ein neues Activity-Objekt mit der vorhandenen Aktivitäts-ID an die UpdateActivityAsync-Methode der TurnContext-Klasse.

// Send initial message
var response = await turnContext.SendActivityAsync(MessageFactory.Attachment(card.ToAttachment()), cancellationToken);
var activityId = response.Id; // Fetch activity id.

// MessageFactory.Text(): Specifies the type of text data in a message attachment.
var newActivity = MessageFactory.Text("The new text for the activity");
newActivity.Id = activityId;

// UpdateActivityAsync(): A method that can participate in update activity events for the current turn.
await turnContext.UpdateActivityAsync(newActivity, cancellationToken);

TypeScript

• SDK-Referenz
• Beispielcodereferenz

Um eine vorhandene Nachricht zu aktualisieren, übergeben Sie ein neues Activity-Objekt mit der vorhandenen Aktivitäts-ID an die updateActivity-Methode des TurnContext-Objekts.

// Send initial message
var message = await context.sendActivity("<Your Message>");
var activityId = message.id; // Fetch activity id.

// MessageFactory.Text(): Specifies the type of text data in a message attachment.
const newActivity = MessageFactory.text('The new text for the activity');
newActivity.id = activityId;

// A method that can participate in update activity events for the current turn.
await turnContext.updateActivity(newActivity);

Python

• SDK-Referenz
• Beispielcodereferenz

Um eine vorhandene Nachricht zu aktualisieren, übergeben Sie ein neues Activity-Objekt mit der vorhandenen Aktivitäts-ID an die update_activity-Methode der TurnContext-Klasse.

# Send initial message
message = await turn_context.send_activity("<Your Message>")
activityId = message.id # Fetch activity id.

# MessageFactory.Text(): Specifies the type of text data in a message attachment.
new_activity = MessageFactory.text("The new text for the activity")
new_activity.id = activity_id

# A method that can participate in update activity events for the current turn.
update_result = await context.update_activity(new_activity)

REST API

Hinweis

Sie können Microsoft Teams-Apps in jeder beliebigen Webprogrammiertechnologie entwickeln und die Bot Connector-Dienst-REST-APIs direkt aufrufen. Dazu müssen Sie mit Ihren API-Anforderungen Authentifizierungssicherheitsverfahren implementieren.

Um eine vorhandene Aktivität innerhalb einer Unterhaltung zu aktualisieren, schließen Sie conversationId und activityId in den Anforderungsendpunkt ein. Um dieses Szenario abzuschließen, müssen Sie die vom ursprünglichen POST-Aufruf zurückgegebene Aktivitäts-ID zwischenspeichern.

PUT /v3/conversations/{conversationId}/activities/{activityId}

Anforderung	Antwort
Ein Activity-Objekt	Ein ResourceResponse-Objekt

---

Nachdem Sie Nachrichten aktualisiert haben, aktualisieren Sie die vorhandene Karte bei der Schaltflächenauswahl für eingehende Aktivitäten.

Karten aktualisieren

Um die vorhandene Karte bei der Schaltflächenauswahl zu aktualisieren, können Sie ReplyToId von eingehenden Aktivitäten verwenden.

C#

• SDK-Referenz
• Beispielcodereferenz

Um eine vorhandene Karte bei der Schaltflächenauswahl zu aktualisieren, übergeben Sie ein neues Activity-Objekt mit aktualisierter Karte und ReplyToId als Aktivitäts-ID an die UpdateActivityAsync-Methode der TurnContext-Klasse.

// Returns a message activity that contains an attachment.
var activity = MessageFactory.Attachment(card.ToAttachment());
activity.Id = turnContext.Activity.ReplyToId;

// A method that can participate in update activity events for the current turn.
await turnContext.UpdateActivityAsync(activity, cancellationToken);

TypeScript

• SDK-Referenz
• Beispielcodereferenz

Um eine vorhandene Karte bei der Schaltflächenauswahl zu aktualisieren, übergeben Sie ein neues Activity-Objekt mit aktualisierter Karte und replyToId als Aktivitäts-ID an die updateActivity-Methode des TurnContext-Objekts.

// MessageFactory.attachment(): Returns a message activity that contains an attachment.
const message = MessageFactory.attachment(card);
message.id = context.activity.replyToId;

// updateActivity(): A method that can participate in update activity events for the current turn.
await context.updateActivity(message);

Python

• SDK-Referenz
• Beispielcodereferenz

Um eine vorhandene Karte beim Klick auf eine Schaltfläche zu aktualisieren, übergeben Sie ein neues Activity-Objekt mit aktualisierter Karte und reply_to_id als Aktivitäts-ID an die update_activity-Methode der TurnContext-Klasse.

# MessageFactory.attachment(): Returns a message activity that contains an attachment.
updated_activity = MessageFactory.attachment(CardFactory.hero_card(card))
updated_activity.id = turn_context.activity.reply_to_id

# update_activity(): A method that can participate in update activity events for the current turn.
await turn_context.update_activity(updated_activity)

REST API

Hinweis

Sie können Microsoft Teams-Apps in jeder beliebigen Webprogrammiertechnologie entwickeln und die Bot Connector-Dienst-REST-APIs direkt aufrufen. Dazu müssen Sie mit Ihren API-Anforderungen Authentifizierungssicherheitsverfahren implementieren.

Um eine vorhandene Aktivität innerhalb einer Unterhaltung zu aktualisieren, schließen Sie conversationId und activityId in den Anforderungsendpunkt ein. Um dieses Szenario abzuschließen, müssen Sie die vom ursprünglichen POST-Aufruf zurückgegebene Aktivitäts-ID zwischenspeichern.

PUT /v3/conversations/{conversationId}/activities/{activityId}

Anforderung	Antwort
Ein activity-Objekt	Ein ResourceResponse-Objekt

Nachdem Sie Karten aktualisiert haben, können Sie Nachrichten mithilfe des Bot Framework löschen.

Löschen von Nachrichten

Im Bot Framework hat jede Nachricht ihren eindeutigen Aktivitätsbezeichner. Nachrichten können mithilfe der Bot Framework-Methode DeleteActivity gelöscht werden.

C#

• SDK-Referenz
• Beispielcodereferenz

Um eine Nachricht zu löschen, übergeben Sie die ID dieser Aktivität an die DeleteActivityAsync-Methode der TurnContext-Klasse.

foreach (var activityId in _list)
{
    // When overridden in a derived class, deletes an existing activity in the conversation.
    await turnContext.DeleteActivityAsync(activityId, cancellationToken);
}

TypeScript

• SDK-Referenz
• Beispielcodereferenz

Um eine Nachricht zu löschen, übergeben Sie die ID dieser Aktivität an die deleteActivity-Methode des TurnContext-Objekts.

for (let i = 0; i < activityIds.length; i++) {
    // deleteActivity(): deletes an existing activity in the conversation.
    await turnContext.deleteActivity(activityIds[i]);
}

Python

• SDK-Referenz
• Beispielcodereferenz

Um die Nachricht zu löschen, übergeben Sie die ID dieser Aktivität an die delete_activity-Methode des TurnContext-Objekts.

for each activity_id in _list:
    # delete_activity(): deletes an existing activity in the conversation.
    await TurnContext.delete_activity(activity_id)

REST API

Um eine vorhandene Aktivität innerhalb einer Unterhaltung zu löschen, schließen Sie conversationId und activityId in den Anforderungsendpunkt ein.

DELETE /v3/conversations/{conversationId}/activities/{activityId}

Anforderung und Antwort	Beschreibung
Nicht zutreffend	Ein HTTP-Statuscode, der das Ergebnis des Vorgangs angibt. Im Textkörper der Antwort ist nichts angegeben.

Codebeispiel

Im folgenden Codebeispiel werden die Grundaspekte von Unterhaltungen veranschaulicht:

Beispielname	Beschreibung	.NET	Node.js	Python	Manifest
Grundlagen zu Teams-Unterhaltungen	In diesem Beispiel wird gezeigt, wie Sie verschiedene Botunterhaltungsereignisse verwenden, die in Bot Framework v4 für den persönlichen Bereich und den Teams-Bereich verfügbar sind.	View	View	View	View

Nächster Schritt

Microsoft Teams-Kontext für Ihren Bot erhalten

Siehe auch

• Erstellen von Bots für Teams
• Grundlagen zu Unterhaltungen
• Karten