> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/choose-channel/instagram.md).

# メッセージングプラットフォームとの連携：Instagram

AI アシスタントを Instagram プロアカウントのダイレクトメッセージに連携するための前提条件、認証手順、よくある質問

Instagram のダイレクトメッセージ連携は、Facebook ページを基盤としています。MaiAgent は Instagram アカウントにリンクされた Facebook ページを通じて認証を取得し、その Facebook ページを介して Instagram のダイレクトメッセージを受信・返信します。認証手順は [FB Messenger](/maiagent-user-guide/ja/serve/choose-channel/fb.md) と同じですが、Facebook ページを事前に Instagram プロアカウントへリンクしておく必要があります。

## <mark style="color:blue;">連携前の確認</mark> <a href="#pre-integration-checklist" id="pre-integration-checklist"></a>

**MaiAgent の準備**

* [MaiAgent プラットフォーム](https://admin.maiagent.ai/)で「AI アシスタント」を作成済みであること

**Instagram アカウントの準備**

* Instagram アカウントを**プロアカウント**（ビジネスアカウントまたはクリエイターアカウント）に切り替えていること。個人アカウントは連携できません
* Instagram アカウントが Facebook ページにリンクされていること（Instagram アプリの<mark style="color:blue;">設定 → ビジネスツールと管理 → リンク済みのアカウント</mark>、または Facebook ページの<mark style="color:blue;">設定 → リンク済みのアカウント</mark>でリンクします）
* Instagram アカウントでメッセージの受信が許可されていること（<mark style="color:blue;">設定 → メッセージとストーリーズへの返信 → メッセージコントロール → リンク済みツールによるメッセージへのアクセスを許可</mark>）

**Facebook 権限の準備**

* ログインに使用する Facebook アカウントがビジネスポートフォリオに招待されているか、ビジネスポートフォリオを作成済みであり、「フルコントロール」権限を持っていること
* Facebook ページがビジネスポートフォリオに追加されている場合：追加の設定は不要です
* Facebook ページがビジネスポートフォリオに追加されていない場合：その Facebook ページの管理者であり、フルコントロール権限を持っている必要があります

{% hint style="info" %}
**ビジネスポートフォリオがまだありませんか？** Meta の公式手順に従って[ビジネスポートフォリオを作成](https://www.facebook.com/business/help/1710077379203657)してください。作成者にはフルコントロール権限が自動的に付与されます。

**フルコントロール権限があるか確認するには？** [Meta Business Suite](https://business.facebook.com/)の <mark style="color:blue;">設定 → ユーザー → ユーザー</mark>に移動し、自分の名前を選択して権限を確認してください。一部のアクセス権限しかない場合は、ポートフォリオ内でフルコントロール権限を持つメンバーに変更を依頼してください。権限の詳細については、[Meta の公式手順](https://www.facebook.com/business/help/442345745885606)を参照してください。

**Facebook ページを先にビジネスポートフォリオへ追加する必要がありますか？** 必須ではありません。認証時に Facebook ページを直接取得できます。事前に整理しておきたい場合は、[Meta の公式手順](https://www.facebook.com/business/help/720478807965744)に従って Facebook ページをポートフォリオへ追加することもできます。

**Instagram アカウントをビジネスポートフォリオに追加する必要がありますか？** 必要ありません。MaiAgent は Facebook ページを通じて、リンクされた Instagram アカウントを取得します。Instagram プロアカウントがその Facebook ページにリンクされていれば連携できます。
{% endhint %}

{% hint style="warning" %}
1 つの Instagram アカウントを連携できるチャットプラットフォームは 1 つだけです。別の AI アシスタントに連携し直す場合は、元のチャットプラットフォームを削除してから再度連携してください。
{% endhint %}

## <mark style="color:blue;">連携を開始する</mark> <a href="#start-integration" id="start-integration"></a>

### 1. チャットプラットフォームの連携ページを開く <a href="#step-go-to-channel-page" id="step-go-to-channel-page"></a>

左側のメニューで<mark style="color:blue;">チャットプラットフォーム</mark>を選択し、右上の<mark style="color:blue;">チャットプラットフォームを連携</mark>をクリックします。プラットフォーム選択ページで<mark style="color:blue;">Instagram</mark>を選択してください。

### 2. Facebook にログインして認証する <a href="#step-facebook-login" id="step-facebook-login"></a>

<mark style="color:blue;">Facebook でログイン</mark>をクリックし、その Facebook ページを管理している Facebook アカウントでログインします。認証ウィンドウでは、次の操作を順番に行います。

1. 認証するビジネスポートフォリオを選択します
2. Instagram アカウントにリンクされた Facebook ページを選択（取得）します
3. 認証を確定します

MaiAgent は、認証した Facebook ページと、それにリンクされた Instagram アカウントのメッセージにのみアクセスします。個人のメッセージにはアクセスしません。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-dc446ea48022138a20907b9d1282def9e546042a%2Fimage%20(5)%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>Facebook でログイン</p></figcaption></figure>

{% hint style="warning" %}
ブラウザでポップアップが許可されていることを確認してください。許可されていない場合、Facebook のログインウィンドウがブロックされることがあります。認証後に Facebook ページのリストが更新されない場合は、<mark style="color:blue;">Instagram チャンネル</mark>セクションの右上にある<mark style="color:blue;">再読み込み</mark>をクリックして、再度認証してください。
{% endhint %}

### 3. 基本設定 <a href="#step-basic-settings" id="step-basic-settings"></a>

| 項目                  | 説明                                                                                                     |
| ------------------- | ------------------------------------------------------------------------------------------------------ |
| **チャットプラットフォーム名**   | 識別しやすいように、この連携に名前を付けます。                                                                                |
| **AI アシスタント**       | Instagram のダイレクトメッセージに返信する AI アシスタントを選択します。                                                            |
| **Facebook ページを選択** | Instagram アカウントにリンク済みの Facebook ページをリストから選択します。システムは、その Facebook ページにリンクされた Instagram アカウントを自動的に取得します。 |
| **リセットコマンドを有効にする**  | （任意）有効にすると、1 つ以上のコマンドを設定できます。ユーザーがダイレクトメッセージでそのコマンドを送信すると、新しい会話が開始されます。例：「最初からやり直す」                    |

{% hint style="info" %}
リストには、認証したすべての Facebook ページが表示されます。選択した Facebook ページが Instagram アカウントにリンクされていない場合、保存時に「この Page は Instagram アカウントにリンクされていません」というエラーが表示されます。Instagram または Facebook ページの設定に戻ってリンクを完了し、もう一度お試しください。
{% endhint %}

### 4. 保存して連携結果を確認する <a href="#step-verify-integration" id="step-verify-integration"></a>

<mark style="color:blue;">チャットプラットフォームを連携</mark>をクリックして作成を完了します。連携に成功すると、MaiAgent は Meta を通じてその Facebook ページのメッセージイベントを自動的にサブスクライブします。Webhook を別途設定する必要はありません。

別の Instagram アカウントから、そのプロアカウントにテスト用のダイレクトメッセージを送信します。AI アシスタントが正常に返信できれば、連携は成功です。MaiAgent のチャットプラットフォームリストからこの連携を開き、<mark style="color:blue;">すべての会話</mark>で受信したダイレクトメッセージを確認することもできます。

{% hint style="info" %}
連携に成功した後、チャットプラットフォームのリストで編集をクリックすると、OCR 認識、システム時刻や送信者名を使用した回答、有人対応への切り替え、会話タグ、権限管理などの機能を設定できます。詳しくは、[チャットプラットフォーム設定の概要](/maiagent-user-guide/ja/serve/platform-settings.md)を参照してください。
{% endhint %}

## <mark style="color:blue;">対応しているメッセージ形式</mark> <a href="#supported-message-types" id="supported-message-types"></a>

| 方向               | 対応内容                                   |
| ---------------- | -------------------------------------- |
| ユーザー → AI アシスタント | テキスト、画像、動画、音声、スタンプ。画像では OCR 認識も使用できます。 |
| AI アシスタント → ユーザー | テキスト、画像                                |

## <mark style="color:blue;">よくある質問</mark> <a href="#faq" id="faq"></a>

### Q：認証後、Facebook ページのリストが空なのはなぜですか？ <a href="#faq-empty-page-list" id="faq-empty-page-list"></a>

ログインに使用した Facebook アカウントに、その Facebook ページのフルコントロール権限がないか、認証時にその Facebook ページが選択されていません。[連携前の確認](#pre-integration-checklist)に従って権限を確認し、Facebook ページの管理者として再度ログインして、認証ウィンドウで正しい Facebook ページが選択されていることを確認してください。

### Q：保存時に「この Page は Instagram アカウントにリンクされていません」と表示されるのはなぜですか？ <a href="#faq-page-not-linked" id="faq-page-not-linked"></a>

Facebook ページと Instagram プロアカウントがリンクされていないか、Instagram アカウントがまだ個人アカウントになっています。Instagram でプロアカウントに切り替えて Facebook ページにリンクし、再度認証してください。

### Q：保存時に「この Instagram アカウントはすでに使用されています」と表示されるのはなぜですか？ <a href="#faq-account-already-used" id="faq-account-already-used"></a>

同じ Instagram アカウントが、組織内の別のチャットプラットフォームにすでに連携されています。元のチャットプラットフォームを削除してから、再度作成してください。

### Q：ユーザーがダイレクトメッセージを送信しても、MaiAgent が受信しないのはなぜですか？ <a href="#faq-no-incoming-message" id="faq-no-incoming-message"></a>

次の項目を順番に確認してください。Instagram アカウントのメッセージコントロールでリンク済みツールによるメッセージへのアクセスが許可されていること、Facebook ページと Instagram アカウントのリンクが引き続き有効であること、認証した Facebook アカウントが引き続き Facebook ページの管理者であることを確認します。認証の期限が切れているか、Facebook ページの権限が削除されている場合は、チャットプラットフォームを削除してから再度連携してください。

### Q：Instagram と FB Messenger で同じ AI アシスタントを使用できますか？ <a href="#faq-share-agent" id="faq-share-agent"></a>

はい。それぞれ独立したチャットプラットフォームとして、同じ AI アシスタントに連携することも、個別に異なる機能を設定することもできます。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/serve/choose-channel/instagram.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
