ユーザーへのウェルカムメッセージの送信

[アーティクル]
03/08/2023

この記事の対象: SDK v4

ボットを作成する主な目的は、有意義な会話によってユーザーエンゲージメントを高めることです。この目標を達成するための効果的な方法の 1 つは、ユーザーが最初にアクセスした瞬間から、ボットの主な目的と機能 (ボットが作られた理由) をユーザーがわかるようにすることです。この記事では、ボットのユーザーを歓迎するのに役立つコードサンプルを紹介します。

Note

Bot Framework JavaScript SDK、C#、Python SDK は引き続きサポートされますが、Java SDK については、最終的な長期サポートは 2023 年 11 月に終了する予定です。

Java SDK を使用して構築された既存のボットは引き続き機能します。

新しいボットを構築する場合は、Microsoft Copilot Studio の使用をご検討ください。また、適切なコパイロットソリューションの選択に関する記事もお読みください。

詳細については、「The future of bot building」をご覧ください。

前提条件

ボットの基本を理解する。
Welcome ユーザーサンプルのコピー (C# サンプル、JS サンプル、Java サンプル、または Python サンプル)。サンプルのコードは、ウェルカムメッセージの送信方法を説明するために使用されます。

このサンプルコードについて

このサンプルコードは、新しいユーザーを検出し、そのユーザーがボットに最初に接続されたときにウェルカムメッセージを表示する方法を示しています。次の図は、このボットのロジックフローです。

ボットの 2 つの主要なイベントを次に示します。

OnMembersAddedAsync: 新しいユーザーがボットに接続したときに呼び出されます。
OnMessageActivityAsync: ボットが新しいユーザー入力を受け取ったときに呼び出されます。

C# サンプルのロジックフロー図。

接続された新しいユーザーには必ず、WelcomeMessage、InfoMessage、および PatternMessage がボットから提供されます。新しいユーザー入力を受信すると、WelcomeUserState で DidBotWelcomeUser が true に設定されているかどうかが確認されます。設定されていない場合、最初のウェルカムメッセージがユーザーに返されます。

ボットの 2 つの主要なイベントを次に示します。

onMembersAdded: 新しいユーザーがボットに接続したときに呼び出されます。
onMessage: ボットが新しいユーザー入力を受け取ったときに呼び出されます。

JavaScript サンプルのロジックフロー図。

接続された新しいユーザーには必ず、welcomeMessage、infoMessage、および patternMessage がボットから提供されます。新しいユーザー入力を受信すると、welcomedUserProperty で didBotWelcomeUser が true に設定されているかどうかが確認されます。設定されていない場合、最初のウェルカムメッセージがユーザーに返されます。 DidBotWelcomeUser が true の場合は、ユーザーの入力が評価されます。ユーザー入力のコンテンツに基づいて、このボットでは次のいずれかの処理が実行されます。

ユーザーから受信したグリーティングをエコーバックします。
ボットに関する追加情報を提供するヒーローカードを表示します。
WelcomeMessage を再送信します。これには、このボットで想定される入力の説明が示されています。

ボットの 2 つの主要なイベントを次に示します。

onMembersAdded: 新しいユーザーがボットに接続したときに呼び出されます。
onMessageActivity: ボットが新しいユーザー入力を受け取ったときに呼び出されます。

Java サンプルのロジックフロー図。

接続された新しいユーザーには必ず、WELCOME_MESSAGE、INFO_MESSAGE、および PATTERN_MESSAGE がボットから提供されます。新しいユーザー入力を受信すると、WelcomeUserState で getDidBotWelcomeUser() が true に設定されているかどうかが確認されます。設定されていない場合、最初のウェルカムメッセージがユーザーに返されます。

ボットの 2 つの主要なイベントを次に示します。

on_members_added_activity: 新しいユーザーがボットに接続したときに呼び出されます。
on_message_activity: ボットが新しいユーザー入力を受け取ったときに呼び出されます。

Python サンプルのロジックフロー図。

新しいユーザーが接続されるたびに、ボットによってウェルカムメッセージ、情報メッセージ、パターンメッセージが表示されます。新しいユーザー入力を受信すると、welcome_user_state.did_welcome_user プロパティが確認されます。 true に設定されていない場合、最初のウェルカムユーザーメッセージがユーザーに返されます。 true に設定されている場合、ユーザー入力のコンテンツに基づいて、このボットでは次のいずれかの処理が実行されます。

ユーザーから受信したグリーティングをエコーバックします。
ボットに関する追加情報を提供するヒーローカードを表示します。

ユーザーの状態を作成する

ユーザー状態オブジェクトはスタートアップ時に作成され、依存関係がボットコンストラクターに挿入されます。

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

起動時に、ユーザーの状態が 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 コンテナーによってユーザー状態オブジェクトはスタートアップ時に作成され、依存関係がボットコンストラクターに挿入されます。

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

起動時に、ユーザーの状態が app.py で定義され、ボットコンストラクターによって使用されます。

app.py


# Create the Bot
BOT = WelcomeUserBot(USER_STATE)


# Listen for incoming requests on /api/messages.

プロパティアクセサーを作成する

ここで、WelcomeUserState へのハンドルを返すプロパティアクセサーを OnMessageActivityAsync メソッド内に作成します。次に、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);
}

ここでプロパティアクセサーを作成します。このアクセサーにより、userState 内で保持されている welcomedUserProperty のハンドルが提供されます。

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

ここで、WelcomeUserState へのハンドルを返すプロパティアクセサーを onMessageActivity メソッド内に作成します。次に、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));

このサンプルでは、ボットコンストラクターで、会話状態のプロパティアクセサー 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() を使用してアクティビティ更新をチェックし、会話に新しいユーザーが追加されたかどうかを確認して、そのユーザーに最初の 3 つのウェルカムメッセージ 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() を使用してアクティビティ更新をチェックし、会話に新しいユーザーが追加されたかどうかを確認して、そのユーザーに最初の 3 つのウェルカムメッセージ 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 は、新しいユーザーが追加されたかどうかを確認してから、3 つのウェルカムメッセージ ("ウェルカムメッセージ"、"情報メッセージ"、および "パターンメッセージ") を送信します。

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" の場合、最初のユーザー入力は処理されません。代わりに、ユーザーに最初のウェルカムメッセージを表示します。ブール値 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" に設定され、最初のユーザー入力は処理されません。代わりに、ユーザーに最初のウェルカムメッセージを表示します。その後、ブール値 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" の場合、最初のユーザー入力は処理されません。代わりに、ユーザーに最初のウェルカムメッセージを表示します。ブール値 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}"
    )

追加入力を処理する

新しいユーザーにウェルカムメッセージが表示されると、メッセージターンごとにユーザー入力情報が評価され、そのユーザー入力のコンテキストに基づいてボットが応答します。次のコードは、その応答の生成に使用する意思決定ロジックを示しています。

"Intro" または "help" の入力により関数 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;
    }
}

"Intro" または "help" の入力では 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`);
}

"Intro" または "help" の入力により関数 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);
}

ユーザーが intro または help を入力すると、ボットが __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)

ヒーローカードグリーティングを使用する

既に説明したように、一部のユーザー入力では、要求の応答として "ヒーローカード" が生成されます。ヒーローカードグリーティングの詳細については、概要カードの送信に関するページをご覧ください。このボットのヒーローカード応答の作成に必要なコードを次に示します。

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 Emulator をダウンロードしてインストールします

ご自身のマシンを使ってローカルでサンプルを実行します。手順が必要な場合は、README ファイル内の C# サンプルまたは JavaScript サンプルを参照してください。
エミュレーターを開いてボットをテストします。
1. ボットとの会話を開始すると、一連のウェルカムメッセージが送信されます。
2. "hello" メッセージを初めて送信すると、ボットは何らかのアドバイスで応答します。
3. もう一度 "hello" メッセージを送信すると、ボットは "You said hello" (もう hello と言っていましたよ) と応答します。
4. "help" メッセージをボットに送信します。ヒーローカードを送信して応答します。

その他のリソース

さまざまなメディアの応答の詳細については、「メッセージにメディアを追加する」を参照してください。

次のステップ

ユーザー入力の収集

次の方法で共有

ユーザーへのウェルカム メッセージの送信

前提条件

このサンプル コードについて

ユーザーの状態を作成する

プロパティ アクセサーを作成する

新しく接続されたユーザーを検出し、あいさつする

新しいユーザーにウェルカム メッセージを表示し、最初の入力を破棄する

追加入力を処理する

ヒーロー カード グリーティングを使用する

ボットのテスト

その他のリソース

次のステップ

その他のリソース

ユーザーへのウェルカムメッセージの送信

このサンプルコードについて

プロパティアクセサーを作成する

新しいユーザーにウェルカムメッセージを表示し、最初の入力を破棄する

ヒーローカードグリーティングを使用する