傳送歡迎訊息給使用者

適用于： SDK v4

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

注意

Bot Framework JavaScript、C# 和 Python SDK 將會繼續受到支援，不過，JAVA SDK 即將淘汰，最終長期支援將于 2023 年 11 月結束。 只會執行此存放庫中的重要安全性和錯誤修正。

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

針對新的 Bot 建置，請考慮使用 Power Virtual Agents ，並閱讀 選擇正確的聊天機器人解決方案 。

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

必要條件

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

關於此範例程式碼

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

C#

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

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

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

JavaScript

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

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

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

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

Java

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

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

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

Python

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

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

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

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

建立使用者狀態

C#

使用者狀態物件會在啟動時建立，並將相依性插入 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;
}

JavaScript

啟動時，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');

Java

使用者狀態物件會在啟動時建立，並透過 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;
}

Python

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

app.py

# Create the Bot
BOT = WelcomeUserBot(USER_STATE)


# Listen for incoming requests on /api/messages.

建立屬性存取子

C#

我們現在會建立屬性存取子，提供我們在 方法內的 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);
}

JavaScript

我們現在建立屬性存取子，提供我們歡迎的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);
}

Java

我們現在會建立屬性存取子，提供我們在 方法內的 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));

Python

此範例會在 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)

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

C#

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

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

此 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();
});

Java

在 WelcomeUserBot 中，我們會使用 onMembersAdded() 檢查活動更新，以查看是否已將新使用者新增至交談，然後傳送一組三個初始歡迎訊息 WELCOME_MESSAGE 和 INFO_MESSAGEPATTERN_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);
}

Python

檢查 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)

歡迎新使用者並捨棄初始輸入

C#

當您的使用者輸入實際上可能包含有用的資訊時，也請務必考慮，這可能會因每個通道而有所不同。 為了確保您的使用者在所有可能通道上都有良好的體驗，我們會檢查狀態旗標 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);
}

JavaScript

當您的使用者輸入實際上可能包含有用的資訊時，也請務必考慮，這可能會因每個通道而有所不同。 為了確保您的使用者在所有可能通道上都有良好的體驗，我們會檢查 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();
});

Java

請務必考慮使用者輸入何時可能包含有用的資訊，而每個通道可能會有所不同。 為了確保您的使用者在所有可能通道上都有良好的體驗，我們會檢查狀態旗標 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))                

Python

當使用者的輸入可能實際包含實用資訊時，也請務必考慮，這可能會因每個通道而有所不同。 若要確保使用者在所有可能的通道上都有良好的體驗， 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 會根據該使用者輸入的內容提供回應。 下列程式碼顯示用來產生該回應的決策邏輯。

C#

「簡介」或「說明」的輸入會呼叫 函 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;
    }
}

JavaScript

「簡介」或「說明」的輸入會使用 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`);
}

Java

「簡介」或「說明」的輸入會呼叫 函 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);
}

Python

使用者 輸入簡介 或 說明 會導致 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 主圖卡片回應所需的程式碼。

C#

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);
    }
}

JavaScript

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] });
}

Java

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);
}

Python

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 模擬器

1. 在本機電腦上執行範例。 如果您需要指示，請參閱 README C# 範例或 JavaScript 範例 的 檔案。
2. 開啟模擬器以測試 Bot。

   1. 當您開始與 Bot 交談時，它會傳送一系列歡迎訊息。

   2. 當您第一次傳送 「hello」 訊息時，Bot 會以一些建議回復。

   3. 當您傳送後續的 「hello」 訊息時，Bot 會回復「您好」。

      

   4. 將「說明」訊息傳送至 Bot。 它會傳送主圖卡片來回應。

      

其他資源

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

下一步

收集使用者輸入