Envoyer et recevoir des SMS

S'APPLIQUE À : SDK v4

Pour communiquer avec les utilisateurs ainsi que pour recevoir des communications, votre bot aura pour moyen principal les activités de message. Certains messages peuvent simplement se composer de texte brut, tandis que d'autres peuvent contenir un contenu plus riche, comme les cartes ou les pièces jointes. Le gestionnaire de tours de votre robot reçoit des messages de l’utilisateur, et vous pouvez envoyer des réponses à l’utilisateur à ce moment. L’objet de contexte de tour fournit des méthodes pour renvoyer des messages à l’utilisateur. Cet article décrit comment envoyer des messages en texte brut.

Markdown est pris en charge pour la plupart des champs de texte, mais sa prise en charge varie selon le canal.

Pour un bot actif qui envoie et reçoit des messages, suivez les démarrages rapides en haut de la table des matières ou consultez l'article qui présente le fonctionnement des bots et qui contient également des liens vers des exemples que vous pouvez exécuter vous-même.

Remarque

Les kits SDK JavaScript, C# et Python Bot Framework continueront d’être pris en charge. Toutefois, le kit de développement logiciel (SDK) Java est mis hors service avec une prise en charge finale à long terme se terminant en novembre 2023.

Les bots existants créés avec le kit de développement logiciel (SDK) Java continueront de fonctionner.

Pour la nouvelle génération de bots, envisagez d'utiliser Power Virtual Agents et découvrez comment choisir la solution de chatbot appropriée.

Pour plus d'informations, consultez Les futures versions de bot.

Envoyer un SMS

Pour envoyer un message texte, spécifiez la chaîne que vous voulez envoyer en tant qu'activité :

C#

Dans le gestionnaire d’activités du bot, utilisez la méthode SendActivityAsync de l’objet de contexte de tour pour envoyer un seul message de réponse. Vous pouvez également utiliser la méthode SendActivitiesAsync de l’objet pour envoyer plusieurs réponses à la fois.

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

JavaScript

Dans le gestionnaire d’activités du bot, utilisez la méthode sendActivity de l’objet de contexte de tour pour envoyer un seul message de réponse. Vous pouvez également utiliser la méthode sendActivities de l’objet pour envoyer plusieurs réponses à la fois.

await context.sendActivity("Welcome!");

Java

Dans le gestionnaire d’activités du bot, utilisez la méthode sendActivity de l’objet de contexte de tour pour envoyer un seul message de réponse. Vous pouvez également utiliser la méthode sendActivities de l’objet pour envoyer plusieurs réponses à la fois.

turnContext.sendActivity("Welcome!");

Python

Dans le gestionnaire d’activités du bot, utilisez la méthode send_activity de l’objet de contexte de tour pour envoyer un seul message de réponse.

await turn_context.send_activity("Welcome!")

Génération de langage

La génération de langage fournit des modèles qui incluent une ou plusieurs variantes de texte utilisées pour la composition et l’expansion. L’une des variantes fournies est choisie au hasard par le système de génération de langage.

L'exemple suivant montre un gabarit de réponse de bot qui comprend deux variantes.

# GreetingPrefix
- Hi
- Hello

Recevoir un message texte

Pour traiter un SMS, utilisez la propriété texte de l'objet activité.

C#

Dans les gestionnaires d’activités du bot, utilisez le code suivant pour recevoir un message.

var responseMessage = turnContext.Activity.Text;

JavaScript

Dans les gestionnaires d’activités du bot, utilisez le code suivant pour recevoir un message.

let text = turnContext.activity.text;

Java

Dans les gestionnaires d’activités du bot, utilisez le code suivant pour recevoir un message.

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

Python

Dans les gestionnaires d’activités du bot, utilisez le code suivant pour recevoir un message.

response = context.activity.text

Génération de langage

Ajoutez le modèle de génération de langage suivant à votre fichier .lg pour recevoir un message.

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

Envoyer un indicateur de saisie

Les utilisateurs attendent une réponse rapide à leurs messages. Si votre bot effectue une tâche longue comme l’appel d’un serveur ou l’exécution d’une requête sans fournir à l’utilisateur une indication que le bot a bien reçu sa demande, cet utilisateur peut perdre patience et envoyer des messages supplémentaires ou supposer tout simplement que le bot ne fonctionne pas.

Les bots des canaux Web Chat et Direct Line prennent en charge l’envoi d’une indication de saisie pour prévenir l’utilisateur que le message a bien été reçu et qu’il est en cours de traitement. Toutefois, votre bot doit laisser le tour s'arrêter dans les 15 secondes ou le service Connecteur aura expiré. Pour des processus plus longs, informez-vous d'avantage sur l'envoi de messages proactifs.

L’exemple suivant montre comment envoyer une indication de saisie.

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."
        )

Génération de langage

# TypingIndicator
[Activity
    Type = typing
]

Ressources supplémentaires

• Traitement de l’activité
• Section Activité des messages
• Génération de langage

Étapes suivantes

Ajouter des médias aux messages