通知アクションのアイテム「変数」とは?

通知アクションのアイテムの一つである「変数」を使うと、動的に変更される情報を音声・メールで通知することができます。

変数には、ユーザが自由に定義する「ユーザ変数」と、Symphony Callサービス側が提供する「システム変数」があります。
変数アイテムで定義したものがユーザ変数となり、メール連携での通知実行時、API経由での通知実行時にも、ユーザ変数を
指定できます。

また、ユーザ変数、システム変数ともに、大文字・小文字を区別しますので、変数定義時、参照時には気を付けてください。

通知アクションのアイテム「変数」とは? システム変数はSymphony Callサービスが提供する変数で、「SYS_CALL_END」以外の変数については、書き込み
不可で参照のみとなります。
システム変数には、以下のようなものがあります。
発信元の電話番号 発信先の電話番号 現在日付(処理が実行された時の日付/年月日) 例:2016年4月20日 現在の年の数値(処理が実行された時の年) 現在の月の数値(処理が実行された時の月) 例:4 現在の日の数値(処理が実行された時の日) 現在の時間(処理が実行された時の時間/時分秒) 例:20時30分40秒 現在の時間の数値(処理が実行された時の時間) 現在の分の数値(処理が実行された時の分) 現在の秒の数値(処理が実行された時の秒) 現在の曜日(処理が実行された時の曜日)
音声とメールの場合の置き換えは、「月曜日」などの日本語の形式、
条件分岐での変数比較時の置き換えは、曜日を指す以下の数値
0:日 1:月 2:火 3:水 4:木 5:金 6:土
通話を開始した日時(年月日 時分) 例:2016年4月20日 20時30分 通話時間(秒)の数値
通話が開始されてから現在までの通話時間(処理が実行された時までの時間)
通知完了扱い(通知リトライを行わない)とするかどうかを設定する
(1:通知完了 0:通知未完了)
本変数は、書き込み可能とする
通知先グループを指定して通知を行った場合の通知先グループ名
電話通知の方法
音声とメールの場合の置き換えは、「同時」「順次」のいずれか
条件分岐での変数比較時の置き換えは、通知方法を指す以下の数値
0:同時 1:順次
電話通知の種別
通知アクションを用いた電話通知の場合は通知アクションの内容に依存
するため、本変数の値としては「音声のみ」の扱いとなる
音声とメールの場合の置き換えは、「メールと音声」「音声のみ」
「メールのみ」のいずれか
条件分岐での変数比較時の置き換えは、通知の種別を指す以下の値
all:メールと音声 sound:音声のみ mail:メールのみ
通知予定の日時(年月日時分)
音声とメールの場合は、YYYY年MM月DD日hh時mm分のフォーマットで、
条件分岐での変数比較時の置き換えは、YYYYMMDDhhmmのフォーマット
条件分岐の場合の置き換え例)201604201530
通知アクションを使用しない通知の場合の、冒頭メッセージの指定内容
通知アクションを使用しない通知の場合の、通知メッセージの指定内容
通話終了時のURLコールが指定された場合のURLの内容
通話終了時のURLコールは、メール連携時の通知実行時、API経由の通知
実行時に指定可能
通知アクションを用いた電話通知の場合の通知アクション名
メール連携を用いた電話通知の場合のメール連携用メールの本文の内容
ユーザ変数は、ユーザが自由に定義できる変数です。
通知アクションの「変数」のアイテム、もしくは、メール連携のパラメータ、APIのパラメータで定義します。
【通知アクション 「変数」アイテム設定画面】
下図の画面で設定した変数が「ユーザ変数」となります。
下図の例では、「TEST_VARIABLE」が変数名、「10」が変数に割り当てる値となります。
【メール連携用のメールサンプル】
「SYS_xxx」のように、「SYS_」が付かないパラメータが「ユーザ変数」として扱われます。
下記のメール連携用のメールサンプルでは、①部のものが「ユーザ変数」となります。
SYS_API_PASSWORD=jNnFxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
SYS_GROUP=まほろば工房テストグループ
SYS_CALL_SEQUENCE=sequence
SYS_NOTICE_TYPE=all
SYS_SCHEDULED_TIME=
SYS_FLOW=メール設定テスト
PARAMETER1=パラメータ1
MESSAGE1=メッセージ1
MESSAGE2=メッセージ2

メール本文 です。
おつかれさまです。お世話になっています。

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-
株式会社まほろば工房
Symphony Callサポートセンター
TEL:050-5810-3003 (受付時間 9時~18時:土・日・祝日は除く)
お問い合せフォーム:http://www.ate-mahoroba.jp/contactus.html
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--=-=-=-=-
【APIコールのサンプル】
「sys_xxx」のように、「sys_」が付かないパラメータが「ユーザ変数」として扱われます。
下記のAPIコールのサンプルでは、「test_variable」が「ユーザ変数」となります。
     ・
     ・
     ・
CALL_SEQUENCE="broadcast"
NOTICE_TYPE="all"
FLOW="通知アクション1"
TEST_VARIABLE="テスト変数"
MAIL_SUBJECT="メール件名"
MAIL_MESSAGE="メール本文"
SCHEDULED_TIME="2015-08-31 09:00"
NOTICEGROUP_NAME="サンプル通知先グループ名"
CALLBACK_URL="http://xxxxxxxxxxxx"
CALLBACK_URLTYPE="get"

#----------------------------------------------------------------
# 即時実行APIをコール
#----------------------------------------------------------------
RET=`wget -q -O - "$BASEURL/exe/group_execute.json" --post-data
"sys_token=$CHG_TOKEN&sys_api_password=$APIPASS&sys_call_sequence=$CALL_SEQUENCE
&sys_notice_type=$NOTICE_TYPE&sys_flow=$FLOW&sys_mail_subject=$MAIL_SUBJECT
&sys_mail_message=$MAIL_MESSAGE&sys_scheduled_time=$SCHEDULED_TIME
&sys_noticegroup_name=$NOTICEGROUP_NAME&sys_callback_url=$CALLBACK_URL
&sys_callback_urltype=$CALLBACK_URLTYPE&test_variable=$TEST_VARIABLE"`
echo $RET