Wysyłanie i odbieranie wiadomości SMS

DOTYCZY: ZESTAW SDK w wersji 4

Podstawowym sposobem komunikowania się bota z użytkownikami i odbieraniem komunikacji jest działanie komunikatów . Niektóre wiadomości mogą zawierać tylko zwykły tekst, a inne mogą zawierać bogatszą zawartość, taką jak karty lub załączniki. Program obsługi kolei bota odbiera komunikaty od użytkownika i możesz wysłać odpowiedzi do użytkownika z tego miejsca. Obiekt kontekstu kolei udostępnia metody wysyłania komunikatów z powrotem do użytkownika. W tym artykule opisano sposób wysyłania wiadomości w postaci zwykłego tekstu.

Język Markdown jest obsługiwany w przypadku większości pól tekstowych, ale obsługa może się różnić w zależności od kanału.

Aby uruchomić bota wysyłającego i odbierającego komunikaty, postępuj zgodnie z przewodnikami Szybki start w górnej części spisu treści lub zapoznaj się z artykułem dotyczącym działania botów, który zawiera również linki do przykładów dostępnych do samodzielnego uruchomienia.

Uwaga

Zestawy SDK języka JavaScript, C# i Python platformy Bot Framework będą nadal obsługiwane, jednak zestaw SDK języka Java jest wycofywany z ostatecznym długoterminowym wsparciem kończącym się w listopadzie 2023 r.

Istniejące boty utworzone za pomocą zestawu JAVA SDK będą nadal działać.

W przypadku tworzenia nowego bota rozważ użycie agentów usługi Power Virtual Agents i przeczytaj o wyborze odpowiedniego rozwiązania czatbota.

Aby uzyskać więcej informacji, zobacz Przyszłość tworzenia botów.

Wysyłanie wiadomości tekstowej

Aby wysłać wiadomość SMS, określ ciąg, który chcesz wysłać jako działanie:

C#

W programach obsługi działań bota użyj metody obiektu SendActivityAsync kontekstu turn, aby wysłać jedną odpowiedź komunikatu. Możesz również użyć metody obiektu do wysyłania SendActivitiesAsync wielu odpowiedzi jednocześnie.

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

JavaScript

W programach obsługi działań bota użyj metody obiektu sendActivity kontekstu turn, aby wysłać jedną odpowiedź komunikatu. Możesz również użyć metody obiektu do wysyłania sendActivities wielu odpowiedzi jednocześnie.

await context.sendActivity("Welcome!");

Java

W programach obsługi działań bota użyj metody obiektu sendActivity kontekstu turn, aby wysłać jedną odpowiedź komunikatu. Możesz również użyć metody obiektu do wysyłania sendActivities wielu odpowiedzi jednocześnie.

turnContext.sendActivity("Welcome!");

Python

W programach obsługi działań bota użyj metody obiektu send_activity kontekstu turn, aby wysłać jedną odpowiedź komunikatu.

await turn_context.send_activity("Welcome!")

LG

Generowanie języka (LG) udostępnia szablony zawierające co najmniej jedną odmianę tekstu, które są używane do tworzenia i rozszerzania. Jedna z podanych odmian zostanie wybrana losowo przez system LG.

W poniższym przykładzie przedstawiono szablon odpowiedzi bota, który zawiera dwie odmiany.

# GreetingPrefix
- Hi
- Hello

Odbieranie wiadomości SMS

Aby obsłużyć komunikat tekstowy, użyj właściwości text obiektu działania.

C#

W programach obsługi działań bota użyj następującego kodu, aby otrzymać komunikat.

var responseMessage = turnContext.Activity.Text;

JavaScript

W programach obsługi działań bota użyj następującego kodu, aby otrzymać komunikat.

let text = turnContext.activity.text;

Java

W programach obsługi działań bota użyj następującego kodu, aby otrzymać komunikat.

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

Python

W programach obsługi działań bota użyj następującego kodu, aby otrzymać komunikat.

response = context.activity.text

LG

Dodaj następujący szablon LG do pliku lg, aby otrzymać komunikat.

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

Wysyłanie wskaźnika wpisywania

Użytkownicy oczekują terminowej odpowiedzi na komunikaty. Jeśli bot wykonuje długotrwałe zadanie, takie jak wywoływanie serwera lub wykonywanie zapytania bez podawania użytkownikowi pewnego wskazania, że bot je usłyszał, użytkownik może uzyskać niecierpliwość i wysłać dodatkowe komunikaty lub po prostu założyć, że bot zostanie przerwany.

czat internetowy i boty kanału Direct Line mogą obsługiwać wysyłanie wskazania wpisywania, aby pokazać użytkownikowi, że wiadomość została odebrana i jest przetwarzana. Jednak bot musi pozwolić na zakończenie obrotu w ciągu 15 sekund lub przekroczenie limitu czasu usługi Połączenie or. W przypadku dłuższych procesów przeczytaj więcej na temat wysyłania proaktywnych komunikatów.

W poniższym przykładzie pokazano, jak wysłać wskazanie wpisywania.

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
]

Dodatkowe zasoby

• Przetwarzanie działań
• Sekcja działania komunikatu
• Generowanie języka

Następne kroki

Dodawanie multimediów do wiadomości