Your AI Connector Docs

メディアライブラリ

メディアライブラリを使用すると、AIボットは会話中に画像、動画、GIF、ボイスメモ、PDFドキュメントを連絡先に送信できます。ファイルを一度アップロードし、ボットに送信タイミングを指定しておけば、ボットが適切なタイミングで適切なファイルを選択します。例えば、「見せてもらえますか?」という質問に対して製品写真を送信したり、価格表の全リストを求められた際にPDFのパンフレットを送信したり、メニューの案内をボイスメモで送ったりすることが可能です。

ボットが送信可能なファイルの棚のようなものだと考えてください。 何を棚に置き、いつ各アイテムを使用するかはあなたが決定します。

メディアライブラリは、デフォルトですべてのアカウントで利用可能です。


メディアライブラリを使用する理由

テキストのみの回答には限界があります。写真、短い動画、ボイスメモは、多くの場合、段落単位のテキストよりも迅速かつ説得力を持って質問に回答できます。

メディアライブラリでボットができること:

  • 連絡先から何かを見たいと尋ねられた際に製品写真を送信
  • メニュー、価格表、製品ショットを画像として共有
  • 短いデモ動画やハウツー動画を送信
  • 会話のトーンに合わせてGIFで返信
  • パーソナルで人間味のある対応としてボイスメモや音声クリップを送信
  • PDFドキュメント(パンフレット、価格表、カタログ、利用規約など)を送信

ライブラリから、ボットはあなたがアップロードして承認したファイルのみを送信します。ボットが勝手にファイルを作成したり、連絡先が貼り付けたリンクからファイルを送信したりすることはありません。独自のシステムで大規模なカタログを管理していますか?独自のツールからのファイルをご覧ください。


どこにあるか

メインサイドバーの AI Studio の下にある メディアライブラリ をクリックします。このページには、ボットが送信できるすべてのファイルが アカウント全体で表示 されます。複数の場所で使用されているファイルは1つのカードとしてまとめられています。各アイテムは1つ以上の AIエージェント に属しており、カードにそのエージェント名がリスト表示されます。上部の 表示 フィルターを使用して、すべてを表示するか、特定のエージェントのメディアのみを表示するかを選択できます。


ボットが送信内容を決定する方法

これは正しく設定するための最も重要な部分です。アップロードする各アイテムに対して、ボットがいつそれを送信すべきかを説明する短い指示を記述します。ボットはその指示を読み取り、あなたが説明した状況が発生したときにのみアイテムを送信します。

例:

項目 「ボットはいつこれを送信すべきか?」
青いドレスの写真 顧客が青いバージョンを見たい、またはどのようなものか尋ねたとき
ディナーメニュー(画像) どのような料理を提供しているか、またはメニューを見たいと尋ねられたとき
セットアップのチュートリアル(動画) 顧客がインストール方法や開始方法を尋ねたとき

指示が明確であればあるほど、ボットのタイミングは向上します。「関連があるときに送信」のような曖昧な指示よりも、「プレミアムプランの価格について顧客が尋ねたときに送信」とする方が、ボットは適切に動作します。


ボットが各ファイルの内容を認識する仕組み

ファイルをアップロードすると、プラットフォームが自動的に分析を行い、その内容の短い説明を作成します。つまり、画像や動画を「認識」したり、音声を文字起こししたりします。ボットはこれを「送信タイミング」の指示と組み合わせて使用するため、たとえあなたの説明が簡潔であっても、ファイルが何であるかといつ使用すべきかの両方を理解します。リスト内の各アイテムには、このAIによる要約(「AIの認識: …」として表示)が表示されます。

このプロセスはアップロード時に自動的に行われるため、特別な操作は不要です。明確なタイトルと指示、そしてAIによるファイル解析を組み合わせることで、ボットが適切なタイミングで適切なファイルを送信できる可能性が最大化されます。

トランスクリプトの修正

ボイスメモや音声ファイルの場合、その説明はトランスクリプト(録音内で話されている言葉)となります。これは、ボットが送信した後にチャット内のボイスメモの下に表示されるテキストでもあります。自動文字起こしでは、名前やブランド名、珍しい単語を聞き間違えることがありますが、ご自身で修正することができます。

  1. メディアライブラリ、またはエージェントのメディアタブで、項目をクリックしてエディターを開きます。
  2. トランスクリプトフィールドを探します。ここには、ファイルをアップロードした際に書き起こされたテキストが表示されています。
  3. 聞き間違えられた単語を修正し、保存をクリックします。

それ以降、ボットは修正されたテキストを読み取り、ボットが送信するすべてのボイスメモの下に修正後のテキストが表示されます。すでに送信済みのメッセージについては、送信時のテキストがそのまま保持されます。

知っておくべきこと:

  • トランスクリプトは最大300文字の短い段落として保持されます。これより長い録音は途中で切り捨てられるため、録音の内容をボットに伝える部分を残すようにしてください。
  • 画像、動画、ドキュメントにも同様のフィールドがあり、ボットがこのファイルから認識する内容と呼ばれます。自動生成された説明が間違っている場合や、重要な情報が欠けている場合は編集してください。
  • フィールドを空にすることも可能です。その場合、ボットはタイトルと「送信タイミング」の指示のみに基づいて動作します。
  • このフィールドは、既存の項目を編集する際に表示されます。新しくアップロードしたファイルには、常に自動生成されたテキストが初期設定されます。

フォローアップでのメディア利用

メディアを活用する最も効果的な場所の一つがフォローアップです。これは、以前返信があった連絡先からの反応がしばらく途絶えた際に、ボットが自動的に送信する催促メッセージのことです。短いボイスメモ、短い動画、あるいは「まだいますか?」といったクリップは、単なるテキストよりも相手の関心を再び引き出すのに非常に有効です。

これを利用するには、フォローアップの状況を説明する「いつ送信するか」という指示を記述します。例:

項目 「ボットはいつこれを送信すべきか?」
再エンゲージメント用ボイスメモ しばらく反応がなくなった相手にフォローアップする際
「まだいますか?」GIF 会話の途中で連絡先からの返信が止まった場合

そのタイミングが来ると、ボットは用意したメディアアイテムがフォローアップに適しているかを判断し、適していればそれを送信します。

特定のフォローアップで特定のファイルを送信したい場合 「送信タイミング」のメモは状況を説明するものであり、ボットはどのフォローアップ番号が実行されているかを判断しません。2回目のナッジで正確にボイスメモを送信し、3回目で価格表の画像を送信するには、代わりにエージェントの「フォローアップ」ステップでそれらのアイテムを各ステップにピン留めしてください。詳細は特定のフォローアップにメディアアイテムを添付するを参照してください。

フォローアップはメディアのみでも可能です。 アイテムがそれ単体で完結している場合(例えば、すべてを語り尽くしているボイスメモなど)、フォローアップをテキストなしのメディアのみにすることができます。これを行うには、**「これを送信する際、ボットは何と言うべきか?」**フィールドに「ボイスメモのみを送信し、テキストは不要」のように指定してください。指定がない場合、ボットはメディアと一緒に短いテキストの催促メッセージを送信します。

いくつか知っておくべき点があります:

  • これはクイックフォローアップ(初期の催促)と、より長い数日間にわたるフォローアップサイクルの両方で機能します(WhatsApp Web、Instagram、Messenger、Telegramに対応)。
  • WhatsApp Business APIでは、メディアのフォローアップは24時間ウィンドウが開いている間のみ送信可能です。それ以降は、WhatsAppの規定により事前承認済みのテンプレートのみが許可されるため、その後のフォローアップはテキストのみとなります。
  • 同じ会話ごとの送信上限が適用されるため、そのアイテムの上限を引き上げない限り、ボットがフォローアップ全体で同じファイルを繰り返して送信することはありません。

メディアを追加する方法

  1. メインサイドバーで、AI Studioをクリックします。
  2. Media Libraryをクリックします。
  3. + Add mediaボタンをクリックします。
  1. エージェントに追加で、アイテムを割り当てるエージェントにチェックを入れます。1つのアイテムを複数のエージェントに紐付けることができ、リストの検索や、最近、名前、ライブ優先での並べ替えが可能です。
  2. クリックしてデバイスからファイルを選択(画像、動画、GIF、音声、またはPDF)します。音声の場合は、音声メモを録音に切り替えて、アップロードの代わりにアプリ内で直接録音することもできます。音声を追加する場合、音声メモ(録音された音声バブル)として送信するか、通常のオーディオファイルとして送信するかを選択できます。
  3. 後でアイテムを識別できるように、短いタイトルを入力します(例:「青いドレスの写真」)。
  4. ボットがこれを送信するタイミングは?フィールドに、状況を平易な言葉で記述します。
  1. メディアを追加をクリックします。アイテムがメディアリストに表示され、紐付けたすべてのエージェントでボットがすぐに利用できるようになります。

エージェント自身のメディアタブからメディアを追加することもできます。これは同じライブラリを開くものですが、そのエージェント用に事前にフィルタリングされています。このタブはエージェントが存在した瞬間から機能します(作成したばかりのエージェントや、他から複製したエージェントも含まれます)。そこでアップロードしたファイルは、すぐにそのエージェントに所属します。

すでにアップロードしたファイルを別のエージェントで再利用したい場合 は、再度アップロードする代わりに、アイテムを開いて 割り当て をクリックし、追加するエージェントを選択してください。ファイル自体が複製されるわけではなく、同じメディアアイテムに別のエージェントを追加するだけです。

入力項目

フィールド 記入内容
ファイル ボットが送信できるようにしたい画像、動画、GIF、音声/ボイスメモ、またはPDF
タイトル 自身の参照用となる短いラベル(連絡先には表示されません)
ボットがこれを送信するタイミング このアイテムをトリガーすべき状況の明確な説明
1会話あたりの最大送信回数 ボットが同じ連絡先にこのファイルを送信できる回数。デフォルトは 1 で、ボットが同じファイルを繰り返し送信しないように設定されています。ファイルを再送信可能にする場合は、この数値を増やしてください。
送信時にボットが言うべきこと オプション。ボットがこのアイテムを送信する際の推奨メッセージ。ボットはこれをガイダンスとして使用し、文脈に合わせて自然な言い回しにします(機械的に読み上げることはありません)。ボットに判断させる場合は空欄のままにしてください。正確な言葉を指定したい場合は、「say exactly: 簡単なボイスメモをお送りします。」のように記述してください。

これらのフィールドはボットへのメモであり、連絡先へのメッセージではありません

タイトル、ボットはいつこれを送信すべきか?、および**これを送信する際、ボットは何と言うべきか?**の各フィールドは、あなたが考えやすい言語で自由に記述してください。連絡先に表示されることはありません。

ボットは常に、各連絡先に対してその連絡先の言語で書き込みを行います。そのため、あなたが中国語でメモを書き、英語を話す連絡先が会場の確認を求めた場合、ボットはあなたのメモに基づいて英語のキャプションを付けた写真を送信します。メモは、あなたにとって最も簡単な言語で記述してください。

サポートされているファイルと制限

  • 画像: JPG, PNG, GIF, WebP
  • 動画: MP4, MOV, WebM
  • 音声: MP3, OGG, WAV, M4A(ボイスメモまたは通常の音声ファイルとして送信可能)
  • ドキュメント: PDF
  • 最大サイズ: 1ファイルあたり10 MB
  • エージェントあたりの上限: 最大50アイテム

PDFをアップロードすると、プラットフォームがそのテキストを読み取るため、ボットは内容を把握できます。これは画像や音声の自動分析と同じ仕組みです。


メディアの編集と削除

  • 項目のタイトルや送信タイミングの指示を変更するには、項目をクリックして各フィールドを編集し、保存してください。(指示の編集にファイルの再アップロードは不要です。)
  • 単語の聞き間違いがあるトランスクリプトや、ファイルの内容説明を修正するには、同じエディター内で該当フィールドを編集してください。トランスクリプトの修正を参照してください。
  • 項目を削除するには、項目の削除(ゴミ箱)アイコンをクリックします。ファイルとその指示が削除され、ボットはその送信を停止します。
  • ファイル自体を置き換えるには、項目を削除してから新しい項目を追加してください。

メディアを受信できるチャネル

ほとんどのチャネルでメディアを受信できますが、一部例外があります:

チャネル メディアサポート
WhatsApp (Business & Web) 画像、動画、GIF、ボイスメモ、音声、PDFドキュメント
Facebook Messenger 画像、動画、ボイスメモ、音声、PDFドキュメント
Instagram 画像、動画、ボイスメモ
Telegram 画像、動画、音声(ボイスメモではなくファイルとして)、PDFドキュメント
LINE 画像のみ
SMS 非対応(テキストのみ)

留意点:

  • SMSはメディアを受信できません。 SMSの会話では、ボットはメディアアイテムを提示しません。
  • Instagramはドキュメントを受信できません。 Instagramの会話では、ボットはPDFを送信せず、代わりにテキストで回答します。
  • GIF はアップロード時に自動的に最適化されるため、WhatsApp上でアニメーションとして再生されます。他のチャネルでは、GIFが静止画として表示される場合があります。
  • WhatsAppの24時間ルールはメディアにも適用されます。 最後に連絡先からメッセージを受信してから時間が経過しすぎている場合、WhatsAppはメッセージ(メディアを含む)をブロックする可能性があります。連絡先から再度返信があるまで待つ必要があります。

最良の結果を得るためのヒント

  1. 「いつ送信するか」の指示は、新しいチームメンバーに説明するように記述してください。 単なるトピックではなく、「顧客がアパートの写真を見たいと尋ねたとき」のように、正確なタイミングを記述します。
  2. 1項目につき1つの目的を設定してください。 すべてを網羅しようとする1つのファイルではなく、状況ごとに個別の項目をアップロードします。
  3. ファイルは小さく、読み込みが速いものにしてください。 圧縮された画像や短いクリップの方が、巨大なファイルよりもチャットで素早く届き、見栄えも良くなります。
  4. 明確でわかりやすいタイトルを使用してください。 ライブラリが大きくなったときに、適切なタイトルがあれば、正しい項目を簡単に見つけて更新できます。
  5. 「試用(Try Out)」でテストしてください。 メディアを追加した後、エージェントの「試用」タブを使用して、公開前にボットが適切なタイミングで正しい項目を選択するか確認してください。画像、動画、音声、またはドキュメントは、テストチャット内に表示され、連絡先が実際に受け取るのとまったく同じ状態で確認できます。

古いテスト会話には「メディアのプレビューが期限切れです」と表示される場合があります。 テストチャットはサンドボックス環境であり、実際のアカウントからメッセージが送信されることはありません。メディアのプレビューは7日間閲覧可能です。後から古いテスト会話に戻った場合、期限切れのプレビューには代わりに小さな注記が表示されます。もう一度ボットに尋ねれば、新しいプレビューを確認できます。実際の会話には影響ありません。連絡先には期限切れにならない実際のファイルが送信されます。

同じものに対する複数のファイル。 ボットは通常、その瞬間に最適なアイテムを1つだけ選択するため、「ボットはいつこれを送信すべきか?」というメモが付いた写真が5枚ある場合、通常は1枚だけが送信されます。もし一連のセットが関連している場合(1つの製品のすべての写真、メニュー全体など)、エージェントの指示でその旨を伝えてください。例えば「誰かがガーデンチェアについて尋ねたら、ガーデンチェアの写真をすべて送信して」と指示し、各写真に製品名を記載したメモを付けてください。そうすれば、ボットはセット全体を1つの返信で送信します。

ボットは同じファイルをスパム送信しません。 各アイテムは、デフォルトで1会話につき最大1回送信されます。顧客が同じことを何度も尋ねてくる場合、ボットは同じ画像を何度も送るのではなく、テキストで回答します。どうしても再送可能にしたい場合は、アイテムの「1会話あたりの最大送信回数」の値を増やしてください。


独自のツールからのファイル

ライブラリにはエージェントごとに最大50個のアイテムを保持できます。製品写真、メニュー、仕様書などがすでに独自のシステム(データベース、ショップ、CRMなど)にある場合は、ここにアップロードする必要はありません。そのシステムをカスタム関数またはMCPサーバーとしてエージェントに接続し、ファイルへの直接リンクを返すようにすれば、ボットはリンクを貼り付ける代わりにファイルそのものを送信します。

仕組み:

  1. 連絡先が「オリーブオイルを見せてもらえますか?」のように何かを尋ねます。
  2. ボットがあなたのツールを呼び出し、その結果に https://yourstore.com/images/olive-oil.jpg のようなファイルリンクが含まれます。
  3. ボットはそのファイルを、連絡先の言語による短いキャプションを添えて、実際の画像、動画、音声ファイル、またはドキュメントとして連絡先に送信します。

リンクに必要な条件:

  • https:// で始まるファイルへの直接リンクであること。Webページ(製品ページなど)へのリンクはファイルではないため、ボットはそれを通常のリンクとして共有します。
  • 画像: JPG, PNG, WebP, GIF。動画: MP4, MOV, WebM, 3GP。音声: MP3, OGG, M4A, AAC, WAV。ドキュメント: PDF, Word, Excel, PowerPoint, CSV
  • 1ファイルあたり最大16 MBまで
  • ログインなしでアクセス可能であること。パスワードが必要なリンクや、すでに期限切れのリンクは送信できません。

知っておくべきこと:

  • ボットは、その会話の中であなたのツールから返されたリンクのみを送信します。連絡先が入力したリンクや、ボットが作成したリンクがファイルとして送信されることはありません。
  • ファイルは送信時にコピーされるため、後でリンクの有効期限が切れても連絡先はファイルを保持できます。
  • 各ファイルリンクは、1回の会話につき最大1回のみ送信されます。
  • ライブラリアイテムと同様のチャネル制限が適用されます。メディアを受信できるチャネルを参照してください。
  • エージェントの試用タブでは、テストチャット内にファイルが表示されますが、誰にも送信されることはありません。

手動でのメディア送信

メディアライブラリは、ボットによる自動送信のためのものです。画像、動画、ファイルは、いつでもチャットインターフェースから手動で連絡先に送信できます。その際、ライブラリアイテムを設定する必要はありません。


次のステップ

  • AI エージェント — 各エージェントのエディター内の「メディア」タブ。
  • AI エージェント — AI Studio グループのメインページ(ナレッジベースやカスタム関数と並んでいます)。
  • 自動フォローアップ — メディアを添付できるフォローアップシーケンスの完全ガイド。