
# メディアライブラリ

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

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


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

---

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

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

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

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

ボットは**あなた**がアップロードして承認したファイルのみを送信します。インターネットから画像を勝手に取得したり、作成したりすることはありません。

---

## どこにあるか

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

> クラシックな **キャンペーン** を引き続き使用している古いアカウントでも、同じページが同様に機能します。アイテムはエージェントではなくキャンペーンに属し、フィルターにはキャンペーンがリストされます。


---

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

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

例:

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

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

---

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

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

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

---

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

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

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

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

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

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

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

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

---

## メディアを追加する方法

1. メインサイドバーで、**AI Studio**をクリックします。
2. **Media Library**をクリックします。
3. **+ Add media**ボタンをクリックします。


4. アイテムをどの **エージェント** に割り当てるかを選択します（1つのアイテムを複数のエージェントに紐付けることができます）。（キャンペーンベースの古いアカウントでは、ここでキャンペーンを選択します。）
5. クリックして、デバイスから **ファイルを選択** します（画像、動画、GIF、音声、またはPDF）。音声の場合は、アップロードの代わりに **ボイスメモを録音** に切り替えて、アプリ内で直接録音することもできます。音声を追加する場合、それを **ボイスメモ**（録音された音声バブル）として送信するか、通常の **オーディオファイル** として送信するかを選択できます。
6. 後でアイテムを識別できるように、短い **タイトル** を入力します（例：「青いドレスの写真」）。
7. **ボットがこれを送信するタイミングは？** フィールドに、状況を平易な言葉で記述します。


8. **保存** をクリックします。アイテムがメディアリストに表示され、紐付けたすべてのエージェント（またはキャンペーン）でボットがすぐに利用できるようになります。

[エージェント](../ai-agents/ai-agents.md)自身の**メディア**タブからメディアを追加することもできます。これは同じ基盤ライブラリを開きますが、そのエージェント用に事前にフィルタリングされています。このタブは、作成したばかりのエージェントや、他のエージェントから複製したエージェントなど、エージェントが存在した瞬間から機能し、そこにアップロードしたファイルはそのエージェントに直ちに帰属します。古いアカウントでは、独自のAI設定を直接保持しているキャンペーンにも、同じ**メディア**ステップがエディターに組み込まれています：


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

### 入力項目

| フィールド | 記入内容 |
|-------|--------------|
| **ファイル** | ボットが送信できるようにしたい画像、動画、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会話につき最大1回送信されます。顧客が同じことを何度も尋ねてくる場合、ボットは同じ画像を何度も送るのではなく、テキストで回答します。どうしても再送可能にしたい場合は、アイテムの「1会話あたりの最大送信回数」の値を増やしてください。

---

## 手動でのメディア送信

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

---

## 次のステップ

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