> 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/build/choose-channel/instagram.md).
# 会話プラットフォームとの連携：Instagram
Agent を Instagram プロアカウントのダイレクトメッセージに連携するための前提条件、認証手順、よくある質問を説明します
Instagram のダイレクトメッセージ連携は Facebook ページを通じて行います。MaiAgent は Instagram アカウントにリンクされたページから認証を取得し、そのページを介して Instagram のダイレクトメッセージを受信・返信します。認証手順は [FB Messenger](/maiagent-user-guide/ja/build/choose-channel/fb.md) と同じですが、あらかじめページを Instagram プロアカウントにリンクしておく必要があります。
## 連携前の確認
**MaiAgent の準備**
* [MaiAgent プラットフォーム](https://admin.maiagent.ai/)で「AI アシスタント」を作成しておきます
**Instagram アカウントの準備**
* Instagram アカウントを**プロアカウント**（ビジネスアカウントまたはクリエイターアカウント）に切り替えます。個人用アカウントは連携できません
* Instagram アカウントを Facebook ページにリンクします（Instagram アプリの設定 → ビジネスツールと管理 → リンク済みアカウント、またはページの設定 → リンク済みのアカウントで設定します）
* Instagram アカウントでメッセージの受信を許可します（設定 → メッセージとストーリーズへの返信 → メッセージコントロール → リンク済みツールによるメッセージへのアクセスを許可）
**Facebook 権限の準備**
* ログインに使う Facebook アカウントが、ビジネスポートフォリオに招待されているか、ポートフォリオを作成済みで、「全権限」を持っている必要があります
* ページがすでにビジネスポートフォリオに含まれている場合、追加の調整は不要です
* ページがビジネスポートフォリオに含まれていない場合、そのページの管理者であり、全権限を持っている必要があります
{% hint style="info" %}
**ビジネスポートフォリオをまだお持ちでない場合**は、Meta 公式の説明に従って[ビジネスポートフォリオを作成](https://www.facebook.com/business/help/1710077379203657)してください。作成者には自動で全権限が付与されます。
**自分に全権限があるか確認するには？** [Meta Business Suite](https://business.facebook.com/) の設定 → ユーザー → ユーザーで自分の名前をクリックし、権限を確認します。一部のアクセス権限しかない場合は、ポートフォリオ内で全権限を持つメンバーに変更を依頼してください。詳しくは [Meta 公式の権限説明](https://www.facebook.com/business/help/442345745885606)をご覧ください。
**先にページをビジネスポートフォリオに追加する必要はありますか？** 必須ではありません。認証時にページを取得できます。事前に整理しておきたい場合は、[Meta 公式の説明](https://www.facebook.com/business/help/720478807965744)に従ってポートフォリオに追加することもできます。
**Instagram アカウントをビジネスポートフォリオに追加する必要はありますか？** ありません。MaiAgent はページを通じてリンク先の Instagram アカウントを取得するため、Instagram プロアカウントがそのページにリンクされていれば利用できます。
{% endhint %}
{% hint style="warning" %}
**Instagram をすでに他のサポートシステムに連携している場合**は、連携後に Meta Business Suite で Instagram アカウントの「会話ルーティング」のデフォルトアプリを MaiAgent に変更する必要があります。変更しないと、ダイレクトメッセージは引き続き元のアプリで処理されます。[会話ルーティングの設定](#conversation-routing)をご覧ください。移行全体の手順は[他のサポートシステムから MaiAgent への移行](/maiagent-user-guide/ja/build/choose-channel/migrate-from-other-platform.md)をご覧ください。
{% endhint %}
{% hint style="warning" %}
1 つの Instagram アカウントは 1 つのチャネルにのみ連携できます。別の Agent に変更する場合は、元のチャネルを削除してから再度連携してください。
{% endhint %}
## 連携を開始する
### 1. チャネル連携ページを開く
左側メニューのチャネルをクリックし、右上のチャネルを連携をクリックして、プラットフォーム選択ページでInstagramを選びます。
### 2. Facebook にログインして認証する
Facebook ログインをクリックし、そのページを管理する Facebook アカウントでログインします。認証ウィンドウでは、次の順に操作を求められます。
1. 認証するビジネスポートフォリオを選択します
2. Instagram アカウントにリンクされたページを選択（取得）します
3. 認証を確定します
MaiAgent がアクセスするのは、認証したページとそのページにリンクされた Instagram アカウントのメッセージだけです。個人のメッセージにはアクセスしません。
Facebook ログイン
{% hint style="warning" %}
ブラウザーでポップアップを許可してください。許可していないと、Facebook のログインウィンドウがブロックされる場合があります。認証後にページリストが更新されない場合は、Instagram チャネルセクション右上の再読み込みをクリックし、再度認証してください。
{% endhint %}
### 3. 基本設定
| 項目 | 説明 |
| ------------------ | ---------------------------------------------------------------------------------- |
| **チャネル名** | この連携を識別しやすい名前を付けます |
| **AI アシスタント** | Instagram のダイレクトメッセージに返信する Agent を選びます |
| **ページを選択** | Instagram アカウントにリンクされたページをリストから選びます。システムが、そのページにリンクされた Instagram アカウントを自動で取得します |
| **リセットコマンドを有効にする** | （任意）有効にすると、1 つ以上のコマンドを設定できます。ユーザーがダイレクトメッセージでそのコマンドを送信すると、新しい会話を開始します。例：「最初からやり直す」 |
{% hint style="info" %}
リストには認証したすべてのページが表示されます。Instagram アカウントにリンクされていないページを選ぶと、保存時に「この Page には Instagram アカウントがリンクされていません」と表示されます。Instagram またはページの設定でリンクを完了してから、もう一度お試しください。
{% endhint %}
### 4. 保存して連携結果を確認する
チャネルを連携をクリックして作成を完了します。連携に成功すると、MaiAgent は Meta に対してそのページのメッセージイベントを自動で購読するため、Webhook を別途設定する必要はありません。
別の Instagram アカウントから、そのプロアカウントにテスト用のダイレクトメッセージを送ってください。Agent が正常に返信できれば連携は成功です。MaiAgent のチャネルリストからこの連携を開き、すべての会話で受信したダイレクトメッセージを確認することもできます。
{% hint style="info" %}
連携後は、チャネルリストで編集をクリックし、OCR 認識、システム時刻や送信者名を使った回答、有人転送、会話タグ、権限制御などの機能を設定できます。詳しくは[チャネル設定の概要](/maiagent-user-guide/ja/build/conversation-settings/platform-settings.md)をご覧ください。
{% endhint %}
## Instagram を他のサポートシステムに連携済みの場合：会話ルーティングの設定
Instagram アカウントを他のサポートアプリやマーケティングアプリ（Omnichat、Messenger by SHOPLINE など）に連携したことがある場合、Meta は「会話ルーティング」で設定された**デフォルトのルーティングアプリ**にダイレクトメッセージを渡します。MaiAgent がデフォルトでない場合、連携成功と表示されても、メッセージは元のアプリで処理され続けます。MaiAgent には届かず、Agent も返信しません。
連携完了後、ページの全権限を持つ管理者に、[Meta Business Suite](https://business.facebook.com/) でデフォルトアプリを MaiAgent に変更してもらってください。
1. 設定 → 連携 → 会話ルーティングをクリックします
2. 対象の Instagram アカウントを選び、設定をクリックします
3. デフォルトのルーティングアプリにMaiAgentを選び、次へをクリックします
設定時は次の点に注意してください。
* **Messenger と Instagram はそれぞれ設定します**：ページ（Messenger）の設定だけを変更しても、Instagram のダイレクトメッセージは元のアプリに届き続けます。逆の場合も同様です。Messenger の設定は [FB Messenger：会話ルーティングの設定](/maiagent-user-guide/ja/build/choose-channel/fb.md#conversation-routing)をご覧ください。
* **元のアプリを削除する必要はありません**：デフォルトアプリは「他のアプリが現在処理していない会話」の担当先を決めます。元のアプリを残しても、新しい会話が MaiAgent に届く妨げにはなりません。
* **新しい会話にはすぐ反映されますが、進行中の会話は異なります**：変更後、新規顧客やしばらくやり取りしていない顧客からのメッセージは MaiAgent に届きます。ただし、切り替え前から元のアプリで進行中の会話は引き続き元のアプリが管理し、追加メッセージも元のシステムに届きます。元のアプリが会話を解放するか、顧客が約 24 時間メッセージを送らなくなるまで（元のアプリがこの期間を最大 7 日に延長する場合もあります）、MaiAgent には切り替わりません。変更前のメッセージと会話履歴は元のシステムに残り、移行されません。
* **広告や専用リンクには別の指定がある場合があります**：元のアプリが Instagram のダイレクトメッセージに誘導する広告やリンクに担当アプリを指定している場合、その入口からの会話はデフォルト設定にかかわらず元のアプリに届くことがあります。元のアプリまたは広告設定で MaiAgent に変更するか、先にその入口を無効にしてください。
* **切り替え後は経路ごとに確認します**：一度もダイレクトメッセージを送ったことがないアカウントで新しい会話をテストしてください。切り替え前後の数日間は元のシステムも確認し、進行中の会話への追加メッセージを漏れなく処理してください。配信中の広告やリンクがある場合は、その入口から実際にメッセージを送り、MaiAgent に届くことを確認します。進行中の会話をすぐ移す必要がある場合は、元のシステム提供元に会話の解放または引き継ぎを依頼してください。
* **元に戻す場合**：デフォルトのルーティングアプリを元のアプリに戻します。この変更も、新しい会話としばらくやり取りしていない会話にのみすぐ反映されます。MaiAgent で進行中の会話への追加メッセージは引き続き MaiAgent に届き、約 24 時間やり取りがなくなるまで元のアプリに戻りません。その間、担当者は MaiAgent で返信を続けてください。MaiAgent のチャネルはひとまず残しておけます。
たとえば、あるアパレルブランドが Messenger と Instagram をまとめて MaiAgent に移行したものの、会話ルーティングはページ側だけ変更したとします。Messenger のテストメッセージは MaiAgent に届きますが、Instagram のテストメッセージは届きません。会話ルーティングで Instagram アカウントを選び直し、こちらもデフォルトのルーティングアプリを MaiAgent に設定すると、Instagram のメッセージも届くようになります。
{% hint style="info" %}
英語画面では「Conversation routing」と表示されます。MaiAgent のチャネル設定ページの注意書きにある「会話ルーティング」も同じ設定を指します。Meta の更新によってメニューの位置が変わる場合があります。動作の詳細は Meta 公式の [Conversation Routing for Instagram](https://developers.facebook.com/docs/messenger-platform/instagram/features/conversation-routing) をご覧ください。変更前に元のデフォルトアプリを記録しておいてください（未設定の場合も記録します）。元に戻す際に必要です。
{% endhint %}
## 対応するメッセージの種類
| 方向 | 対応内容 |
| ------------ | --------------------------------------- |
| ユーザー → Agent | テキスト、画像、動画、音声、スタンプです。画像には OCR 認識を利用できます |
| Agent → ユーザー | テキスト、画像です |
* **Markdown を自動でプレーンテキストに変換します**：Instagram は Markdown を描画しないため、Agent の返信に含まれる見出し、太字・斜体、リンク、表などの構文は送信前に自動でプレーンテキストに変換します（リンクは「テキスト URL」になります）。有人担当者が入力したテキストには影響しません。[メッセージ表示の最適化：メッセージングチャネル](/maiagent-user-guide/ja/build/choose-channel/web-chat/markdown-rendering.md#messaging-channels-plain-text)をご覧ください
* **連続したメッセージを 1 ターンにまとめます**：ユーザーが複数の画像を続けて送ったり、画像の後にテキストを送ったりした場合、Agent は一連のメッセージがそろうのを待ってからまとめて返信します。画像のみの場合は最後のメッセージから約 4 秒間新着がなければ回答し、待機は最大約 20 秒です。テキストを受信するとすぐに返信します。同じ会話では一度に 1 ターンだけ処理します
* **返信期限は 24 時間です**：Meta が返信を許可するのは、ユーザーの最後のメッセージから 24 時間以内です。期限を過ぎて送ったメッセージは、会話ページで[未配信](/maiagent-user-guide/ja/serve/daily-operations/reply.md#delivery-failed)と表示されます
* **ボタンイベントは現在 MaiAgent に届きません**：顧客が Instagram のよくある質問ボタンやメニューボタンを押すと、Meta は通常のメッセージではなくボタンイベント（postback）を送ります。このイベントは現在 MaiAgent に届かず、会話にも表示されず、Agent も返信しません。顧客が文字を入力して送ったダイレクトメッセージには影響しません。たとえば、アカウントによくある質問ボタンを設定している場合、顧客が「営業時間」を押しても返信はなく、MaiAgent に会話も表示されません。文字で質問を入力すれば通常どおり受信します
## よくある質問
### Q：認証後にページリストが空になるのはなぜですか？
ログインした Facebook アカウントにそのページの全権限がないか、認証時にそのページを選んでいない可能性があります。[連携前の確認](#pre-integration-checklist)に従って権限を確認し、ページ管理者として再度ログインして、認証ウィンドウで正しいページを選んでください。
### Q：保存時に「この Page には Instagram アカウントがリンクされていません」と表示されるのはなぜですか？
ページと Instagram プロアカウントがまだリンクされていないか、Instagram アカウントが個人用のままです。Instagram でプロアカウントに切り替え、そのページにリンクしてから再度認証してください。
### Q：保存時に「この Instagram アカウントはすでに使用されています」と表示されるのはなぜですか？
同じ Instagram アカウントが、組織内の別のチャネルにすでに連携されています。元のチャネルを削除してから、作成し直してください。
### Q：ユーザーがダイレクトメッセージを送っても MaiAgent に届かないのはなぜですか？
順に確認してください。Meta Business Suite の会話ルーティングで、この Instagram アカウントのデフォルトのルーティングアプリが MaiAgent になっていること、テスト用アカウントが切り替え前から旧システムで会話中ではなく、旧システムが指定された広告やリンクから入っていないこと（[会話ルーティングの設定](#conversation-routing)を参照）、Instagram のメッセージコントロールでリンク済みツールのアクセスを許可していること、ページと Instagram アカウントのリンクが有効なこと、認証した Facebook アカウントが引き続きページ管理者であることを確認します。認証切れやページ権限の削除があった場合は、チャネルを削除して再度連携してください。
### Q：顧客に「担当者が営業時間内に返信します」などの自動メッセージが届くのはなぜですか？
これらは Meta Business Suite 標準の自動返信が送っているメッセージです。MaiAgent を経由しないため、MaiAgent のすべての会話には表示されません。MaiAgent の AI 自動返信時間帯を無効にしても止まりません。Meta Business Suite の受信箱 → 自動返信で、不在メッセージ、自動返信、よくある質問、リードを順に確認し、不要なものは無効にし、残すものは現在の運用に合う内容に変更してください。利用例は [FB Messenger：顧客に自動メッセージが届く場合](/maiagent-user-guide/ja/build/choose-channel/fb.md#faq-meta-auto-reply)をご覧ください。
### Q：Instagram と FB Messenger で同じ Agent を使えますか？
はい。それぞれ独立したチャネルなので、同じ Agent を関連付けることも、別々の Agent を設定することもできます。
---
# 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/build/choose-channel/instagram.md?ask=&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.
%20(1)%20(1)%20(1).png?alt=media)