Skicka och ta emot sms

GÄLLER FÖR: SDK v4

Det primära sättet för din robot att kommunicera med användare och på samma sätt ta emot kommunikation är genom meddelandeaktiviteter . Vissa meddelanden får bara innehålla oformaterad text, medan andra kan innehålla mer omfattande innehåll, till exempel kort eller bifogade filer. Robotens turhanterare tar emot meddelanden från användaren och du kan skicka svar till användaren därifrån. Turn-kontextobjektet innehåller metoder för att skicka tillbaka meddelanden till användaren. I den här artikeln beskrivs hur du skickar oformaterade textmeddelanden.

Markdown stöds för de flesta textfält, men stödet kan variera beroende på kanal.

Om du vill ha en robot som skickar och tar emot meddelanden kan du följa snabbstarterna överst i innehållsförteckningen eller läsa artikeln om hur robotar fungerar, som även länkar till exempel som du kan köra själv.

Kommentar

Bot Framework JavaScript-, C#- och Python-SDK:erna fortsätter att stödjas, men Java SDK dras tillbaka med slutligt långsiktigt stöd som slutar i november 2023.

Befintliga robotar som skapats med Java SDK fortsätter att fungera.

Om du vill skapa en ny robot kan du använda Microsoft Copilot Studio och läsa om hur du väljer rätt copilot-lösning.

Mer information finns i Framtiden för robotbygge.

Skicka ett textmeddelande

Om du vill skicka ett textmeddelande anger du den sträng som du vill skicka som aktivitet:

C#

I robotens aktivitetshanterare använder du metoden turn context-objektet för SendActivityAsync att skicka ett enda meddelandesvar. Du kan också använda objektets SendActivitiesAsync metod för att skicka flera svar samtidigt.

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

JavaScript

I robotens aktivitetshanterare använder du metoden turn context-objektet för sendActivity att skicka ett enda meddelandesvar. Du kan också använda objektets sendActivities metod för att skicka flera svar samtidigt.

await context.sendActivity("Welcome!");

Java

I robotens aktivitetshanterare använder du metoden turn context-objektet för sendActivity att skicka ett enda meddelandesvar. Du kan också använda objektets sendActivities metod för att skicka flera svar samtidigt.

turnContext.sendActivity("Welcome!");

Python

I robotens aktivitetshanterare använder du metoden turn context-objektet för send_activity att skicka ett enda meddelandesvar.

await turn_context.send_activity("Welcome!")

LG

Språkgenerering (LG) innehåller mallar som innehåller en eller flera varianter av text som används för komposition och expansion. En av de varianter som tillhandahålls kommer att väljas slumpmässigt av LG-systemet.

I följande exempel visas en robotsvarsmall som innehåller två varianter.

# GreetingPrefix
- Hi
- Hello

Ta emot ett textmeddelande

Om du vill hantera ett textmeddelande använder du textegenskapen för aktivitetsobjektet.

C#

I robotens aktivitetshanterare använder du följande kod för att ta emot ett meddelande.

var responseMessage = turnContext.Activity.Text;

JavaScript

I robotens aktivitetshanterare använder du följande kod för att ta emot ett meddelande.

let text = turnContext.activity.text;

Java

I robotens aktivitetshanterare använder du följande kod för att ta emot ett meddelande.

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

Python

I robotens aktivitetshanterare använder du följande kod för att ta emot ett meddelande.

response = context.activity.text

LG

Lägg till följande LG-mall i .lg-filen för att ta emot ett meddelande.

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

Skicka en typindikator

Användarna förväntar sig ett snabbt svar på sina meddelanden. Om roboten utför en tidskrävande uppgift som att anropa en server eller köra en fråga utan att ge användaren någon indikation på att roboten hörde dem, kan användaren bli otålig och skicka ytterligare meddelanden eller bara anta att roboten är bruten.

Web Chat- och Direct Line-kanalrobotar kan stödja sändning av en typningsindikator för att visa användaren att meddelandet togs emot och bearbetas. Din robot måste dock låta svängen avslutas inom 15 sekunder, annars överskrider anslutningstjänsten tidsgränsen. För längre processer kan du läsa mer om att skicka proaktiva meddelanden.

I följande exempel visas hur du skickar en typningsindikator.

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
]

Ytterligare resurser

• Aktivitetsbearbetning
• Meddelandeaktivitetsavsnitt
• Språkgenerering

Nästa steg

Lägga till media i meddelanden