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

# Übersicht der Messages-API

> Direktnachrichten auf Facebook, Instagram und X/Twitter senden und empfangen

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} />

Mit der Messaging-API können Sie Direktnachrichten (DM) an Korrespondenten verwalten, die Ihre User Profiles kontaktieren.
Ein Korrespondent ist die Person, mit der Ihr Nutzer (User Profile) kommuniziert.
Eine Konversation ist eine Reihe von Nachrichten zwischen Ihrem Nutzer (User Profile) und dessen Korrespondenten.

<ul class="custom-bullets">
  <li>
    Die Messaging-API ist in allen Ayrshare Business Plans enthalten und als kostenpflichtiges
    Add-on für Premium Plans verfügbar.
  </li>

  <li>
    Sowohl für Business- als auch für Premium Plans müssen Sie Messaging auf der
    Account-Seite des Ayrshare-Dashboards aktivieren.
  </li>

  <li>
    Messaging ist verfügbar für Facebook Messenger, Instagram Direct Messenger
    und X Direct Messages.
  </li>
</ul>

<Card title="Mehr über die Messaging-API erfahren" icon="link" href="https://www.ayrshare.com/ayrshare-messaging-api-for-facebook-instagram-and-x-twitter/" horizontal />

## Wichtige Messaging-Funktionen

<ul class="custom-bullets">
  <li>Verwalten Sie die Konversationen Ihrer Nutzer mit Korrespondenten.</li>

  <li>
    Senden von Text-, Bild-, Video- und Emoji-Nachrichten im Namen Ihrer Nutzer.
  </li>

  <li>Abrufen vollständiger Konversationsverläufe.</li>
  <li>Einrichten automatischer Nachrichtenantworten.</li>

  <li>
    Empfang von Echtzeit-Updates per Webhooks für empfangene Nachrichten, Nachrichten-
    reaktionen und Lesebestätigungen.
  </li>
</ul>

## Messaging aktivieren

### Ihr Ayrshare-Konto und User Profiles aktivieren

Sie müssen Messaging zunächst für Ihr gesamtes Ayrshare-Konto aktivieren, um DMs verwalten zu können. Gehen Sie im Ayrshare-Dashboard zur [Account-Seite](https://app.ayrshare.com/account), klicken Sie auf die Schaltfläche „Learn More" und dann auf „Enable". Zu diesem Zeitpunkt haben Sie Messaging für Ihr gesamtes Konto aktiviert, *aber noch nicht für einzelne User Profiles*.

Sie können Messaging für einzelne User Profiles entweder auf der [User Profiles-Seite](https://app.ayrshare.com/manage-profiles) aktivieren, indem Sie das Kontrollkästchen „Messaging Active" für jedes Profil setzen, oder über den [Profile-Endpunkt](/apis/profiles/overview) zum Erstellen oder Aktualisieren.

Nach dem Aktivieren von Messaging für ein User Profile müssen Sie das Social-Media-Konto (Facebook und Instagram) auf der Seite Social Accounts / Social Linking erneut verknüpfen.
Nach der Aktivierung sehen Sie das Badge „Messaging" beim verknüpften Social-Media-Konto.

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

### Messaging in der Instagram-App aktivieren

Möglicherweise müssen Sie Messaging für Ihr Instagram-Konto aktivieren:

<ul class="custom-bullets">
  <li>
    Gehen Sie in der mobilen Instagram-App zu Ihrem Profil und tippen Sie auf das Menüsymbol ≡ oben rechts,
    um zur Seite **Settings and activity** zu gelangen.
  </li>

  <li>Scrollen Sie nach unten zum Bereich **How others can interact with you**.</li>
  <li>Klicken Sie auf **Messages and story replies**.</li>
  <li>Tippen Sie auf **Message requests**.</li>

  <li>
    Aktivieren Sie unter **Connected tool** den Schalter **Allow access to messages**.
  </li>
</ul>

## Wichtige Informationen zum Messaging

<Note>
  **Eine Konversation muss vom Korrespondenten initiiert werden.** Sobald eine Konversation
  hergestellt ist, können Sie im Namen Ihrer Nutzer frei Nachrichten senden, Nachrichten empfangen,
  Reaktionen (z. B. Daumen hoch) erhalten oder Lesebestätigungen abrufen.
</Note>

<Note>
  **Ihr Nutzer muss innerhalb von 7 Tagen nach der letzten vom Korrespondenten gesendeten Nachricht
  auf eine Instagram-Konversation antworten.** Wenn der Korrespondent seit 7 Tagen keine Nachricht mehr gesendet hat,
  gilt die Konversation als inaktiv und es kann nicht mehr darauf geantwortet werden.
</Note>

### Abruf des Nachrichtenverlaufs für Facebook und Instagram

Wenn Sie Messaging erstmals für ein User Profile mit verknüpftem Facebook- oder
Instagram-Konto aktivieren, gibt es wichtige Einschränkungen beim Zugriff auf den Konversationsverlauf:

#### Einschränkungen bei der Erstverbindung

<ul class="custom-bullets">
  <li>
    Facebook und Instagram erlauben nur das Abrufen der **letzten 20 Nachrichten** aus
    bestehenden Konversationen, wenn Sie ein Konto erstmals für Messaging verknüpfen.
  </li>

  <li>
    Wenn eine Konversation mehr als 20 Nachrichten enthält, sind zunächst nur die 20
    neuesten zugänglich.
  </li>
</ul>

#### Nach der Ersteinrichtung

<ul class="custom-bullets">
  <li>
    Sobald Messaging aktiviert ist, sind **alle neuen Nachrichten**, die gesendet und empfangen werden,
    vollständig zugänglich.
  </li>

  <li>
    Ayrshare speichert den vollständigen Konversationsverlauf ab diesem Zeitpunkt.
  </li>

  <li>
    Beispiel: Wenn Sie zunächst 20 Nachrichten abrufen und danach 100 neue Nachrichten
    ausgetauscht werden, können Sie auf insgesamt 120 Nachrichten zugreifen.
  </li>
</ul>

Diese Einschränkung gilt nur für historische Nachrichten, die vor der Aktivierung von Messaging existierten –
alle zukünftigen Konversationsaktivitäten für Facebook und Instagram werden vollständig gespeichert und sind zugänglich.

### Konversationslimit & Preise

<ul class="custom-bullets">
  <li>
    Jedes Ayrshare User Profile kann bis zu **1.000 aktive Konversationen pro
    Abrechnungszeitraum** haben. Die Anzahl der aktiven Konversationen ist die Summe über alle sozialen
    Netzwerke.
  </li>

  <li>
    **Premium Plan**: Messaging ist ein pauschales **\$49 pro Monat**-Add-on pro Konto.
  </li>

  <li>
    **Launch und Business Plans**: Messaging wird mit **\$0,09 pro aktiver
    Konversation** über Stripe-Metered-Billing abgerechnet. Volumenbasierte Rabatte sind
    verfügbar; wenden Sie sich für Details an Ihren Ayrshare-Kundenbetreuer.
  </li>

  <li>
    Eine Konversation wird für den Abrechnungszeitraum als aktiv gezählt, wenn Sie eine
    Nachricht an einen Empfänger senden. Eingehende Nachrichten von einem Empfänger markieren eine Konversation für
    sich allein nicht als aktiv.
  </li>

  <li>
    Wenn das Limit von 1.000 Konversationen erreicht wurde, können Sie weiterhin Nachrichten
    empfangen, aber erst zu Beginn des nächsten Abrechnungszeitraums wieder antworten.
  </li>

  <li>
    Die Anzahl der gesendeten oder empfangenen Nachrichten in einer aktiven Konversation ist
    unbegrenzt.
  </li>

  <li>
    Wenn Sie das Konversationslimit erhöhen möchten, wenden Sie sich bitte an Ihren
    Ayrshare-Kundenbetreuer.
  </li>
</ul>

Sie können die aktuelle Konversationszahl über den [User-Endpunkt](/apis/user/overview) einsehen.

### Messaging-Steuerungsprobleme auf Facebook und Instagram

Meta (Facebook und Instagram) verwendet ein „Thread-Control"-System für Messaging-Konversationen. Das bedeutet, dass jeweils nur eine App Nachrichten in einer Konversation senden kann, während andere Apps nur Nachrichten empfangen können.

#### Was bedeutet das?

Wenn Sie den Fehler **„Message failed to send because another app is controlling this thread now"** sehen, bedeutet das:

* Eine andere Drittanbieter-App steuert diese Konversation derzeit
* Ayrshare kann in dieser Konversation nur Nachrichten empfangen
* Ayrshare kann keine Nachrichten senden, bis die Kontrolle zurückgewonnen wird

#### So beheben Sie das Problem

Damit Ayrshare wieder Nachrichten senden kann, müssen Sie die Drittanbieter-App entfernen, die die Konversation kontrolliert.
Beachten Sie, dass Meta (Facebook und Instagram) den Prozess zum Entfernen von Drittanbieter-Apps aktualisieren kann, daher dienen die folgenden Schritte als allgemeine Anleitung.

**Für Facebook Pages:**

1. Gehen Sie zu [Facebook.com](https://facebook.com) und melden Sie sich in Ihrem Konto an
2. Klicken Sie auf das Menü (☰) oben rechts → **Settings & Privacy** → **Settings**
3. Klicken Sie in der linken Seitenleiste auf **Apps and Websites**
4. Suchen Sie die Drittanbieter-App, die Ihr Messaging kontrolliert
5. Klicken Sie neben dieser App auf **Remove**
6. Bestätigen Sie das Entfernen

**Für Instagram Business-Konten:**

1. Öffnen Sie die Instagram-App auf Ihrem Telefon
2. Gehen Sie zu Ihrem **Profil** → tippen Sie auf das Menü (☰) → **Settings and Privacy**
3. Tippen Sie auf **Apps and Websites**
4. Suchen Sie die Drittanbieter-App und entfernen Sie sie

**Alternative für Instagram:**

1. Gehen Sie zu [business.facebook.com](https://business.facebook.com)
2. Navigieren Sie zu **Business Settings**
3. Klicken Sie unter **Accounts** auf **Instagram Accounts**
4. Wählen Sie Ihr Instagram-Konto aus
5. Prüfen Sie auf verbundene Apps und entfernen Sie die problematische

#### Nach dem Entfernen

Sobald Sie die Drittanbieter-App entfernt haben:

<ul class="custom-bullets">
  <li>Die Thread-Kontrolle geht automatisch an Ayrshare zurück</li>
  <li>Sie sollten wieder wie gewohnt Nachrichten senden können</li>
  <li>Weitere Maßnahmen Ihrerseits sind nicht erforderlich</li>
</ul>

Wenn nach dem Entfernen der App weiterhin Probleme auftreten, wenden Sie sich bitte an unser Support-Team.

## Message-Webhooks

Siehe [Messages Webhooks](/apis/webhooks/actions#messages-action), um Nachrichten, Lesebestätigungen oder Reaktionen automatisch zu empfangen.
