メインコンテンツへスキップ

​
概要

TwilioツールはTwilioの通信プラットフォームを通じてメッセージや通話の送受信を可能にします。SMS、メディア付きMMS、WhatsAppメッセージング、音声通話をサポートします。

​
主な機能

​
アウトバウンド通信

  • TWILIO_SEND_SMS
    • 任意の電話番号にSMSテキストメッセージを送信
  • TWILIO_SEND_WHATSAPP
    • Twilio API for WhatsApp Business経由でWhatsAppメッセージを送信

​
認証

全てのツールはTwilio認証情報が必要です： 認証情報は以下の方法で提供できます：
  1. 環境変数：TWILIO_ACCOUNT_SIDとTWILIO_AUTH_TOKEN
  2. ツール設定パラメータ
  3. JinbaFlowシークレットマネージャー

​
セットアップ

​
1. Twilioアカウント取得

  1. Twilioでサインアップ
  2. アカウントと電話番号を認証
  3. TwilioコンソールからAccount SIDとAuth Tokenを取得
    • Auth Tokenはデフォルトで非表示になっているため、「Show」をクリックして表示します

​
2. 電話番号取得

はじめてTwilioを使用する場合は、コンソールから Get a Trial Numberをクリックし、トライアル番号を取得することができます。 この番号はSMSの送受信が可能な番号が表示されます。 WhatsAppの場合は、テスト用にTwilioサンドボックスに参加します。 トライアルアカウントの制限:
  • 取得できる電話番号は1つのみ
  • 送信先は認証済み電話番号のみ
    • 重要: Twilioの仮想番号（例: +18777804236）は認証できません
    • ご自身の実際の電話番号を認証する必要があります
  • 1日あたり最大50件のメッセージ送信制限
  • すべてのメッセージに「Sent from your Twilio trial account」のサインが追加されます

​
使用例

注意: 以下の例はトライアルアカウントでテスト可能です。

​
受信（Webhook）

Twilioの受信はWebhookで行われます。Twilioの番号設定で受信用URLを登録します。
  • 受信用エンドポイント: POST /api/v2/external/flows/:flowId/twilio-run
  • Twilioはデフォルトで application/x-www-form-urlencoded を送信します
  • TwiML応答が求められるため、JinbaFlow側は空の <Response></Response> を返します

​
例5: SMS受信（Webhook）

- id: receive_sms
  tool: INPUT_TWILIO_SMS
  config:
    - name: validate_signature
      value: false
  input: []

​
例1: SMS送信

- id: send_sms
  tool: TWILIO_SEND_SMS
  config:
    - name: account_sid
      value: "{{secrets.TWILIO.account_sid}}"
    - name: auth_token
      value: "{{secrets.TWILIO.auth_token}}"
  input:
    - name: to
      value: "+819012345678"
    - name: from
      value: "+15017122661"
    - name: body
      value: "JinbaFlowからこんにちは！"

​
例3: WhatsAppメッセージ送信

- id: send_whatsapp
  tool: TWILIO_SEND_WHATSAPP
  config:
    - name: account_sid
      value: "{{secrets.TWILIO.account_sid}}"
    - name: auth_token
      value: "{{secrets.TWILIO.auth_token}}"
  input:
    - name: to
      value: "+819012345678"
    - name: from
      value: "+14155238886"  # Twilio WhatsApp番号
    - name: body
      value: "WhatsApp経由でこんにちは！"

​
電話番号フォーマット

全ての電話番号はE.164形式である必要があります：
  • 国コードを+プレフィックスで含める
  • スペース、ダッシュ、括弧なし
  • 例：
    • アメリカ: +15551234567
    • 日本: +819012345678
    • イギリス: +447911123456

​
メディアサポート（MMS/WhatsApp）

サポートされるメディアタイプ：
  • 画像: JPEG, PNG, GIF
  • 動画: MP4
  • ドキュメント: PDF
1メッセージあたり最大10個のメディアURL。

​
リソース