新しいSMS着信(トリガー)
このピースでできること
- Twilioの指定電話番号に新しい着信SMSがあったときに、ワークフローを起動します。
- 英語名:New Incoming SMS。
Twilio の接続方法
以下の2つを入力して接続します。
Account SID
Twilio アカウントの識別子です。
- Twilio コンソール にログインします
- ダッシュボードのトップページに表示される 「Account SID」 をコピーします
Auth Token
- 同じくダッシュボードの 「Auth Token」 の横にある表示アイコンをクリックします
- 表示されたトークンをコピーし、接続画面の 「Auth token」 欄に貼り付けます
Auth Token は秘密情報です。第三者と共有しないよう注意してください。
ピースの設定項目
1. 電話番号(必須)
- 受信を監視するTwilioの電話番号を指定します。
- Twilioアカウントに登録済みの電話番号からドロップダウンで選択します。
取得できる情報
指定したTwilio電話番号に届いたメッセージ情報を、着信メッセージ1件ずつ取得できます。
- / :メッセージSID・本文。
- / / :送信元・宛先・方向。対象は です。
- / / / :状態・作成/送信/更新日時。未確定の値はnullになる場合もあります。
- / :メディア数・分割数。数字が文字列で返る場合があります。
- / / / など:エラー・料金・通貨。応答に含まれる場合のみ利用でき、nullになる場合もあります。
取得条件と注意点
- 設定の「電話番号」で選んだ番号を宛先()として検索します。出力の はメッセージの送信元であり、設定で選ぶ受信先の番号とは異なります。
- 有効化時に最新のメッセージSIDを記録し、その後は前回記録したSIDに達するまでページ送りして、 のメッセージを返します。
- 状態が であることだけを条件にした処理ではありません。必要に応じて取得時点の を確認してください。
- テストではあらかじめ用意されたサンプルを返します。実際の着信SMSを検索して接続・受信を確認するテストではありません。
- 出力はAPIの各メッセージです。メディア本体を自動で追加取得する処理はありません。メディアを含む場合も、同じ取得条件で判定されます。
利用例
を後続の通知本文に、 を送信者の記録や返信先の指定に利用できます。
出力例(抜粋)
キーの使い方を示す架空例です。