Twilio コネクタ - Mule 4

サポートカテゴリ: 選択

Twilio コネクタ v3.0

Twilio 用 Anypoint コネクタ (Twilio コネクタ) は、クラウド通信 IaaS (Infrastructure as a Service) です。

Twilio プラットフォームは、テキストメッセージング、VoIP、および音声通話を行うための API として機能します。Twilio コネクタは、Twilio テキストメッセージング API との接続を可能にします。

このコネクタは、テキストメッセージの送受信用の API を提供します。Twilio を使い始めるには、下記の手順に従って、SMS テキストメッセージを送信するための無料の Sandbox サービスにアクセスしてください。Anypoint Studio では、自分の API ログイン情報を使用して Twilio コネクタを設定できます。

リリースノート: ​Twilio Connector Release Notes - Mule 4
Exchange: Twilio コネクタ

前提条件

この情報を使用するには、Twilio、Mule Runtime Engine (Mule)、Anypoint コネクタ、Anypoint Studio、Mule の概念、Mule フローの要素、グローバル要素に精通している必要があります。

対象リソースへの接続をテストするには、ログイン情報が必要です。

ソフトウェアの要件および互換性情報については、「コネクタリリースノート」を参照してください。

Twilio コネクタを使用するには、アクティブな Twilio.com アカウント (トライアル版または有料版) が必要です。Twilio アカウントを作成するには、Try Twilio (Twilio を試す) の Web サイト (https://www.twilio.com/try-twilio​) にアクセスします。

POM ファイル情報

<dependency>
  <groupId>com.mulesoft.connectors</groupId>
  <artifactId>mule-twilio-connector</artifactId>
  <version>RELEASE</version>
  <classifier>mule-plugin</classifier>
</dependency>

Mule は、RELEASE を現在のバージョンに変換します。バージョンを指定するには、Anypoint Exchange を参照して [Dependency Snippets (連動関係スニペット)]​ をクリックします。

新しい Twilio アカウントの作成

  1. Try Twilio (Twilio を試す) の Web サイト (https://www.twilio.com/try-twilio​) にアクセスします。

  2. サインアップして [Start your free trial (無料トライアルを開始)] をクリックします。

    無料の開発者アカウントでは、テキストメッセージを送信するための SMS に対応したスマートフォンでの確認が必要です。

  3. スマートフォンの電話番号を入力するにように促されたら、入力します。指示に従って電話番号を確認します。自動テキストメッセージと認証コードが送られて来ます。

  4. 認証コードを入力すると、Twilio のメイン画面が表示されます。

  5. [Account SID (アカウント SID)] と [Auth Token (認証トークン)] の値 ([Show (表示)] をクリックすると表示されます) をメモし、ログイン情報を後で Anypoint Studio の Twilio コネクタ設定メニューで使用するためにコピーしておきます。

    ヒント: Twilio の Web サイトから Anypoint Studio コネクタ設定に項目をコピーする際には、前後にある余計な文字やスペースも一緒にコピーしてしまわないように注意してください。コピーして貼り付ける際に、前後の文字が含まれていないことを目で確認するのがよいでしょう。

  6. 左上にある [B] をクリックし、[Phone Numbers (電話番号)] > [Manage Numbers (番号の管理)] をクリックします。

  7. [Get Started (使用開始)] をクリックします。

  8. [Get your first Twilio phone number (最初の Twilio 電話番号を取得)] をクリックします。Twilio が選択した電話番号が表示されます。この番号は後で使用しますので、コピーしておきます。

Design Center での接続

  1. Design Center で [Create (作成)] をクリックして [Mule Application (Mule アプリケーション)] を選択します。

  2. HTTP リスナやスケジューラトリガなどのトリガをクリックします。

    トリガオプション
  3. コネクタの HTTP グローバル要素を作成するには、次の項目を設定します。

    HTTP リスナの設定
    項目 説明

    Protocol (プロトコル)

    HTTP コネクタのプロトコル。HTTP または HTTPS (セキュア) を選択できます。

    Host (ホスト)

    Mule アプリケーションが要求をリスンする IP アドレス。

    Port (ポート)

    Mule アプリケーションが要求をリスンするポートアドレス。

    Base Path (ベースパス)

    Mule アプリケーションが要求をリスンするパス。

  4. プラス記号を選択して、コンポーネントを追加します。

    コネクタの追加
  5. Twilio コネクタをコンポーネントとして選択します。

  6. 操作を選択します。

    操作コネクタ
  7. コネクタのグローバル要素を設定します。

    コネクタの設定
    項目 説明

    Protocol (プロトコル)

    HTTP コネクタのプロトコル。HTTP または HTTPS (セキュア) を選択できます。

    Host (ホスト)

    Mule アプリケーションが要求をリスンする IP アドレス。

    Port (ポート)

    Mule アプリケーションが要求をリスンするポートアドレス。

    Base Path (ベースパス)

    Mule アプリケーションが要求をリスンするパス。

    Username (ユーザ名)

    Twilio API にアクセスするためのユーザ名 (アカウント SID)。

    Password (パスワード)

    Twilio API にアクセスするためのパスワード (認証トークン)。

Studio プロジェクトへのコネクタの追加

Anypoint Studio には、Studio プロジェクトにコネクタを追加する 2 つの方法があります。Studio タスクバーの Exchange ボタンから追加するか、[Mule Palette (Mule パレット)] ビューから追加します。

Exchange を使用してコネクタを追加する

  1. Studio で Mule プロジェクトを作成します。

  2. Studio タスクバーの左上にある Exchange アイコン (X)​ をクリックします。

  3. Exchange で、[Login (ログイン)]​ をクリックし、Anypoint Platform のユーザ名とパスワードを指定します。

  4. Exchange で、「twilio」を検索します。

  5. コネクタを選択して [Add to project (プロジェクトに追加)]​ をクリックします。

  6. 画面の指示に従ってコネクタをインストールします。

Studio でコネクタに追加する

  1. Studio で Mule プロジェクトを作成します。

  2. [Mule Palette (Mule パレット)] ビューで、[(X) Search in Exchange ((X) Exchange 内を検索)]​ をクリックします。

  3. [Add Modules to Project (モジュールをプロジェクトに追加)]​ で、検索項目に「twilio」と入力します。

  4. [Available modules (使用可能なモジュール)]​ で、このコネクタの名前をクリックします。

  5. [Add (追加)]​ をクリックします。

  6. [Finish (完了)]​ をクリックします。

Studio で設定する

  1. コネクタを Studio キャンバスにドラッグします。

  2. コネクタのグローバル要素を設定します。

    項目 説明

    Protocol (プロトコル)

    HTTP コネクタのプロトコル。HTTP または HTTPS (セキュア) を選択できます。

    Host (ホスト)

    Mule アプリケーションが要求をリスンする IP アドレス。

    Port (ポート)

    Mule アプリケーションが要求をリスンするポートアドレス。

    Base Path (ベースパス)

    Mule アプリケーションが要求をリスンするパス。

    Username (ユーザ名)

    Twilio API にアクセスするためのユーザ名 (アカウント SID)。

    Password (パスワード)

    Twilio API にアクセスするためのパスワード (認証トークン)。

  3. 操作を選択します。

    • Delete Media

    • Delete Message

    • Get Media

    • Get Media List

    • Get Message

    • Get Message List

    • Redact Message

    • Send Message

これらの項目では操作を指定できます。

項目 説明

Account Sid (アカウント SID)

このメッセージを送信したアカウントの一意の ID

Date Created (作成日付)

リソースが作成された日付

Media Sid (メディア SID)

メディアの一意の ID

Message Sid (メッセージ SID)

メッセージの送信後に生成されたメッセージの一意の ID

Date Sent (送信日付)

メッセージが Twilio から送信された日付 (RFC 2822 形式)

From (送信元)

メッセージを送信した電話番号または送信者 ID (E.164 形式)

To (宛先)

メッセージを受信した電話番号 (E.164 形式)

各形式についての詳細は、このドキュメントの最後にある「関連情報」セクションを参照してください。

ユースケース: Studio

次の例では、Mule アプリケーションから特定の電話番号にメッセージを送信してから編集しています。

この例では、項目値に変数を使用しています。プロパティファイルを使用して、各変数に実際の値を入力できます。/src/main/resources​ にファイルを配置し、タグ <configuration-properties>​ を使用してファイルを参照します。詳細は、「プロパティファイル」​を参照してください。

  1. 新しい Mule アプリケーションを作成し、プロパティファイルに次のプロパティを追加します。

    プロパティ 説明

    accountSid

    アカウント SID

    authToken

    認証トークン

    fromNumber

    SMS を送信する電話番号。これは Twilio インスタンス内で設定します。

  2. 空白のフローを追加して、フローのインバウンド部分に HTTP コネクタをドラッグし、そのパスを /send/{toNumber}​ に設定します。

  3. Transform Message コンポーネントをフローにドラッグして、Twilio コネクタ用の入力を準備します。

    %dw 2.0
    output application/java
    ---
    {
        Body: "You are now subscribed!",
        From: "${fromNumber}",
        To: "+" ++ attributes.uriParams.toNumber default "my default value"
    }
  4. Transform Message コンポーネントの後に Twilio コネクタを追加して、次の設定を適用します。

    • Send Message 操作を選択します。

    • [Account Sid (アカウント SID)] を ${accountSid}​ に設定します。

  5. Set Variable コンポーネントをドラッグして、次のパラメータを設定します。

    • [Name (名前)] を messageSid​ に設定します。

    • [Value (値)] を「#[payload.getSid()]​」に設定します。

  6. 別の Transform Message コンポーネントを追加して、Redact Message 操作への入力を作成します。

    %dw 2.0
    output application/java
    ---
    {
        Body: "",
        From: payload.from,
        To: payload.'to'
    }
  7. Transform Message コンポーネントの後に Twilio コネクタをドラッグして、次の設定を適用します。

    • Redact Message 操作を選択します。

    • [Account Sid (アカウント SID)] を ${accountSid}​ に設定します。

    • [Message Sid (メッセージ SID)] を #[messageSid]​ (2 つ上のステップで保存した変数) に設定します。

  8. フローの最後に Transform Message コンポーネントを配置します。

  9. アプリケーションを実行し、ブラウザで http://localhost:8081/send/{toNumber}​ を開きます (toNumber​ は Twilio から受け取った電話番号に置き換えてください)。

Was this article helpful?

💙 Thanks for your feedback!