Envío y recepción de mensajes de texto

SE APLICA A: SDK v4

La forma principal comunicación del bot con los usuarios y de recepción de comunicación es mediante actividades de mensaje. Algunos mensajes pueden contener solo texto sin formato, mientras que otros pueden tener un contenido más rico, como tarjetas o archivos adjuntos. El controlador de turnos del bot recibe mensajes del usuario y puede enviar respuestas al usuario desde ahí. El objeto del contexto de turno proporciona métodos para enviar mensajes al usuario. Este artículo describe cómo enviar mensajes de texto simples.

Markdown es compatible con la mayoría de los campos de texto, pero la compatibilidad puede variar según el canal.

Para un bot en ejecución que envía y recibe mensajes, siga los tutoriales en la parte superior de la tabla de contenido o consulte el artículo sobre cómo funcionan los bots, que también incluye vínculos a ejemplos disponibles para que pueda ejecutarlos usted mismo.

Nota:

Para crear agentes con su elección de servicios de inteligencia artificial, orquestación y conocimientos, considere la posibilidad de usar el SDK de agentes de Microsoft 365. El SDK de agentes admite C#, JavaScript o Python. Puede obtener más información sobre el SDK de agentes en aka.ms/agents. Si busca una plataforma de agente basada en SaaS, considere Microsoft Copilot Studio. Si tiene un bot existente creado con Bot Framework SDK, puede actualizar el bot al SDK de agentes. Puede revisar los cambios principales y las actualizaciones en la guía de migración del Bot Framework SDK al SDK de Agentes. Las incidencias de soporte técnico del SDK de Bot Framework ya no se atenderán a partir del 31 de diciembre de 2025.

Enviar un mensaje de texto

Para enviar un mensaje de texto, especifique la string que desee enviar como actividad.

C#

En los controladores de actividades del bot, use convertir el método SendActivityAsync del objeto de contexto para enviar una solicitud de mensaje única. También puede usar el método SendActivitiesAsync del objeto para enviar varias respuestas a la vez.

await turnContext.SendActivityAsync($"Welcome!");

JavaScript

En los controladores de actividades del bot, use convertir el método sendActivity del objeto de contexto para enviar una solicitud de mensaje única. También puede usar el método sendActivities del objeto para enviar varias respuestas a la vez.

await context.sendActivity("Welcome!");

Java

En los controladores de actividades del bot, use convertir el método sendActivity del objeto de contexto para enviar una solicitud de mensaje única. También puede usar el método sendActivities del objeto para enviar varias respuestas a la vez.

turnContext.sendActivity("Welcome!");

Pitón

En los controladores de actividades del bot, use convertir el método send_activity del objeto de contexto para enviar una solicitud de mensaje única.

await turn_context.send_activity("Welcome!")

LG

Language Generation (LG) proporciona plantillas que incluyen una o más variaciones de texto que se usan para la composición y la expansión. El sistema LG seleccionará una de las variaciones proporcionadas de forma aleatoria.

En el siguiente ejemplo se muestra una plantilla de respuesta bot que incluye dos variaciones.

# GreetingPrefix
- Hi
- Hello

Recibir un mensaje de texto

Para administrar un mensaje de texto, utilice la propiedad text del objeto activity.

C#

En los controladores de actividades del bot, use el siguiente código para recibir un mensaje.

var responseMessage = turnContext.Activity.Text;

JavaScript

En los controladores de actividades del bot, use el siguiente código para recibir un mensaje.

let text = turnContext.activity.text;

Java

En los controladores de actividades del bot, use el siguiente código para recibir un mensaje.

String responseMessage = turnContext.getActivity().getText();

Pitón

En los controladores de actividades del bot, use el siguiente código para recibir un mensaje.

response = context.activity.text

LG

Agregue la siguiente plantilla de LG al archivo .lg para recibir un mensaje.

# EchoMessage
You said '${turn.activity.text}'

Envío de un indicador de escritura

Los usuarios esperan una respuesta a tiempo a sus mensajes. Si el bot realiza alguna tarea de larga ejecución como llamar a un servidor o ejecutar una consulta sin proporcionar al usuario ninguna indicación de que el bot le ha escuchado, el usuario podría impacientarse o simplemente suponer que el bot no funciona.

Los bots de los canales Web Chat y Direct Line admiten el envío de una indicación de escritura para mostrar al usuario que el mensaje se recibió y que se está procesando. Sin embargo, el bot tiene que dejar que el turno termine en 15 segundos o el servicio Conector agotará el tiempo de espera. Para procesos más largos, lea más sobre el envío de mensajes proactivos.

En el ejemplo siguiente se muestra cómo enviar una indicación de escritura.

C#

protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
    if (string.Equals(turnContext.Activity.Text, "wait", System.StringComparison.InvariantCultureIgnoreCase))
    {
        await turnContext.SendActivitiesAsync(
            new Activity[] {
                new Activity { Type = ActivityTypes.Typing },
                new Activity { Type = "delay", Value= 3000 },
                MessageFactory.Text("Finished typing", "Finished typing"),
            },
            cancellationToken);
    }
    else
    {
        var replyText = $"Echo: {turnContext.Activity.Text}. Say 'wait' to watch me type.";
        await turnContext.SendActivityAsync(MessageFactory.Text(replyText, replyText), cancellationToken);
    }
}

JavaScript

this.onMessage(async (context, next) => {
    if (context.activity.text === 'wait') {
        await context.sendActivities([
            { type: ActivityTypes.Typing },
            { type: 'delay', value: 3000 },
            { type: ActivityTypes.Message, text: 'Finished typing' }
        ]);
    } else {
        await context.sendActivity(`You said '${ context.activity.text }'. Say "wait" to watch me type.`);
    }
    await next();
});

Java

@Override
protected CompletableFuture<Void> onMessageActivity(TurnContext turnContext) {
    if (turnContext.getActivity().getText().toLowerCase().equals("wait")) {
        List<Activity> activities = new ArrayList<Activity>();
        activities.add(new Activity(ActivityTypes.TYPING));
        activities.add(new Activity(ActivityTypes.DELAY) {{setValue(3000);}});
        activities.add(MessageFactory.text("Finished typing", "Finished typing", null));
        return turnContext.sendActivities(activities).thenApply(result -> null);
    } else {

        return turnContext.sendActivity(MessageFactory.text("Echo: " + turnContext.getActivity().getText()))
            .thenApply(sendResult -> null);
    }
}

Pitón

async def on_message_activity(self, turn_context: TurnContext):
    if turn_context.activity.text == "wait":
        return await turn_context.send_activities([
            Activity(
                type=ActivityTypes.typing
            ),
            Activity(
                type="delay",
                value=3000
            ),
            Activity(
                type=ActivityTypes.message,
                text="Finished Typing"
            )
        ])
    else:
        return await turn_context.send_activity(
            f"You said {turn_context.activity.text}.  Say 'wait' to watch me type."
        )

LG

# TypingIndicator
[Activity
    Type = typing
]

Recursos adicionales

• Procesamiento de actividades
• Sección de actividad de mensajes
• Generación de lenguajes

Pasos siguientes

Incorporación de elementos multimedia a los mensajes