Mengirim dan menerima pesan teks

BERLAKU UNTUK: SDK v4

Cara utama bot Anda akan berkomunikasi dengan pengguna, dan juga menerima komunikasi, adalah melalui aktivitas pesan . Beberapa pesan mungkin hanya berisi teks biasa, sementara pesan lain mungkin berisi konten yang lebih kaya seperti kartu atau lampiran. Penangan giliran bot Anda menerima pesan dari pengguna, dan Anda dapat mengirim respons kepada pengguna dari sana. Objek konteks giliran menyediakan metode untuk mengirim pesan kembali ke pengguna. Artikel ini menjelaskan cara mengirim pesan teks biasa.

Markdown didukung untuk sebagian besar bidang teks, tetapi dukungan dapat bervariasi menurut saluran.

Untuk bot yang sedang berjalan mengirim dan menerima pesan, ikuti mulai cepat di bagian atas daftar isi atau lihat artikel tentang cara kerja bot, yang juga menautkan ke sampel yang tersedia untuk Anda jalankan sendiri.

Catatan

Bot Framework JavaScript, C#, dan Python SDK akan terus didukung, namun, Java SDK dihentikan dengan dukungan jangka panjang akhir yang berakhir pada November 2023.

Bot yang ada yang dibangun dengan Java SDK akan terus berfungsi.

Untuk pembuatan bot baru, pertimbangkan untuk menggunakan Power Virtual Agents dan baca tentang memilih solusi chatbot yang tepat.

Untuk informasi selengkapnya, lihat Masa depan pembuatan bot.

Mengirim pesan teks

Untuk mengirim pesan teks, tentukan string yang ingin Anda kirim sebagai aktivitas:

C#

Di penangan aktivitas bot, gunakan metode objek SendActivityAsync konteks giliran untuk mengirim satu respons pesan. Anda juga dapat menggunakan metode objek SendActivitiesAsync untuk mengirim beberapa respons sekaligus.

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

JavaScript

Di penangan aktivitas bot, gunakan metode objek sendActivity konteks giliran untuk mengirim satu respons pesan. Anda juga dapat menggunakan metode objek sendActivities untuk mengirim beberapa respons sekaligus.

await context.sendActivity("Welcome!");

Java

Di penangan aktivitas bot, gunakan metode objek sendActivity konteks giliran untuk mengirim satu respons pesan. Anda juga dapat menggunakan metode objek sendActivities untuk mengirim beberapa respons sekaligus.

turnContext.sendActivity("Welcome!");

Python

Di penangan aktivitas bot, gunakan metode objek send_activity konteks giliran untuk mengirim satu respons pesan.

await turn_context.send_activity("Welcome!")

LG

Pembuatan Bahasa (LG) menyediakan templat yang menyertakan satu atau beberapa variasi teks yang digunakan untuk komposisi dan perluasan. Salah satu variasi yang disediakan akan dipilih secara acak oleh sistem LG.

Contoh berikut menunjukkan templat respons bot yang menyertakan dua variasi.

# GreetingPrefix
- Hi
- Hello

Menerima pesan teks

Untuk menangani pesan teks, gunakan properti teks objek aktivitas.

C#

Di penanganan aktivitas bot, gunakan kode berikut untuk menerima pesan.

var responseMessage = turnContext.Activity.Text;

JavaScript

Di penanganan aktivitas bot, gunakan kode berikut untuk menerima pesan.

let text = turnContext.activity.text;

Java

Di penanganan aktivitas bot, gunakan kode berikut untuk menerima pesan.

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

Python

Di penanganan aktivitas bot, gunakan kode berikut untuk menerima pesan.

response = context.activity.text

LG

Tambahkan templat LG berikut ke file .lg Anda untuk menerima pesan.

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

Mengirim indikator pengetikan

Pengguna mengharapkan respons tepat waktu terhadap pesan mereka. Jika bot Anda melakukan beberapa tugas jangka panjang seperti memanggil server atau menjalankan kueri tanpa memberi pengguna beberapa indikasi bahwa bot mendengarnya, pengguna bisa tidak sabar dan mengirim pesan tambahan atau hanya menganggap bot rusak.

Bot saluran Web Chat dan Direct Line dapat mendukung pengiriman indikasi pengetikan untuk menunjukkan kepada pengguna bahwa pesan diterima dan sedang diproses. Namun, bot Anda harus membiarkan belokan berakhir dalam waktu 15 detik atau layanan Koneksi or akan kehabisan waktu. Untuk proses yang lebih lama, baca selengkapnya tentang mengirim pesan proaktif.

Contoh berikut menunjukkan cara mengirim indikasi pengetikan.

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
]

Sumber Daya Tambahan:

• Pemrosesan aktivitas
• Bagian aktivitas pesan
• Pembuatan Bahasa

Langkah berikutnya

Menambahkan media ke pesan