傳送歡迎訊息給使用者

發行項
05/02/2024

適用於： SDK v4

建立任何 Bot 時的主要目標是讓您的用戶參與有意義的交談。達成此目標的最佳方式之一是確保從使用者第一次連線的那一刻起，他們就會瞭解 Bot 的主要用途和功能，也就是 Bot 建立的原因。本文提供程式碼範例，可協助您歡迎使用者使用 Bot。

注意

Bot Framework JavaScript、C# 和 Python SDK 將會繼續受到支援，不過，Java SDK 即將淘汰，最終長期支援將於 2023 年 11 月結束。

使用 Java SDK 建置的現有 Bot 將繼續運作。

針對新的 Bot 建置，請考慮使用 Microsoft Copilot Studio ，並閱讀選擇正確的 Copilot 解決方案。

如需詳細資訊，請參閱 Bot 建置的未來。

必要條件

瞭解 Bot 基本概念。
C# 範例、JS 範例、Java 範例或 Python 範例中的歡迎使用者範例複本。範例中的程式代碼可用來說明如何傳送歡迎訊息。

關於此範例程序代碼

此範例程式代碼示範如何偵測並歡迎新使用者一開始連線到您的 Bot。下圖顯示此 Bot 的邏輯流程。

Bot 遇到的兩個主要事件如下：

OnMembersAddedAsync，當新的用戶連線到 Bot 時呼叫。
OnMessageActivityAsync，會在 Bot 收到新的使用者輸入時呼叫。

C# 範例的邏輯流程圖。

每當新使用者連線時，Bot 就會提供WelcomeMessageInfoMessage、和 PatternMessage 。收到新的使用者輸入時，會檢查 WelcomeUserState 是否 DidBotWelcomeUser 設定為 true。如果沒有，則會將初始歡迎使用者訊息傳回給使用者。

Bot 遇到的兩個主要事件如下：

onMembersAdded，當新的用戶連線到 Bot 時呼叫。
onMessage，會在 Bot 收到新的使用者輸入時呼叫。

JavaScript 範例的邏輯流程圖。

每當新使用者連線時，Bot 就會提供welcomeMessageinfoMessage、和 patternMessage 。收到新的使用者輸入時， welcomedUserProperty 會檢查是否 didBotWelcomeUser 設定為 true。如果沒有，則會將初始歡迎使用者訊息傳回給使用者。如果 DidBotWelcomeUser 為 true，則會評估用戶的輸入。根據使用者輸入的內容，此 Bot 會執行下列其中一項動作：

回顯使用者收到的問候語。
顯示主圖卡片，提供 Bot 的新增資訊。
重新傳送 WelcomeMessage 此 Bot 的預期輸入。

Bot 遇到的兩個主要事件如下：

onMembersAdded，當新的用戶連線到 Bot 時呼叫。
onMessageActivity，會在 Bot 收到新的使用者輸入時呼叫。

Java 範例的邏輯流程圖。

每當新使用者連線時，Bot 就會提供WELCOME_MESSAGEINFO_MESSAGE、和 PATTERN_MESSAGE 。收到新的使用者輸入時，會檢查 WelcomeUserState 是否 getDidBotWelcomeUser() 設定為 true。如果沒有，則會將初始歡迎使用者訊息傳回給使用者。

Bot 遇到的兩個主要事件如下：

on_members_added_activity，當新的用戶連線到 Bot 時呼叫。
on_message_activity，會在 Bot 收到新的使用者輸入時呼叫。

Python 範例的邏輯流程圖。

每當新用戶連線時，Bot 就會提供 歡迎訊息、 資訊訊息和 模式訊息 。收到新的使用者輸入時，會 welcome_user_state.did_welcome_user 檢查屬性。如果未設定為 true，則會將初始歡迎使用者訊息傳回給使用者。如果設定為 true，則根據使用者輸入的內容，此 Bot 會執行下列其中一項動作：

回顯使用者收到的問候語。
顯示主圖卡片，提供 Bot 的新增資訊。

建立用戶狀態

用戶狀態物件會在啟動時建立，並將相依性插入 Bot 建構函式中。

Startup.cs


// Create the Bot Framework Authentication to be used with the Bot Adapter.
services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

// Create the Bot Adapter with error handling enabled.

Bots\WelcomeUserBot.cs


// Initializes a new instance of the "WelcomeUserBot" class.
public WelcomeUserBot(UserState userState)
{
    _userState = userState;
}

啟動時，Bot 建構函式會定義 index.js 並取用用戶狀態。

index.js


// Create HTTP server
const server = restify.createServer();
server.use(restify.plugins.bodyParser());

server.listen(process.env.port || process.env.PORT || 3978, function() {
    console.log(`\n${ server.name } listening to ${ server.url }`);
    console.log('\nGet Bot Framework Emulator: https://aka.ms/botframework-emulator');

用戶狀態物件會在啟動時建立，並透過 Spring 容器插入 Bot 建構函式中的相依性。

Application.java

@Bean
public Bot getBot(UserState userState) {
    return new WelcomeUserBot(userState);
}

WelcomeUserBot.java

private final UserState userState;

// Initializes a new instance of the "WelcomeUserBot" class.
@Autowired
public WelcomeUserBot(UserState withUserState) {
    userState = withUserState;
}

啟動時，Bot 建構函式會定義 app.py 並取用用戶狀態。

app.py


# Create the Bot
BOT = WelcomeUserBot(USER_STATE)


# Listen for incoming requests on /api/messages.

建立屬性存取子

我們現在會建立屬性存取子，提供我們在方法內的OnMessageActivityAsync句柄WelcomeUserState。然後呼叫 GetAsync 方法以取得適當範圍的索引鍵。接著，我們會使用 SaveChangesAsync 方法，在每個使用者輸入反覆項目之後儲存用戶狀態數據。

Bots\WelcomeUserState.cs

// Gets or sets whether the user has been welcomed in the conversation.
public bool DidBotWelcomeUser { get; set; } = false;

Bots\WelcomeUserBot.cs

var didBotWelcomeUser = await welcomeUserStateAccessor.GetAsync(turnContext, () => new WelcomeUserState(), cancellationToken);

    await _userState.SaveChangesAsync(turnContext, cancellationToken: cancellationToken);
}

我們現在建立屬性存取子，提供我們歡迎的UserProperty 句柄，該句柄會保存在userState中。

bots/welcomeBot.js

this.welcomedUserProperty = userState.createProperty(WELCOMED_USER);

this.onMessage(async (context, next) => {
    // Read UserState. If the 'DidBotWelcomedUser' does not exist (first time ever for a user)
    // set the default to false.
    const didBotWelcomedUser = await this.welcomedUserProperty.get(context, false);

/**
 * Override the ActivityHandler.run() method to save state changes after the bot logic completes.
 */
async run(context) {
    await super.run(context);

    // Save state changes
    await this.userState.saveChanges(context);
}

我們現在會建立屬性存取子，提供我們在方法內的onMessageActivity句柄WelcomeUserState。然後呼叫 get 方法以取得適當範圍的索引鍵。接著，我們會使用 saveChanges 方法，在每個使用者輸入反覆項目之後儲存用戶狀態數據。

WelcomeUserBot.java

// Get state data from UserState.
StatePropertyAccessor<WelcomeUserState> stateAccessor =
    userState.createProperty("WelcomeUserState");
CompletableFuture<WelcomeUserState> stateFuture =
    stateAccessor.get(turnContext, WelcomeUserState::new);

return super.onTurn(turnContext)
    .thenCompose(saveResult -> userState.saveChanges(turnContext));

這個範例會在 Bot 建構函式中建立對話狀態屬性存取子 user_state_accessor。

bots/welcome-user-bot.py

self.user_state_accessor = self._user_state.create_property("WelcomeUserState")

它會使用處理程式中的 on_message_activity 屬性存取子，並覆寫 on_turn 處理程式以在回合結尾之前儲存狀態。

# Get the state properties from the turn context.
welcome_user_state = await self.user_state_accessor.get(
    turn_context, WelcomeUserState
)

async def on_turn(self, turn_context: TurnContext):
    await super().on_turn(turn_context)

    # save changes to WelcomeUserState after each turn
    await self._user_state.save_changes(turn_context)

偵測並問候新連線的使用者

在 WelcomeUserBot 中，我們會使用 OnMembersAddedAsync() 檢查活動更新，以查看是否已將新使用者新增至交談，然後傳送一組三個初始歡迎訊息 WelcomeMessage和 InfoMessage PatternMessage。此互動的完整程序代碼如下所示。

Bots\WelcomeUserBot.cs

public class WelcomeUserBot : ActivityHandler
{
    // Messages sent to the user.
    private const string WelcomeMessage = "This is a simple Welcome Bot sample. This bot will introduce you " +
                                            "to welcoming and greeting users. You can say 'intro' to see the " +
                                            "introduction card. If you are running this bot in the Bot Framework " +
                                            "Emulator, press the 'Start Over' button to simulate user joining " +
                                            "a bot or a channel";

    private const string InfoMessage = "You are seeing this message because the bot received at least one " +
                                        "'ConversationUpdate' event, indicating you (and possibly others) " +
                                        "joined the conversation. If you are using the emulator, pressing " +
                                        "the 'Start Over' button to trigger this event again. The specifics " +
                                        "of the 'ConversationUpdate' event depends on the channel. You can " +
                                        "read more information at: " +
                                        "https://aka.ms/about-botframework-welcome-user";

    private const string LocaleMessage = "You can use the activity's 'GetLocale()' method to welcome the user " +
                                         "using the locale received from the channel. " + 
                                         "If you are using the Emulator, you can set this value in Settings.";

{
    foreach (var member in membersAdded)
    {
        if (member.Id != turnContext.Activity.Recipient.Id)
        {
            await turnContext.SendActivityAsync($"Hi there - {member.Name}. {WelcomeMessage}", cancellationToken: cancellationToken);
            await turnContext.SendActivityAsync(InfoMessage, cancellationToken: cancellationToken);
            await turnContext.SendActivityAsync($"{LocaleMessage} Current locale is '{turnContext.Activity.GetLocale()}'.", cancellationToken: cancellationToken);
            await turnContext.SendActivityAsync(PatternMessage, cancellationToken: cancellationToken);
        }
    }
}

此 JavaScript 程式代碼會在新增使用者時傳送初始歡迎訊息。這是藉由檢查交談活動，並確認已將新成員新增至交談來完成。

bots/welcomeBot.js

// Sends welcome messages to conversation members when they join the conversation.
// Messages are only sent to conversation members who aren't the bot.
this.onMembersAdded(async (context, next) => {
    // Iterate over all new members added to the conversation
    for (const idx in context.activity.membersAdded) {
        // Greet anyone that was not the target (recipient) of this message.
        // Since the bot is the recipient for events from the channel,
        // context.activity.membersAdded === context.activity.recipient.Id indicates the
        // bot was added to the conversation, and the opposite indicates this is a user.
        if (context.activity.membersAdded[idx].id !== context.activity.recipient.id) {
            await context.sendActivity(`Welcome to the 'Welcome User' Bot. This bot will introduce you to welcoming and greeting users.`);
            await context.sendActivity(`You are seeing this message because the bot received at least one 'ConversationUpdate' ` +
                `event, indicating you (and possibly others) joined the conversation. If you are using the emulator, ` +
                `pressing the 'Start Over' button to trigger this event again. The specifics of the 'ConversationUpdate' ` +
                `event depends on the channel. You can read more information at https://aka.ms/about-botframework-welcome-user`);
            await context.sendActivity(`You can use the activity's 'locale' property to welcome the user ` +
                `using the locale received from the channel. ` +
                `If you are using the Emulator, you can set this value in Settings. ` +
                `Current locale is '${ context.activity.locale }'`);
            await context.sendActivity(`It is a good pattern to use this event to send general greeting to user, explaining what your bot can do. ` +
                `In this example, the bot handles 'hello', 'hi', 'help' and 'intro'. ` +
                `Try it now, type 'hi'`);
        }
    }

    // By calling next() you ensure that the next BotHandler is run.
    await next();
});

在 WelcomeUserBot 中，我們會使用 onMembersAdded() 檢查活動更新，以查看是否已將新使用者新增至交談，然後傳送一組三個初始歡迎訊息 WELCOME_MESSAGE和 INFO_MESSAGE PATTERN_MESSAGE。此互動的完整程序代碼如下所示。

WelcomeUserBot.java

public class WelcomeUserBot extends ActivityHandler {
    // Messages sent to the user.
    private static final String WELCOME_MESSAGE =
        "This is a simple Welcome Bot sample. This bot will introduce you "
            + "to welcoming and greeting users. You can say 'intro' to see the "
            + "introduction card. If you are running this bot in the Bot Framework "
            + "Emulator, press the 'Start Over' button to simulate user joining "
            + "a bot or a channel";

    private static final String INFO_MESSAGE =
        "You are seeing this message because the bot received at least one "
            + "'ConversationUpdate' event, indicating you (and possibly others) "
            + "joined the conversation. If you are using the emulator, pressing "
            + "the 'Start Over' button to trigger this event again. The specifics "
            + "of the 'ConversationUpdate' event depends on the channel. You can "
            + "read more information at: " + "https://aka.ms/about-botframework-welcome-user";

    private String localeMessage =
        "You can use the activity's GetLocale() method to welcome the user "
            + "using the locale received from the channel. "
            + "If you are using the Emulator, you can set this value in Settings.";

    private static final String PATTERN_MESSAGE =
        "It is a good pattern to use this event to send general greeting"
            + "to user, explaining what your bot can do. In this example, the bot "
            + "handles 'hello', 'hi', 'help' and 'intro'. Try it now, type 'hi'";

@Override
protected CompletableFuture<Void> onMembersAdded(
    List<ChannelAccount> membersAdded,
    TurnContext turnContext
) {
    return membersAdded.stream()
        .filter(
            member -> !StringUtils
                .equals(member.getId(), turnContext.getActivity().getRecipient().getId())
        )
        .map(
            channel -> turnContext
                .sendActivities(
                    MessageFactory.text(
                        "Hi there - " + channel.getName() + ". " + WELCOME_MESSAGE
                    ),
                    MessageFactory.text(INFO_MESSAGE),
                    MessageFactory.text(
                        localeMessage
                        + " Current locale is " + turnContext.getActivity().getLocale() + "."),
                    MessageFactory.text(PATTERN_MESSAGE)
                )
        )
        .collect(CompletableFutures.toFutureList())
        .thenApply(resourceResponses -> null);
}

檢查 on_members_added_activity 是否已新增新的使用者，然後傳送三個初始歡迎訊息： 歡迎訊息、 資訊訊息 和 模式訊息。

bots/welcome-user-bot.py

"""
Greet when users are added to the conversation.
Note that all channels do not send the conversation update activity.
If you find that this bot works in the emulator, but does not in
another channel the reason is most likely that the channel does not
send this activity.
"""
for member in members_added:
    if member.id != turn_context.activity.recipient.id:
        await turn_context.send_activity(
            f"Hi there { member.name }. " + self.WELCOME_MESSAGE
        )

        await turn_context.send_activity(self.INFO_MESSAGE)

        await turn_context.send_activity(
            f"{ self.LOCALE_MESSAGE } Current locale is { turn_context.activity.locale }."
        )

        await turn_context.send_activity(self.PATTERN_MESSAGE)

歡迎新用戶並捨棄初始輸入

當您的使用者輸入實際上可能包含有用的資訊時，也請務必考慮，這可能會因每個通道而有所不同。為了確保您的使用者在所有可能通道上都有良好的體驗，我們會檢查狀態旗標 didBotWelcomeUser ，如果這是 “false”，則不會處理初始使用者輸入。相反地，我們會為使用者提供初始歡迎訊息。 bool welcomedUserProperty 接著會設定為 “true”，儲存在UserState中，我們的程式代碼現在將處理來自所有其他訊息活動的此用戶的輸入。

Bots\WelcomeUserBot.cs

{
    var welcomeUserStateAccessor = _userState.CreateProperty<WelcomeUserState>(nameof(WelcomeUserState));
    var didBotWelcomeUser = await welcomeUserStateAccessor.GetAsync(turnContext, () => new WelcomeUserState(), cancellationToken);

    if (didBotWelcomeUser.DidBotWelcomeUser == false)
    {
        didBotWelcomeUser.DidBotWelcomeUser = true;

        // the channel should sends the user name in the 'From' object
        var userName = turnContext.Activity.From.Name;

        await turnContext.SendActivityAsync("You are seeing this message because this was your first message ever to this bot.", cancellationToken: cancellationToken);
        await turnContext.SendActivityAsync($"It is a good practice to welcome the user and provide personal greeting. For example, welcome {userName}.", cancellationToken: cancellationToken);
    }
    else

    await _userState.SaveChangesAsync(turnContext, cancellationToken: cancellationToken);
}

當您的使用者輸入實際上可能包含有用的資訊時，也請務必考慮，這可能會因每個通道而有所不同。為了確保您的使用者在所有可能通道上都有良好的體驗，我們會檢查 didBotWelcomedUser 屬性，如果不存在，我們會將其設定為 “false”，且不會處理初始使用者輸入。相反地，我們會為使用者提供初始歡迎訊息。 bool didBotWelcomeUser 接著會設定為「true」，我們的程式代碼會處理來自所有其他訊息活動的用戶輸入。

bots/welcomeBot.js

this.onMessage(async (context, next) => {
    // Read UserState. If the 'DidBotWelcomedUser' does not exist (first time ever for a user)
    // set the default to false.
    const didBotWelcomedUser = await this.welcomedUserProperty.get(context, false);

    // Your bot should proactively send a welcome message to a personal chat the first time
    // (and only the first time) a user initiates a personal chat with your bot.
    if (didBotWelcomedUser === false) {
        // The channel should send the user name in the 'From' object
        const userName = context.activity.from.name;
        await context.sendActivity('You are seeing this message because this was your first message ever sent to this bot.');
        await context.sendActivity(`It is a good practice to welcome the user and provide personal greeting. For example, welcome ${ userName }.`);

        // Set the flag indicating the bot handled the user's first message.
        await this.welcomedUserProperty.set(context, true);
    } else {

    }

    // By calling next() you ensure that the next BotHandler is run.
    await next();
});

請務必考慮使用者輸入何時可能包含有用的資訊，而每個通道可能會有所不同。為了確保您的使用者在所有可能通道上都有良好的體驗，我們會檢查狀態旗標 getDidBotWelcomeUser ，如果這是 “false”，則不會處理初始用戶輸入。相反地，我們會為使用者提供初始歡迎訊息。 bool setDidBotWelcomeUser 接著會設定為 “true”，儲存在UserState中，我們的程式代碼現在會處理來自所有其他訊息活動的此用戶的輸入。

WelcomeUserBot.java

@Override
protected CompletableFuture<Void> onMessageActivity(TurnContext turnContext) {
    // Get state data from UserState.
    StatePropertyAccessor<WelcomeUserState> stateAccessor =
        userState.createProperty("WelcomeUserState");
    CompletableFuture<WelcomeUserState> stateFuture =
        stateAccessor.get(turnContext, WelcomeUserState::new);

    return stateFuture.thenApply(thisUserState -> {
        if (!thisUserState.getDidBotWelcomeUser()) {
            thisUserState.setDidBotWelcomeUser(true);

            // the channel should send the user name in the 'from' object
            String userName = turnContext.getActivity().getFrom().getName();
            return turnContext
                .sendActivities(
                    MessageFactory.text(FIRST_WELCOME_ONE),
                    MessageFactory.text(String.format(FIRST_WELCOME_TWO, userName))
                );

// Save any state changes. 
.thenApply(response -> userState.saveChanges(turnContext))

當使用者的輸入可能實際包含實用資訊時，也請務必考慮，這可能會因每個通道而有所不同。若要確保使用者在所有可能的通道上都有良好的體驗， on_message_activity 請檢查 did_welcome_user 屬性。第一次，它會將它設定為 false ，而且不會處理用戶輸入。相反地，它會為使用者提供初始歡迎訊息。然後將它設定 did_welcome_user 為 true ，並處理來自所有其他訊息活動的用戶輸入。

bots/welcome-user-bot.py

if not welcome_user_state.did_welcome_user:
    welcome_user_state.did_welcome_user = True

    await turn_context.send_activity(
        "You are seeing this message because this was your first message ever to this bot."
    )

    name = turn_context.activity.from_property.name
    await turn_context.send_activity(
        f"It is a good practice to welcome the user and provide personal greeting. For example: Welcome {name}"
    )

處理其他輸入

歡迎新用戶之後，系統會針對每個訊息回合評估使用者輸入資訊，而 Bot 會根據該使用者輸入的內容提供回應。下列程式代碼顯示用來產生該回應的決策邏輯。

「簡介」或「說明」的輸入會呼叫函 SendIntroCardAsync 式，向使用者呈現資訊主圖卡片。本文的下一節會檢查該程序代碼。

Bots\WelcomeUserBot.cs

    switch (text)
    {
        case "hello":
        case "hi":
            await turnContext.SendActivityAsync($"You said {text}.", cancellationToken: cancellationToken);
            break;
        case "intro":
        case "help":
            await SendIntroCardAsync(turnContext, cancellationToken);
            break;
        default:
            await turnContext.SendActivityAsync(WelcomeMessage, cancellationToken: cancellationToken);
            break;
    }
}

「簡介」或「說明」的輸入會使用 CardFactory 向用戶呈現簡介調適型卡片。本文的下一節會檢查該程序代碼。

bots/welcomeBot.js

// This example uses an exact match on user's input utterance.
// Consider using LUIS or QnA for Natural Language Processing.
const text = context.activity.text.toLowerCase();
switch (text) {
case 'hello':
case 'hi':
    await context.sendActivity(`You said "${ context.activity.text }"`);
    break;
case 'intro':
case 'help':
    await this.sendIntroCard(context);
    break;
default:
    await context.sendActivity(`This is a simple Welcome Bot sample. You can say 'intro' to
                                    see the introduction card. If you are running this bot in the Bot
                                    Framework Emulator, press the 'Start Over' button to simulate user joining a bot or a channel`);
}

「簡介」或「說明」的輸入會呼叫函 sendIntroCard 式，向使用者呈現資訊主圖卡片。本文的下一節會檢查該程序代碼。

WelcomeUserBot.java

// This example hardcodes specific utterances. 
// You should use LUIS or QnA for more advance language understanding.
String text = turnContext.getActivity().getText().toLowerCase();
switch (text) {
    case "hello":
    case "hi":
        return turnContext.sendActivities(MessageFactory.text("You said " + text));

    case "intro":
    case "help":
        return sendIntroCard(turnContext);

    default:
        return turnContext.sendActivity(WELCOME_MESSAGE);
}

使用者 輸入簡介 或說明會導致 Bot 呼叫 __send_intro_card，這會向用戶呈現簡介調適型卡片。

bots/welcome-user-bot.py

if text in ("hello", "hi"):
    await turn_context.send_activity(f"You said { text }")
elif text in ("intro", "help"):
    await self.__send_intro_card(turn_context)
else:
    await turn_context.send_activity(self.WELCOME_MESSAGE)

使用主圖卡片問候語

如上所述，某些使用者輸入會產生 主圖卡片 ，以回應其要求。您可以在這裡深入瞭解主圖卡片問候語傳送簡介卡片。以下是建立此 Bot 主圖卡片回應所需的程序代碼。

Bots\WelcomeUserBot.cs

    {
        var card = new HeroCard
        {
            Title = "Welcome to Bot Framework!",
            Text = @"Welcome to Welcome Users bot sample! This Introduction card
                     is a great way to introduce your Bot to the user and suggest
                     some things to get them started. We use this opportunity to
                     recommend a few next steps for learning more creating and deploying bots.",
            Images = new List<CardImage>() { new CardImage("https://aka.ms/bf-welcome-card-image") },
            Buttons = new List<CardAction>()
            {
                new CardAction(ActionTypes.OpenUrl, "Get an overview", null, "Get an overview", "Get an overview", "https://docs.microsoft.com/en-us/azure/bot-service/?view=azure-bot-service-4.0"),
                new CardAction(ActionTypes.OpenUrl, "Ask a question", null, "Ask a question", "Ask a question", "https://stackoverflow.com/questions/tagged/botframework"),
                new CardAction(ActionTypes.OpenUrl, "Learn how to deploy", null, "Learn how to deploy", "Learn how to deploy", "https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-howto-deploy-azure?view=azure-bot-service-4.0"),
            }
        };

        var response = MessageFactory.Attachment(card.ToAttachment());
        await turnContext.SendActivityAsync(response, cancellationToken);
    }
}

bots/welcomeBot.js

async sendIntroCard(context) {
    const card = CardFactory.heroCard(
        'Welcome to Bot Framework!',
        'Welcome to Welcome Users bot sample! This Introduction card is a great way to introduce your Bot to the user and suggest some things to get them started. We use this opportunity to recommend a few next steps for learning more creating and deploying bots.',
        ['https://aka.ms/bf-welcome-card-image'],
        [
            {
                type: ActionTypes.OpenUrl,
                title: 'Get an overview',
                value: 'https://docs.microsoft.com/en-us/azure/bot-service/?view=azure-bot-service-4.0'
            },
            {
                type: ActionTypes.OpenUrl,
                title: 'Ask a question',
                value: 'https://stackoverflow.com/questions/tagged/botframework'
            },
            {
                type: ActionTypes.OpenUrl,
                title: 'Learn how to deploy',
                value: 'https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-howto-deploy-azure?view=azure-bot-service-4.0'
            }
        ]
    );

    await context.sendActivity({ attachments: [card] });
}

WelcomeUserBot.java

private CompletableFuture<ResourceResponse> sendIntroCard(TurnContext turnContext) {
    HeroCard card = new HeroCard();
    card.setTitle("Welcome to Bot Framework!");
    card.setText(
        "Welcome to Welcome Users bot sample! This Introduction card "
            + "is a great way to introduce your Bot to the user and suggest "
            + "some things to get them started. We use this opportunity to "
            + "recommend a few next steps for learning more creating and deploying bots."
    );

    CardImage image = new CardImage();
    image.setUrl("https://aka.ms/bf-welcome-card-image");

    card.setImages(Collections.singletonList(image));

    CardAction overviewAction = new CardAction();
    overviewAction.setType(ActionTypes.OPEN_URL);
    overviewAction.setTitle("Get an overview");
    overviewAction.setText("Get an overview");
    overviewAction.setDisplayText("Get an overview");
    overviewAction.setValue(
        "https://docs.microsoft.com/en-us/azure/bot-service/?view=azure-bot-service-4.0"
    );

    CardAction questionAction = new CardAction();
    questionAction.setType(ActionTypes.OPEN_URL);
    questionAction.setTitle("Ask a question");
    questionAction.setText("Ask a question");
    questionAction.setDisplayText("Ask a question");
    questionAction.setValue("https://stackoverflow.com/questions/tagged/botframework");

    CardAction deployAction = new CardAction();
    deployAction.setType(ActionTypes.OPEN_URL);
    deployAction.setTitle("Learn how to deploy");
    deployAction.setText("Learn how to deploy");
    deployAction.setDisplayText("Learn how to deploy");
    deployAction.setValue(
        "https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-howto-deploy-azure?view=azure-bot-service-4.0"
    );
    card.setButtons(Arrays.asList(overviewAction, questionAction, deployAction));

    Activity response = MessageFactory.attachment(card.toAttachment());
    return turnContext.sendActivity(response);
}

bots/welcome-user-bot.py

async def __send_intro_card(self, turn_context: TurnContext):
    card = HeroCard(
        title="Welcome to Bot Framework!",
        text="Welcome to Welcome Users bot sample! This Introduction card "
        "is a great way to introduce your Bot to the user and suggest "
        "some things to get them started. We use this opportunity to "
        "recommend a few next steps for learning more creating and deploying bots.",
        images=[CardImage(url="https://aka.ms/bf-welcome-card-image")],
        buttons=[
            CardAction(
                type=ActionTypes.open_url,
                title="Get an overview",
                text="Get an overview",
                display_text="Get an overview",
                value="https://docs.microsoft.com/en-us/azure/bot-service/?view=azure-bot-service-4.0",
            ),
            CardAction(
                type=ActionTypes.open_url,
                title="Ask a question",
                text="Ask a question",
                display_text="Ask a question",
                value="https://stackoverflow.com/questions/tagged/botframework",
            ),
            CardAction(
                type=ActionTypes.open_url,
                title="Learn how to deploy",
                text="Learn how to deploy",
                display_text="Learn how to deploy",
                value="https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-howto-deploy-azure?view=azure-bot-service-4.0",
            ),
        ],
    )

    return await turn_context.send_activity(
        MessageFactory.attachment(CardFactory.hero_card(card))
    )

測試聊天機器人

下載並安裝最新的 Bot Framework 模擬器

在本機電腦上執行範例。如果您需要指示，請參閱 README C# 範例或 JavaScript 範例的檔案。
開啟模擬器以測試 Bot。
1. 當您開始與 Bot 交談時，它會傳送一系列歡迎訊息。
2. 當您第一次傳送「hello」訊息時，Bot 會以一些建議回復。
3. 當您傳送後續的「hello」訊息時，Bot 會回復「您好」。
4. 將「說明」訊息傳送至 Bot。它會傳送主圖卡片來回應。

其他資源

深入瞭解將媒體新增至訊息中的各種媒體回應。

下一步

收集用戶輸入

共用方式為

傳送歡迎訊息給使用者

必要條件

關於此範例程序代碼

建立用戶狀態

建立屬性存取子

偵測並問候新連線的使用者

歡迎新用戶並捨棄初始輸入

處理其他輸入

使用主圖卡片問候語

測試聊天機器人

其他資源

下一步

其他資源