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

# Messages API概要

> Facebook、Instagram、X/Twitterでダイレクトメッセージを送受信します

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["business"]} maxPackRequired={false} />

Messaging APIを使用して、User Profileに連絡してくる相手にダイレクトメッセージ(DM)を管理できます。
相手とは、ユーザー(User Profile)がやり取りしている相手のことです。
会話とは、ユーザー(User Profile)とその相手との間の一連のメッセージです。

<ul class="custom-bullets">
  <li>
    Messaging APIは、すべてのAyrshare Business Planに含まれ、Premiumプランでは有料アドオンとして提供されます。
  </li>

  <li>
    BusinessプランとPremiumプランの両方で、Ayrshareダッシュボードのアカウントページでメッセージングを有効にする必要があります。
  </li>

  <li>
    メッセージングは、Facebook Messenger、Instagram Direct Messenger、X Direct Messagesで利用可能です。
  </li>
</ul>

<Card title="Messaging APIについて詳しく見る" icon="link" href="https://www.ayrshare.com/ayrshare-messaging-api-for-facebook-instagram-and-x-twitter/" horizontal />

## 主なメッセージング機能

<ul class="custom-bullets">
  <li>ユーザーと相手との会話を管理します。</li>

  <li>
    ユーザーに代わってテキスト、画像、動画、絵文字メッセージを送信します。
  </li>

  <li>完全な会話履歴を取得します。</li>
  <li>自動メッセージ応答を設定します。</li>

  <li>
    受信メッセージ、メッセージへのリアクション、既読レシートに対して、webhook経由でリアルタイムの更新を受け取ります。
  </li>
</ul>

## メッセージングの有効化

### AyrshareアカウントとUser Profileの有効化

DMを管理するには、まずAyrshareアカウント全体でメッセージングを有効にする必要があります。Ayrshareダッシュボードで[アカウントページ](https://app.ayrshare.com/account)に移動し、「Learn More」ボタンをクリックしてから「Enable」をクリックします。この時点で、アカウント全体でメッセージングを有効にしましたが、*個々のUser Profileに対してはメッセージングを有効にしていません*。

個々のUser Profileでメッセージングを有効にするには、[User Profilesページ](https://app.ayrshare.com/manage-profiles)で各プロファイルの「Messaging Active」チェックボックスをクリックするか、[profilesエンドポイント](/apis/profiles/overview)の作成または更新を使用します。

User Profileでメッセージングを有効にした後、Social Accounts/Social Linkingページでソーシャルアカウント(FacebookとInstagram)を再リンクする必要があります。
有効になると、リンクされたソーシャルアカウントに「Messaging」バッジが表示されます。

<img src="https://mintcdn.com/ayrshare/XRYzr5UdPjyr_kPK/images/apis/messaging/messaging-badge.webp?fit=max&auto=format&n=XRYzr5UdPjyr_kPK&q=85&s=5625eabbe3c8110295bda3bc51d254f1" width="60%" alt="Messaging badge" class="center" data-path="images/apis/messaging/messaging-badge.webp" />

### Instagramアプリでのメッセージングの有効化

Instagramアカウントでメッセージングを有効にする必要がある場合があります:

<ul class="custom-bullets">
  <li>
    Instagramモバイルアプリでプロフィールに移動し、右上のメニューアイコン≡をタップして**Settings and activity**ページに移動します。
  </li>

  <li>下にスクロールして**How others can interact with you**セクションに移動します。</li>
  <li>**Messages and story replies**をクリックします。</li>
  <li>**Message requests**をタップします。</li>

  <li>
    **Connected tool**の下で**Allow access to messages**スイッチをオンに切り替えます。
  </li>
</ul>

## メッセージングに関する重要な情報

<Note>
  **会話は相手から開始する必要があります。** 会話が確立されると、ユーザーに代わってメッセージを送受信したり、リアクション(いいねなど)を取得したり、既読レシートを取得したりできます。
</Note>

<Note>
  **ユーザーは、相手が最後に送信したメッセージから7日以内にInstagramの会話に応答する必要があります。** 相手が7日間メッセージを送信していない場合、会話は非アクティブとみなされ、応答できません。
</Note>

### FacebookおよびInstagramのメッセージ履歴取得

FacebookまたはInstagramをリンクしたユーザープロファイルでメッセージングを初めて有効にする場合、会話履歴へのアクセスに関して重要な制限があります:

#### 初回接続の制限

<ul class="custom-bullets">
  <li>
    FacebookとInstagramでは、メッセージング用にアカウントを初めてリンクした際、既存の会話から**最新20件のメッセージ**のみ取得できます
  </li>

  <li>
    会話に20件を超えるメッセージがある場合、最初は最新の20件のみアクセス可能です
  </li>
</ul>

#### 初期設定後

<ul class="custom-bullets">
  <li>
    メッセージングを有効にすると、送受信された**すべての新しいメッセージ**に完全にアクセスできます
  </li>

  <li>
    Ayrshareは今後の完全な会話履歴を維持します
  </li>

  <li>
    たとえば: 最初に20件のメッセージを取得し、その後100件の新しいメッセージが交換された場合、合計120件すべてのメッセージにアクセスできます
  </li>
</ul>

この制限は、メッセージングを有効にする前に存在した過去のメッセージにのみ適用されます - FacebookとInstagramの今後のすべての会話アクティビティは完全に保持され、アクセス可能です。

### 会話数の上限と料金

<ul class="custom-bullets">
  <li>
    各Ayrshare User Profileは、**請求サイクルごとに最大1,000件のアクティブな会話**を持つことができます。アクティブな会話数はすべてのソーシャルネットワークにわたる合計です。
  </li>

  <li>
    **Premiumプラン**: メッセージングはアカウントごとに**月額\$49**の定額アドオンです。
  </li>

  <li>
    **LaunchプランとBusinessプラン**: メッセージングはStripeメーター課金を通じて、**アクティブな会話ごとに\$0.09**で請求されます。ボリュームベースの割引が利用可能です。詳細についてはAyrshareアカウント担当者にお問い合わせください。
  </li>

  <li>
    受信者にメッセージを送信すると、会話は請求サイクルでアクティブとしてカウントされます。受信者からの受信メッセージだけでは、会話をアクティブとしてマークしません。
  </li>

  <li>
    1,000件の会話上限に達した場合、メッセージを受信することはできますが、次の請求サイクルの開始まで応答することはできません。
  </li>

  <li>
    アクティブな会話で送受信されるメッセージの数は無制限です。
  </li>

  <li>
    会話上限を増やす必要がある場合は、Ayrshareアカウント担当者にお問い合わせください。
  </li>
</ul>

現在の会話数は、[userエンドポイント](/apis/user/overview)で確認できます。

### FacebookおよびInstagramでのメッセージング制御の問題

Meta(FacebookとInstagram)は、メッセージング会話に対して「スレッド制御」システムを使用します。これは、一度に1つのアプリだけが会話でメッセージを送信でき、他のアプリはメッセージを受信することしかできないことを意味します。

#### これは何を意味するのか?

\*\*「Message failed to send because another app is controlling this thread now(現在別のアプリがこのスレッドを制御しているため、メッセージの送信に失敗しました)」\*\*というエラーが表示された場合、次のことを意味します:

* 別のサードパーティアプリが現在その会話を制御しています
* Ayrshareはその会話でメッセージを受信することしかできません
* Ayrshareは制御を取り戻すまでメッセージを送信できません

#### この問題を解決する方法

Ayrshareが再びメッセージを送信できるようにするには、会話を制御しているサードパーティアプリを削除する必要があります。
Meta(FacebookおよびInstagram)は、サードパーティアプリを削除するためのプロセスを更新する場合があるため、次の手順を一般的なガイドラインとして使用してください。

**Facebookページの場合:**

1. [Facebook.com](https://facebook.com)に移動し、アカウントにログインします
2. 右上のメニュー(☰)をクリック → **Settings & Privacy** → **Settings**
3. 左サイドバーで**Apps and Websites**をクリックします
4. メッセージングを制御しているサードパーティアプリを見つけます
5. そのアプリの横にある**Remove**をクリックします
6. 削除を確認します

**Instagramビジネスアカウントの場合:**

1. 電話でInstagramアプリを開きます
2. **プロフィール**に移動 → メニュー(☰)をタップ → **Settings and Privacy**
3. **Apps and Websites**をタップします
4. サードパーティアプリを見つけて削除します

**Instagramの代替方法:**

1. [business.facebook.com](https://business.facebook.com)に移動します
2. **Business Settings**に移動します
3. **Accounts**の下で**Instagram Accounts**をクリックします
4. Instagramアカウントを選択します
5. 接続されたアプリを確認し、問題のあるものを削除します

#### 削除後

サードパーティアプリを削除した後:

<ul class="custom-bullets">
  <li>スレッド制御は自動的にAyrshareに戻ります</li>
  <li>再び通常どおりメッセージを送信できるはずです</li>
  <li>ユーザー側でこれ以上のアクションは必要ありません</li>
</ul>

アプリを削除した後も問題が発生する場合は、サポートチームにお問い合わせください。

## メッセージwebhook

メッセージ、既読レシート、リアクションを自動的に受信するには、[Messages Webhooks](/apis/webhooks/actions#messages-action)をご覧ください。