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:

Los SDK de JavaScript, C# y Python de Bot Framework seguirán siendo compatibles, pero el SDK de Java se va a retirar con la finalización del soporte técnico a largo plazo en noviembre de 2023. Solo se realizarán correcciones de errores y seguridad críticos en este repositorio.

Los bots existentes creados con el SDK de Java seguirán funcionando.

Para la nueva compilación de bots, considere la posibilidad de usar Power Virtual Agents y lea sobre cómo elegir la solución de bot de chat adecuada.

Para obtener más información, consulte El futuro de la construcción de bots.

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!");

Python

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();

Python

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);
    }
}

Python

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