Los ejemplos de código de esta sección se basan en la versión 4.6 y versiones posteriores del SDK de Bot Framework. Si está buscando documentación para versiones anteriores, consulte la sección bots - v3 SDK en la carpeta Resources de la documentación.
El bot puede actualizar dinámicamente los mensajes después de enviarlos en lugar de tenerlos como instantáneas estáticas de datos. Los mensajes también se pueden eliminar mediante el método de Bot DeleteActivity Framework.
Actualizar mensajes
Puede usar actualizaciones dinámicas de mensajes para escenarios, como las actualizaciones de sondeo, la modificación de las acciones disponibles después de presionar un botón o cualquier otro cambio de estado asincrónico.
No es necesario que el nuevo mensaje coincida con el tipo original. Por ejemplo, si el mensaje original contiene datos adjuntos, el nuevo mensaje puede ser un mensaje de texto simple.
Para actualizar un mensaje existente, pase un nuevo objeto con el identificador de actividad Activity existente al método de la UpdateActivityAsyncTurnContext clase. Para obtener más información, vea TurnContextClass.
var newActivity = MessageFactory.Text("The new text for the activity");
newActivity.Id = activityId;
await turnContext.UpdateActivityAsync(newActivity, cancellationToken);
Para actualizar un mensaje existente, pase un nuevo objeto con el identificador de actividad Activity existente al método del updateActivityTurnContext objeto. Para obtener más información, vea updateActivity.
const newActivity = MessageFactory.text('The new text for the activity');
newActivity.id = activityId;
await turnContext.updateActivity(newActivity);
Para actualizar un mensaje existente, pase un nuevo objeto con el identificador de actividad Activity existente al método de la update_activityTurnContext clase. Vea TurnContextClass.
new_activity = MessageFactory.text("The new text for the activity")
new_activity.id = activity_id
update_result = await context.update_activity(new_activity)
Nota
Puede desarrollar aplicaciones Teams en cualquier tecnología de programación web y llamar directamente a las API rest del servicio Bot Connector. Para ello, debe implementar procedimientos de seguridad de autenticación con las solicitudes de API.
Para actualizar una actividad existente dentro de una conversación, incluya y conversationId en el extremo de activityId solicitud. Para completar este escenario, debe almacenar en caché el identificador de actividad devuelto por la llamada posterior original.
PUT /v3/conversations/{conversationId}/activities/{activityId}
Para actualizar la tarjeta existente en una selección de botón, pase un nuevo objeto con la tarjeta actualizada y como identificador de actividad Activity al método de la ReplyToIdUpdateActivityAsyncTurnContext clase. Vea TurnContextClass.
var activity = MessageFactory.Attachment(card.ToAttachment());
activity.Id = turnContext.Activity.ReplyToId;
await turnContext.UpdateActivityAsync(activity, cancellationToken);
Para actualizar la tarjeta existente en una selección de botón, pase un nuevo objeto con la tarjeta actualizada y como identificador de actividad ActivityreplyToId al método del updateActivityTurnContext objeto. Vea updateActivity.
Para actualizar la tarjeta existente en un clic de botón, pase un nuevo objeto con la tarjeta actualizada y como identificador de actividad Activity al método de la reply_to_idupdate_activityTurnContext clase. Vea TurnContextClass.
Puede desarrollar aplicaciones Teams en cualquier tecnología de programación web y llamar directamente a las API rest del servicio de conector de bot. Para ello, debe implementar procedimientos de seguridad de autenticación con las solicitudes DE API.
Para actualizar una actividad existente dentro de una conversación, incluya y conversationId en el extremo de activityId solicitud. Para completar este escenario, debe almacenar en caché el identificador de actividad devuelto por la llamada posterior original.
PUT /v3/conversations/{conversationId}/activities/{activityId}
Ahora que ha actualizado las tarjetas, puede eliminar mensajes con Bot Framework.
Eliminar mensajes
En Bot Framework, cada mensaje tiene su identificador de actividad único. Los mensajes se pueden eliminar mediante el método de Bot DeleteActivity Framework.
Para eliminar un mensaje, pase el identificador de esa actividad al DeleteActivityAsync método de la TurnContext clase. Para obtener más información, consulta TurnContext.DeleteActivityAsync (método).
foreach (var activityId in _list)
{
await turnContext.DeleteActivityAsync(activityId, cancellationToken);
}
Para eliminar un mensaje, pase el identificador de esa actividad al deleteActivity método del TurnContext objeto. Para obtener más información, vea deleteActivity.
for (let i = 0; i < activityIds.length; i++) {
await turnContext.deleteActivity(activityIds[i]);
}
Para eliminar ese mensaje, pase el identificador de esa actividad al delete_activity método del TurnContext objeto. Para obtener más información, vea activity-update-and-delete.
for each activity_id in _list:
await TurnContext.delete_activity(activity_id)
Para eliminar una actividad existente dentro de una conversación, incluya y conversationId en el extremo de activityId solicitud.
