Twilioコネクタ構成ガイド

コネクタのアクション

アクション名	AudienceStream	EventStream
SMSまたはMMSを送信	✓	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタの概要を参照してください。

コネクタを追加した後、以下の構成を構成します：

• アカウントSID（ユーザー名）

  • REST APIへのHTTPリクエストはHTTP Basic認証で保護されています。
  • HTTP Basic認証のユーザー名とパスワードとして、TwilioアカウントのSIDと認証トークンを使用します。
  • 詳細については、SMS API: Messagingを参照してください。

• 認証トークン（パスワード）

  • REST APIへのHTTPリクエストはHTTP Basic認証で保護されています。
  • HTTP Basic認証のユーザー名とパスワードとして、TwilioアカウントのSIDと認証トークンを使用します。
  • 詳細については、SMS API: Messagingを参照してください。

アクション構成 - パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここでコネクタのアクションを構成します。

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション - SMSまたはMMSを送信

パラメータ

パラメータ	説明
アカウントSID	コンソールでアカウントSIDを見つけることができます。 このエンドポイントについての詳細は、Sending Messagesを参照してください。
To	宛先の電話番号。 プラス記号(+)と国コードを含む(E.164形式)。 例：+16175551212
From	Twilioの電話番号（E.164形式）または、送信したいメッセージのタイプに対応した英数字の送信者ID。 Twilioから購入した電話番号またはショートコードがここで機能します。 自分の携帯電話番号からメッセージを「偽装」することはできません。 メッセージのFrom電話番号または送信者IDを決定するために、以下のパラメータの少なくとも1つをPOSTする必要があります：From、Messaging Service SID

| |Messaging Service SID|

• このメッセージに関連付けたいMessaging Serviceの34文字の一意のID。
• このパラメータを構成すると、構成したMessaging Service SettingsとCopilot Featuresが使用されます。
• このパラメータのみが構成されている場合、Twilioは有効なCopilot機能を使用して配信用の**From**電話番号を選択します。

  メッセージのFrom電話番号または送信者IDを決定するために、以下のパラメータの少なくとも1つをPOSTする必要があります：From、Messaging Service SID

| |Body|

• 送信したいメッセージのテキスト。最大1600文字まで。

  メッセージの内容のために、以下のパラメータの少なくとも1つをPOSTする必要があります：Body、MediaUrl

| |Media URL|

• メッセージと一緒に送信したいメディアのURL。
• GIF、PNG、JPEGのコンテンツは現在サポートされており、受信者のデバイスで正しくフォーマットされます。
• 他のファイルタイプもAPIによって受け入れられます。
• メディアのサイズ制限は5メガバイト（MB）です。
• メッセージ本文に複数の画像を送信するには、POSTリクエストに複数の`MediaUrls`値を提供します。
• メッセージごとに最大10の`MediaUrls`を含めることができます

  メッセージの内容のために、以下のパラメータの少なくとも1つをPOSTする必要があります：Body、MediaUrl

| |Status Callback|

• メッセージのステータスが以下のいずれかに変更するたびにTwilioがPOSTするURL：
  • `queued`
  • `failed`
  • `sent`
  • `delivered`
  • `undelivered`
• Twilioは`MessageSid`と他の標準的なリクエストパラメータ、および`MessageStatus`と`ErrorCode`をPOSTします。
• このパラメータが`MessagingServiceSid`と一緒に渡されると、TwilioはMessaging ServiceのStatus Callback URLを上書きします。
• URLには有効なホスト名が含まれている必要があります。
• ホスト名にアンダースコア文字(`_`)は許可されていません。

| |Application SID|

• Twilioは`MessageSid`および`MessageStatus=sent`または`MessageStatus=failed`をこのアプリケーションの`MessageStatusCallback`プロパティのURLにPOSTします。
• 上記の`StatusCallback`パラメータも渡される場合、アプリケーションの`MessageStatusCallback`パラメータが優先されます。

| |Max Price|

• メッセージが配信されるための最大合計価格（米ドルで`0.0001`まで）。
• すべてのメッセージは配信待ちの状態でキューに入れられます。
• 後で`Sent`または`Failed`のステータス変更とともにStatus Callback URLにPOSTリクエストが行われます。
• メッセージの価格がこの値を超えると、メッセージは失敗し、送信されません。
• `MaxPrice`が構成されていない場合、メッセージのすべての価格が受け入れられます。

| |Provide Feedback|

• トラッキング可能なユーザーアクションを持つメッセージを送信していて、Message Feedback APIを使用してメッセージの配信を確認するつもりであれば、この値を`true`に構成します。
• このパラメータはデフォルトで`false`に構成されています

| |Validity Period|

• メッセージがTwilioのキューに残ることができる秒数。
• この時間制限を超えると、メッセージは失敗し、後でStatus Callback URLにPOSTリクエストが行われます。
• 有効な値は`1`から`14400`秒（デフォルト）です。
• Twilioは、キャリアがメッセージを受け入れた後にメッセージがキューに入れられないことを保証できません。
• 5秒未満の有効期間を構成することはお勧めしません

|