Übersicht der Messages-API

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.

• Die Messaging-API ist in allen Ayrshare Business Plans enthalten und als kostenpflichtiges Add-on für Premium Plans verfügbar.
• Sowohl für Business- als auch für Premium Plans müssen Sie Messaging auf der Account-Seite des Ayrshare-Dashboards aktivieren.
• Messaging ist verfügbar für Facebook Messenger, Instagram Direct Messenger, X Direct Messages und WhatsApp (Private Beta).

​

Wichtige Messaging-Funktionen

• Verwalten Sie die Konversationen Ihrer Nutzer mit Korrespondenten.
• Senden von Text-, Bild-, Video- und Emoji-Nachrichten im Namen Ihrer Nutzer.
• Abrufen vollständiger Konversationsverläufe.
• Einrichten automatischer Nachrichtenantworten.
• Empfang von Echtzeit-Updates per Webhooks für empfangene Nachrichten, Nachrichten- reaktionen und Lesebestätigungen.

​

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, 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 aktivieren, indem Sie das Kontrollkästchen „Messaging Active” für jedes Profil setzen, oder über den Profile-Endpunkt 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.

​

Messaging für WhatsApp aktivieren

Verknüpfen Sie ein WhatsApp Business Account über den Embedded-Signup-Flow von Meta direkt aus dem Ayrshare-Dashboard:

• Sie benötigen ein Meta Business Manager-Konto, ein WhatsApp Business Account (WABA) und eine geeignete Telefonnummer. Meta verifiziert das Konto und die Telefonnummer während des Embedded-Signup-Vorgangs.
• Klicken Sie auf der Seite „Social Accounts” auf Link in der WhatsApp-Kachel. Ayrshare öffnet das Embedded-Signup-Pop-up von Meta, das den Kunden durch die Auswahl bzw. Erstellung seines Business Managers, des WABA und der Telefonnummer sowie durch die Zustimmung zu den Bedingungen von Meta führt.
• Sobald der Signup abgeschlossen ist, verifiziert Ayrshare die Eigentümerschaft des ausgewählten WABA und der Telefonnummer, schließt die Registrierung ab und abonniert das Konto für WhatsApp-Webhooks. Sie geben keine separate Registrierungs-PIN im Ayrshare-Dashboard ein.

​

Wichtiges WhatsApp-spezifisches Verhalten

• Empfänger sind Telefonnummern, keine IDs. WhatsApp identifiziert Korrespondenten anhand der E.164-Telefonnummer (nur Ziffern, ohne +). Die von Ayrshare zurückgegebenen Konversations-IDs sind ebenfalls die Telefonnummer des Korrespondenten – es gibt keine undurchsichtigen Konversations-IDs wie bei Facebook und Instagram.
• 24-Stunden-Kundenservice-Fenster. WhatsApp Business erlaubt Freiform-Nachrichten nach außen nur innerhalb von 24 Stunden nach der letzten Nachricht des Korrespondenten. Außerhalb dieses Fensters lehnt Meta den Versand ab. Templated Messages außerhalb des 24-Stunden-Fensters werden derzeit nicht über Ayrshare unterstützt.
• Adressieren Sie einen Empfänger direkt über die API. Übergeben Sie die Telefonnummer des Empfängers an Send Message. Meta liefert eine Freiform-Nachricht nur, wenn sich dieser Empfänger innerhalb des 24-Stunden-Kundenservice-Fensters befindet. Für Cold Outreach sind genehmigte Templates erforderlich, und Ayrshare bietet derzeit kein Senden von Templates an.
• Der Zustellstatus verwendet ein einziges Feld. Sofern verfügbar, gibt Get Messages für eine gespeicherte ausgehende Nachricht status als sent, delivered, read oder failed zurück. Zustellstatus-Updates und WhatsApp-Reaktionen werden derzeit nicht an Ihre registrierte Webhook-URL gepusht.
• Medientypen und -größen folgen den von Meta veröffentlichten WhatsApp-Cloud-API-Limits – Bilder bis 5 MB, Audio und Video bis 16 MB und Dokumente bis 100 MB zum Zeitpunkt der Erstellung.

​

Unterstützte WhatsApp-Medien

• Bild: .jpg, .jpeg, .png
• Video: .mp4, .3gp
• Audio: .aac, .amr, .mp3, .m4a, .ogg
• Dokument: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx

​

Messaging in der Instagram-App aktivieren

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

• 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.
• Scrollen Sie nach unten zum Bereich How others can interact with you.
• Klicken Sie auf Messages and story replies.
• Tippen Sie auf Message requests.
• Aktivieren Sie unter Connected tool den Schalter Allow access to messages.

​

Wichtige Informationen zum Messaging

​

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

• Facebook und Instagram erlauben nur das Abrufen der letzten 20 Nachrichten aus bestehenden Konversationen, wenn Sie ein Konto erstmals für Messaging verknüpfen.
• Wenn eine Konversation mehr als 20 Nachrichten enthält, sind zunächst nur die 20 neuesten zugänglich.

​

Nach der Ersteinrichtung

• Sobald Messaging aktiviert ist, sind alle neuen Nachrichten, die gesendet und empfangen werden, vollständig zugänglich.
• Ayrshare speichert den vollständigen Konversationsverlauf ab diesem Zeitpunkt.
• Beispiel: Wenn Sie zunächst 20 Nachrichten abrufen und danach 100 neue Nachrichten ausgetauscht werden, können Sie auf insgesamt 120 Nachrichten zugreifen.

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

• 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.
• Premium Plan: Messaging ist ein pauschales $49 pro Monat-Add-on pro Konto.
• 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.
• 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.
• 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.
• Die Anzahl der gesendeten oder empfangenen Nachrichten in einer aktiven Konversation ist unbegrenzt.
• Wenn Sie das Konversationslimit erhöhen möchten, wenden Sie sich bitte an Ihren Ayrshare-Kundenbetreuer.

Sie können die aktuelle Konversationszahl über den User-Endpunkt 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 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
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:

• Die Thread-Kontrolle geht automatisch an Ayrshare zurück
• Sie sollten wieder wie gewohnt Nachrichten senden können
• Weitere Maßnahmen Ihrerseits sind nicht erforderlich

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

​

Message-Webhooks

Siehe Messages Webhooks, um Nachrichten, Lesebestätigungen oder Reaktionen automatisch zu empfangen.