値を埋め込む記法

メールや webhook の通知内容にメッセージの情報など任意の値を埋め込むための記法を説明します。

アクションでの記述と、受信した webhook メッセージのリクエストボディ、実際に送信される内容の組み合わせで例示しています。

値の埋め込みの基本

フィールド名を中括弧で二重に括ることで、フィールドの値を埋め込むことができます。

アクションでの記述

値の埋め込みの基本
{{message.content.data.basic}}

受信したリクエストボディ

{
    "basic": "hello"
}

送信される内容

値の埋め込みの基本
hello

下位のフィールドの埋め込み

フィールド名をピリオド「.」で連結することで階層の下位のフィールドの値を埋め込むことができます。

アクションでの記述

下位のフィールドの埋め込み
{{message.content.data.parent.child}}

受信したリクエストボディ

{
    "parent": {
        "child": "hello"
    }
}

送信される内容

下位のフィールドの埋め込み
hello

配列の埋め込み

配列の内容を全て埋め込むことができます。

フィールド名にシャープ「#」を付けたものと、スラッシュ「/」を付けたものを記述すると、その間に値が埋め込まれます。

配列内の全ての要素が埋め込まれ、配列内の位置や範囲を指定することはできません。

アクションでの記述

配列の埋め込み
{{#message.content.data.members}}
{{name}}
{{/message.content.data.members}}

受信したリクエストボディ

{
    "members": [
        {"name": "Jean"},
        {"name": "Paul"},
        {"name": "Bel"}
    ]
}

送信される内容

配列の埋め込み
Jean
Paul
Bel

フィールドがある場合に表示する

フィールド名にシャープ「#」を付けたものと、スラッシュ「/」を付けたものを記述すると、フィールドがある場合はその間の内容が表示されます。

以下の場合は内容が表示されません。

フィールドが無い
フィールド値が null
フィールド値が false
フィールドが空の配列である

アクションでの記述

フィールドがある場合に表示する
{{#message.content.data.something}}
something がある
{{/message.content.data.something}}
{{#message.content.data.nothing}}
nothing がある
{{/message.content.data.nothing}}
{{#message.content.data.boolean}}
boolean が true
{{/message.content.data.boolean}}
{{#message.content.data.emptyList}}
emptyList が空ではない
{{/message.content.data.emptyList}}

受信したリクエストボディ

{
    "something": "value",
    "boolean": false,
    "emptyList": []
}

送信される内容

フィールドがある場合に表示する
something がある

フィールドがない場合に表示する

フィールド名にハット「^」を付けたものと、スラッシュ「/」を付けたものを記述すると、フィールドがない場合はその間の内容が表示されます。

以下の場合も内容が表示されます。

フィールド値が null
フィールド値が false
フィールドが空の配列である

フィールドがある場合は内容が表示されません。

アクションでの記述

フィールドがない場合に表示する
{{^message.content.data.something}}
something が無い
{{/message.content.data.something}}
{{^message.content.data.nothing}}
nothing が無い
{{/message.content.data.nothing}}
{{^message.content.data.boolean}}
boolean が false
{{/message.content.data.boolean}}
{{^message.content.data.emptyList}}
emptyList が空である
{{/message.content.data.emptyList}}

受信したリクエストボディ

{
    "something": "value",
    "boolean": false,
    "emptyList": []
}

送信される内容

フィールドがない場合に表示する
nothing が無い
boolean が false
emptyList が空である