> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram Business をアプリに接続する

> Instagram Business コネクタを設定してスコープを選び、バックエンド関数から使って、投稿の公開、コメントへの返信、ダイレクトメッセージへの対応を行います。

アプリを Instagram Business に接続すると、フィード投稿の公開、コメントの管理、ダイレクトメッセージへの対応ができます。1 つの共有アカウントから行うことも、各ユーザー自身の Instagram アカウントから行うこともできます。

> [!NOTE]
>
> アプリでコネクタを使用するには、[**Builder プラン**](https://base44.com/pricing) 以上が必要です。

***

## できること

Instagram アカウントの投稿、コメント、メッセージをアプリのワークフローに取り込みます。

> [card] 投稿を公開
>
> 新しい商品が追加されたときなど、アプリで何かが起きたときに、写真、動画、カルーセルをフィードに投稿します。

> [card] コメントを管理
>
> 投稿へのコメントを読み取り、返信し、モデレートします。たとえば、コメントにキーワードが含まれる場合に対応します。

> [card] ダイレクトメッセージに対応
>
> ダイレクトメッセージを読み取り、相手の最後のメッセージから 24 時間以内にアプリから返信します。

**プロンプト例**

AI チャットで、コンテンツ、アクションのきっかけ、動的なフィールドを説明します。例:

```text wrap theme={null}
新しい商品写真を自動的に Instagram のフィードに投稿して。
```

```text wrap theme={null}
ポートフォリオギャラリーから Instagram のカルーセル投稿を作成して。
```

```text wrap theme={null}
キーワードが検出されたら Instagram 投稿のコメントに返信して。
```

```text wrap theme={null}
Instagram 投稿のコメントを自動的にモデレートして。
```

```text wrap theme={null}
Instagram ビジネスのプロフィール情報と最近のフィード投稿をアプリに表示して。
```

***

## Instagram Business を接続する

アプリが投稿を公開し、コメントを管理し、ダイレクトメッセージに対応できるよう、Instagram Business を接続します。

> [!TIP]
>
> **始める前に:** Instagram のビジネスアカウントまたはクリエイターアカウントで接続します。アカウントの種類は、Instagram アプリの設定で切り替えられます。

> [tab] 共有コネクタ
>
> 1 つのアカウントを 1 度接続すると、アプリを使う全員がその接続とデータを共有します。
>
> **共有 Instagram Business コネクタを追加するには:**
>
> 1. ワークスペースのサイドバーで **コネクタ** をクリックします。
> 2. **コネクターを追加** をクリックします。
> 3. **Instagram Business** を検索し、クリックします。
> 4. **Shared connector** を選択し、**次へ** をクリックします。
> 5. **接続名** を入力します。
> 6. **アクセスできる対象** で、接続を使える場所を選択します。**アプリと Super Agent** (デフォルト)、**Apps only**、**Super agent only** のいずれかです。
> 7. (任意) **権限** で、接続に付与するスコープを選択します。
> 8. **コネクターを追加** をクリックし、共有したい Instagram アカウントでログインします。

> [tab] アプリユーザーコネクタ
>
> 各ユーザーが自分の Instagram アカウントを接続します。アプリは、そのユーザーの投稿、コメント、メッセージを扱えます。
>
> > [!TIP]
> >
> > **始める前に:** アプリユーザーコネクタを設定できるのはワークスペースのオーナーと管理者だけです。また、独自の OAuth クライアントが必要です。[独自の OAuth クライアントを使う](https://docs.base44.com/ja/Integrations/Connectors.md#using-your-own-oauth-client) を参照してください。
>
> **アプリユーザー Instagram Business コネクタを追加するには:**
>
> 1. ワークスペースのサイドバーで **コネクタ** をクリックします。
> 2. **コネクターを追加** をクリックします。
> 3. **Instagram Business** を検索し、クリックします。
> 4. **アプリユーザーコネクター** を選択し、**次へ** をクリックします。
> 5. **Callback URL** をコピーし、Instagram アプリの許可済みリダイレクト URI に追加します。
> 6. **コネクタ名** を入力します。
> 7. Instagram アプリの **クライアントID** と **クライアントシークレット** を入力します。
> 8. **スコープ** でスコープを確認し、アプリに不要なものを削除します。[スコープと権限](#scopes-and-permissions) を参照してください。
> 9. **コネクタを追加** をクリックします。
> 10. アプリエディターでアプリを開きます。
> 11. 各ユーザーが自分の Instagram アカウントを接続できる仕組みを追加するよう AI チャットに依頼します。

***

## スコープと権限

スコープは、アプリが Instagram でできることを制御します。スコープはコネクタを設定するときに選びます。

> [card]
>
> **1. Base44 が追加するもの**
>
> これらは常に含まれるため、共有コネクタでは **権限**、アプリユーザーコネクタでは **スコープ** にロックされたスコープとして表示されます。
>
> * `instagram_business_basic`: ユーザー名やメディアなど、アカウントの基本情報を表示します
> * `instagram_business_manage_messages`: ダイレクトメッセージを読み取り、返信します
>
> **2. 自分で設定するもの**
>
> 共有コネクタでは **権限**、アプリユーザーコネクタでは **スコープ** で、アプリに必要なスコープを選択します。
>
> * `instagram_business_content_publish`: 写真、動画、カルーセルをフィードに公開します
> * `instagram_business_manage_comments`: アカウントの投稿へのコメントを読み取り、返信し、モデレートします
>
> **アクセス:** アプリは、接続を認可した Instagram アカウントを扱います。

***

## バックエンド関数を使う

Instagram Business を接続すると、バックエンド関数がアクセストークンを取得して Instagram API を直接呼び出せます。OAuth フローとトークンの保管は Base44 が処理します。

* 共有接続の場合は、`getConnection()` でトークンを取得します。
* アプリユーザー接続の場合は、`getCurrentAppUserConnection()` を使い、各リクエストがログイン中のユーザーのトークンを使用するようにします。

`graph.instagram.com` で Instagram API を呼び出し、トークンを `access_token` クエリパラメーターで渡します。

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("instagram");

const response = await fetch(
  `https://graph.instagram.com/me?fields=id,username&access_token=${accessToken}`,
);
const account = await response.json();
```

> [card] [共有コネクタ](https://docs.base44.com/ja/developers/backend/resources/connectors/shared-connectors.md)
>
> バックエンド関数から共有接続を設定、デプロイ、呼び出します。

> [card] [アプリユーザーコネクタ](https://docs.base44.com/ja/developers/backend/resources/connectors/app-user-connectors.md)
>
> ユーザーごとのトークンを取得し、ログイン中のユーザーとして API を呼び出します。

***

## トラブルシューティング

アプリで Instagram Business が動作しなくなった場合は、接続と返信のタイミングを確認してください。

> [accordion] 接続の再接続が必要になる
>
> Base44 は Instagram のアクセスをバックグラウンドで更新します。アクセスが失われたり期限切れになったりすると、接続に **この接続は再接続が必要です** と表示されます。[再接続](https://docs.base44.com/ja/Integrations/Connectors.md#managing-your-connectors) し、同じ Instagram アカウントでログインすると、その接続を使うすべてのアプリで復元されます。

> [accordion] ダイレクトメッセージへの返信が失敗する
>
> Instagram では、ダイレクトメッセージへの返信は相手の最後のメッセージから 24 時間以内に限られます。その時間内に返信するか、相手から再度メッセージが届くのを待ってください。

> [!NOTE]
>
> このページは AI を使用して翻訳されました。最も正確で最新の情報については、[英語版](https://docs.base44.com/index.md) を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.