Action
    • PDF

    Action

    • PDF

    記事の要約

    Classic/VPC環境で利用できます。

    チャットボット返答のレスポンスコンポーネントのうち、アクション(Action)について説明します。アクションはすべてのコンポーネント(構成要素)の共通データで、コンポーネントをクリックすると実行する作業を定義します。

    アクション(Action)は、次の5つの基本コンポーネントで構成されます。

    上記のコンポーネントはそれぞれの特徴に合わせてチャットボットのレスポンスをチャットボットビルダで設定することができ、チャットボットビルダで設定したレスポンス結果を JSON形式で返します。

    Postbackコンポーネント

    Postbackコンポーネントはテキスト(postbackText)をチャットボットにポストバックし、ポストバックテキストをユーザーのチャットに表示します。

    Postbackコンポーネントのレスポンスボディ

    Postbackコンポーネントのレスポンスボディは次の通りです。

    フィールドタイプ必須の有無説明
    typeStringRequiredコンポーネントのタイプ
    • Postbackコンポーネントの場合、postbackのみ使用可能
    dataObjectRequiredポストバックコンポーネントの構成情報
    data.postbackStringRequiredユーザーのチャットに表示されるテキスト
    • チャットボットに送信時、既存の機能には影響しないが、一部の新機能をサポートしない場合がある
    data.postbackFullStringRequiredチャットボットに送る全ポストバックテキスト

    Postbackコンポーネントのレスポンス例

    Postbackコンポーネントのレスポンスのサンプルコードは次の通りです。

    {
        "action": 
        {
            "type": "postback",
            "data": 
            {
                "postback": "Button Name",
                "postbackFull": "_T_Button Name" 
             }
        }
    }
    

    Utteranceコンポーネント

    Utteranceコンポーネントはテキスト(postbackText)をチャットボットにポストバックし、発話テキストをユーザーのチャットに表示します。

    Utteranceコンポーネントのレスポンスボディ

    Utteranceコンポーネントのレスポンスボディは次の通りです。

    フィールドタイプ必須の有無説明
    typeStringRequiredコンポーネントのタイプ
    • Utteranceコンポーネントの場合、utteranceのみ使用可能
    dataObjectRequired発話(Utterance)コンポーネントの構成情報
    data.utteranceIdIntegerRequired発話 ID
    data.textStringRequiredユーザーの入力によりチャット画面に表示されるテキスト
    data.postbackStringRequiredチャットボットに送るポストバックテキスト

    Utteranceコンポーネントのレスポンス例

    Utteranceコンポーネントのレスポンスのサンプルコードは次の通りです。

    {
        "type": "utterance",
        "data" : 
        {
            "utteranceId" : 1,
            "text" : "text show in chat window",
            "postback" : "postback text"
        }
    }
    

    Linkコンポーネントは、コンポーネントをクリックするとその URLに移動します。

    Linkコンポーネントのレスポンスボディ

    Linkコンポーネントのレスポンスボディは次の通りです。

    フィールドタイプ必須の有無説明
    typeStringRequiredコンポーネントのタイプ
    • Linkコンポーネントの場合、linkのみ使用可能
    dataObjectRequiredリンク(Link)コンポーネントの構成情報
    data.urlStringRequiredURLアドレス
    data.mobileUrlStringRequiredモバイル URLアドレス

    Linkコンポーネントのレスポンス例

    Linkコンポーネントのレスポンスのサンプルコードは次の通りです。

    {
        "type": "link",
        "data" : 
        {
            "url" : "http://www.ncloud.com",
            "mobileUrl" : "http://m.ncloud.com"
        }
    }
    

    Phoneコンポーネント

    Phoneコンポーネントは、コンポーネントをクリックするとダイヤルページに移動します。

    参考

    Phoneコンポーネントはモバイル環境でのみサポートします。

    Phoneコンポーネントのレスポンスボディ

    Phoneコンポーネントのレスポンスボディは次の通りです。

    フィールドタイプ必須の有無説明
    typeStringRequiredコンポーネントのタイプ
    • Phoneコンポーネントの場合、phoneのみ使用可能
    dataObjectRequired電話(Phone)コンポーネントの構成情報
    data.numberStringRequired電話番号
    data.nameStringOptional電話帳に登録されている名前

    Phoneコンポーネントのレスポンス例

    Phoneコンポーネントのレスポンスのサンプルコードは次の通りです。

    {
        "type": "phone",
        "data" :   
        { 
            "number" : "400-1111-1111", 
            "name" : "Customer service" 
        }
    }
    

    Welcomeコンポーネント

    Welcomeコンポーネントは、コンポーネントをクリックするとオープンイベント(Open Event)を送信します。

    Welcomeコンポーネントのレスポンスボディ

    Welcomeコンポーネントのレスポンスボディは次の通りです。

    フィールドタイプ必須の有無説明
    typeStringRequiredコンポーネントのタイプ
    • Welcomeコンポーネントの場合、welcomeのみ使用可能
    dataObjectRequiredウェルカム(Welcome)コンポーネントの構成情報
    data.postbackStringRequiredオープンイベント(Open Event)からチャットボットに送信されたポストバックテキスト

    Welcomeコンポーネントのレスポンス例

    Welcomeコンポーネントのレスポンスのサンプルコードは次の通りです。

    { 
        "type": "welcome", 
        "data" : 
        { 
            "postback" : "postback text, optional" 
        } 
    }
    

    この記事は役に立ちましたか?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.