Senden von Nachrichten

Um einer Person auf Messenger oder Instagram Nachrichten zu senden, muss die Unterhaltung von dieser Person initiiert werden. Es gibt unterschiedliche Typen von Nachrichten, die du über die Messenger-Plattform senden kannst. Jeder Nachrichtentyp weist eigene Richtlinien dazu auf, welche Arten von Inhalten unter welchen Bedingungen gesendet werden können.

Komponenten einer Nachricht

Alle Send API-Anfragen von deiner App zum Senden einer Nachricht müssen Folgendes enthalten:

• Die Seiten-ID der Facebook-Seite oder der Facebook-Seite, die mit dem professionellen Instagram-Konto verknüpft ist, von dem die Nachricht gesendet wird
• Die ID der Person, die die Nachricht erhält
• Einen Seiten-Zugriffsschlüssel, der von der Seite angefordert wurde, die die Nachricht sendet
• Erlaubnis von der Person, die die Nachricht erhält
• Der Nachrichtentyp
• Der Nachrichteninhalt

Weitere Informationen zu Nachrichtenkomponenten findest du in der Send API-Referenz.

Standard-Messaging-Fenster

Das Standard-Messaging-Fenster ist der 24-stündige Zeitraum, in dem du einer Person eine Nachricht schicken darfst. Wenn jemand eine Nachricht an deine Seite oder an dein professionelles Instagram-Konto sendet oder eine Unterhaltung über ein Web-Plugin beginnt, hat deine App 24 Stunden Zeit, eine Nachricht zu senden.

Nachrichten, die innerhalb des 24-Stunden-Zeitfensters gesendet werden, können Werbung enthalten.

Aktionen von Nutzer*innen, durch die das Standard-Messaging-Fenster geöffnet wird

Durch die folgenden Nutzer*innenaktionen wird das Standard-Messaging-Fenster von 24 Stunden geöffnet:

• Eine Person sendet an deine Seite oder dein professionelles Instagram-Konto eine Nachricht
• Eine Person klickt in einer Unterhaltung auf einen Call-to-Action-Button wie „Erste Schritte“
• Eine Person klickt auf eine Click-to-Messenger Ad und sendet dann an deine Seite oder dein professionelles Instagram-Konto eine Nachricht
• Eine Person sendet eine Nachricht an deine Seite über ein Plugin wie das Plugin „An Messenger senden“ oder das Kontrollkästchen-Plugin
• Eine Person klickt auf einen m.me-Link, der sie zu einer bestehenden Unterhaltung zwischen der Person und der Seite führt
• Eine Person klickt auf einen ig.me-Link, der sie zu einer bestehenden Unterhaltung zwischen der Person und dem professionellen Instagram-Konto führt
• Eine Person reagiert auf eine Nachricht, z. B. eine Marketing-Nachricht
• Eine Person kommentiert einen Beitrag auf deiner Seite oder in deinem professionellen Instagram-Konto
• Eine Person veröffentlicht einen Besucherbeitrag auf deiner Seite

Menschen erwarten bekanntlich eine prompte Antwort. Daher möchten wir dich dringend bitten, innerhalb dieses Zeitfensters von 24 Stunden so schnell wie möglich zu antworten. Nutzer*innen können Unterhaltungen jederzeit blockieren oder stummschalten.

Empfänger-IDs

Die ID einer Person, die die Nachricht erhält, wird im Objektparameter recipient festgelegt und kann einen der folgenden ID-Typen aufweisen:

• Seitenspezifische ID (PSID): eine ID, die einer Person zugewiesen wird, wenn sie zum ersten Mal eine Nachricht an deine Seite sendet. Diese eindeutige ID steht für Interaktionen zwischen deiner Seite und der Person.

• Nutzungsreferenz: eine ID, die einer Person zugewiesen wurde, die ein Plugin oder einen Postback-Button verwendet hat, um eine Nachricht an deine Seite zu senden.

• Beitrags- oder Kommentar-ID: eine ID, die einer Person zugewiesen wurde, die einen Beitrag auf deiner Seite veröffentlicht oder einen Beitrag kommentiert hat. Wird verwendet, um an eine Person eine private Antwort zu senden.

Beachte bitte, dass Nutzungs-IDs aus Facebook Login-Integrationen App-spezifisch sind und auf der Messenger-Plattform nicht verwendet werden können.

Nachrichtentypen

Der Typ von Nachricht, die du sendest, wird im Parameter messaging_type festgelegt. Mit diesem Parameter kann explizit sichergestellt werden, dass deine Nachrichten den Nachrichtenrichtlinien und den Präferenzen des*der Empfänger*in entsprechen.

Die folgenden Typen von Nachrichten werden unterstützt:

• Antwort: Die Nachricht, die du schickst, ist eine Antwort auf eine empfangene Nachricht. Die Nachricht kann Werbung und werbefreie Inhalte enthalten und muss während des Standard-Messaging-Fensters gesendet werden.

• Updates: Die gesendete Nachricht wird proaktiv gesendet und ist keine Antwort auf eine empfangene Nachricht. Die Nachricht kann Werbung und werbefreie Inhalte enthalten und muss während des Standard-Messaging-Fensters gesendet werden.

• Getaggte Nachricht: Die gesendete Nachricht wird außerhalb des Standard-Messaging-Fensters gesendet. Diese Nachricht muss ein Nachrichten-Tag enthalten, das dem zulässigen Anwendungsfall für das Tag entspricht und keinen werblichen Inhalt enthält.

Nachrichten-Tags

Mithilfe von Nachrichten-Tags kannst du eine Nachricht außerhalb des Standard-Messaging-Fensters senden. Diese Nachrichten sind persönlich relevante Informationen für eine Person. Du kannst z. B. Aktualisierungen zu Versand und Auslieferung, einer anstehenden Reservierung oder einem anstehenden Flug oder Warnungen zu einem Kund*innenkonto senden. Bei Nachrichtenabläufen, die einen Eskalationspfad erfordern, ermöglicht das Tag „Human Agent“, dass Mitarbeiter*innen manuell innerhalb von 7 Tagen auf die Nachrichten einer Person antworten.

Nachrichten-Tags können nicht für das Senden von Angeboten verwendet werden. Dies gilt unter anderem für Deals, Angebote, Coupons und Rabatte. Wenn du Nachrichten-Tags für andere als die genehmigten Anwendungsfälle einsetzt, kann die Seite oder die Fähigkeit des Instagram-Kontos, Nachrichten zu senden, eingeschränkt werden. Weitere Einzelheiten findest du in den Richtlinien zur Messenger-Plattform und zur Instagram Messaging API.

Unternehmen, die die Messenger-Plattform nutzen und außerhalb des standardmäßigen 24-Stunden-Zeitfensters für Nachrichten eine Werbenachricht senden möchten, sollten werbliche Nachrichten oder einmalige Benachrichtigungen verwenden.

Inhaltsarten

Die gesendete Nachricht kann die folgenden Inhaltsarten enthalten:

Eine einfache SMS-Nachricht senden

Um eine einfache SMS-Nachricht an eine Person zu senden, die eine Nachricht an deine Seite gesendet hat, sende eine POST-Anfrage an den /PAGE-ID/messages-Endpunkt, wobei die wörtliche Schlüssel-id des recipient-Objekts auf die seitenspezifische ID (PSID) der Person, der message_type-Parameter auf RESPONSE und das message-Parameterobjekt text auf den Nachrichtentext festgelegt sind.

Beispielanfrage

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"{PSID}"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text":"Hello, world!"
  }
}' "https://graph.facebook.com/v24.0/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"
    

Bei Erfolg erhält deine App die folgende JSON-Antwort mit der ID des*der Empfänger*in und der ID der Nachricht.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Einen Medienanhang senden

Um eine Nachricht mit Medien wie z. B. einem GIF, einem Bild oder einer Vorlage zu senden, fügst du den Inhalt der API-Anfrage in einem JSON-Nachrichtenanhangsobjekt hinzu.

Um eine Nachricht mit einem Bild an eine Person zu senden, die eine Nachricht an deine Seite gesendet hat, sende eine POST-Anfrage an den /PAGE-ID/messages-Endpunkt, wobei die wörtliche Schlüssel-id des recipient-Objekts auf die seitenspezifische ID (PSID) der Person, der message_type-Parameter auf RESPONSE, der type-Schlüssel für das attachment-Objekt des message-Parameters auf image und der url-Schlüssel des payload-Objekts auf die URL für das Bild festgelegt ist.

Beispielanfrage

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"1254459154682919"
  },
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "url":"http://www.messenger-rocks.com/image.jpg", 
        "is_reusable":true
      }
    }
  }
}' "https://graph.facebook.com/v24.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

Bei Erfolg erhält deine App die folgende JSON-Antwort mit der ID des*der Empfänger*in und der ID der Nachricht.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Beim Senden von Audio, Video oder einer Datei von einer URL wird das gleiche Format verwendet.

Du kannst auch Medien von deinem Server oder von Inhalten, die du zuvor auf einen Meta-Server hochgeladen hast, senden. Erfahre mehr über das Hochladen von Dateien mit der Attachment Upload API.

Mehrere Medienanhänge senden

Um eine Nachricht mit mehreren Bildern zu senden, fügst du den Inhalt der API-Anfrage in einem Array für JSON-Nachrichtenanhänge hinzu. Der einzige zulässige Medientyp ist ein Bild und er ist auf 30 Bilder auf einmal beschränkt.

Um eine Nachricht mit mehreren Bildern an eine Person zu senden, die eine Nachricht an deine Seite geschickt hat, sende eine POST-Anfrage an den /PAGE-ID/messages-Endpunkt, wobei die wörtliche Schlüssel-id des recipient-Objekts auf die seitenspezifische ID (PSID) der Person, der message_type-Parameter auf RESPONSE festgelegt ist und der message-Parameter ein attachments-Array enthält, wobei der type-Schlüssel des Anhangobjekts auf image und der url-Schlüssel des payload-Objekts auf die URL für das Bild festgelegt ist.

Beispielanfrage

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "1254459154682919"
  },
  "message": {
    "attachments": [
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      },
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      }
    ]
  }
}' "https://graph.facebook.com/v24.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

Bei Erfolg erhält deine App die folgende JSON-Antwort mit der ID des*der Empfänger*in und der ID der Nachricht.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Antwort auf eine Nachricht senden

Sende eine POST-Anfrage an /PAGE-ID/messages mit den folgenden Elementen, um auf eine bestimmte Nachricht im Chat zu antworten:

• Seitenspezifische ID (PSID) der Person in der wörtlichen Schlüssel-id des recipient-Objekts
• message_type gleich RESPONSE
• Deine Nachrichtendetails im message-Parameterobjekt
• ID der Chat-Nachricht, auf die du antworten möchtest, in der wörtlichen Schlüssel-reply_to des mid-Objekts

Dies Nachricht kann entweder die von deiner Seite oder dem*der Nutzer*in gesendete Nachricht sein.

Beispielanfrage

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "{PSID}",
  }
  "messaging_type": "RESPONSE"
  "message": {
    "text": "Hello, world!"      
  },
  "reply_to": {
    "mid": "{MESSAGE_ID}"
  }
}' "https://graph.facebook.com/v23.0/{PAGE-ID}/messages?access_token={PAGE_ACCESS_TOKEN}" 

Bei Erfolg erhält deine App die folgende JSON-Antwort mit der ID des*der Empfänger*in und der ID der Nachricht.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U…"
} 

Best Practices

Textnachrichten

Anhänge

Weitere Nachrichtentypen

Marketing-Nachrichten

Mithilfe von Marketing-Nachrichten kannst du eine Person um Erlaubnis bitten, mehrere Marketing-Nachrichten zu senden, nachdem das Standard-Messaging-Fenster abgelaufen ist. Wenn die Person diese Anfrage zum Erhalt dieser Benachrichtigungen akzeptiert, kannst du der Person automatisierte, regelmäßige Werbenachrichten mit Informationen zu deinen bevorstehenden Aktionen oder Produktveröffentlichungen und -aktualisierungen schicken.

News Messaging (im Entwicklungsstadium)

News Messaging ist nur für registrierte News-Publisher verfügbar, die im Facebook News Page Index (NPI) registriert sind. Mithilfe von News Messaging können Publisher werbefreie News-Nachrichten an Personen senden, die den Erhalt dieser Nachrichten abonniert haben.

News Messaging ist für die Instagram Messaging API nicht verfügbar.

Einmalige Benachrichtigungen

Mithilfe einer einmaligen Benachrichtigung kannst du eine Person um Erlaubnis bitten, eine weitere Nachricht zu senden, nachdem das Standard-Messaging-Fenster abgelaufen ist. Wenn die Person diese Anfrage zum Erhalt einer einmaligen Benachrichtigung akzeptiert, kannst du eine einmalige Nachricht senden, die zeitrelevant und von persönlicher Bedeutung ist, z. B. eine Terminerinnerung oder einen Hinweis zur Verfügbarkeit eines Produkts.

Einmalige Benachrichtigungen sind für die Instagram Messaging API nicht verfügbar.

Private Antworten

Mithilfe von privaten Antworten kannst du eine Nachricht an eine Person senden, wenn diese einen Kommentar zu einem deiner Beiträge oder einer Anzeige veröffentlicht oder einen Besucherbeitrag auf deiner Seite oder in deinem professionellen Instagram-Konto veröffentlicht. Die private Antwort kann nur aus einer einzigen Nachricht bestehen, die automatisch einen Link zu dem Beitrag oder Kommentar enthält, und muss innerhalb von sieben Tagen nach Veröffentlichung des Beitrags oder Kommentars gesendet werden.

Werbliche Nachrichten

Mithilfe von werblichen Nachrichten kannst du Werbeinhalte oder werbefreie Inhalte an eine Person senden, die zuvor eine Nachricht an deine Seite oder dein professionelles Instagram-Konto gesendet hat, nachdem das Standard-Messaging-Fenster abgelaufen ist. Werbliche Nachrichten erscheinen wie normale Nachrichten in der Unterhaltung, sind aber mit dem Wort „Anzeige“ über der Nachricht gekennzeichnet. Werbliche Nachrichteninhalte müssen die Werberichtlinien einhalten.

Werbliche Nachrichten sind für die Instagram Messaging API nicht verfügbar.

Verwaltungsnachrichten

Über Verwaltungsnachrichten kannst du eine vorab genehmigte Vorlagennachricht senden, die Bestellungen, Konto-Updates und Termine enthält. Diese Nachrichten sind besonders personalisiert mit Kontonummern, Bestellnummern, Sendungsverfolgungsnummern und Terminen. Sie können Calls to Action enthalten, über die Nutzer*innen eine Bestellung stornieren, einen Termin verschieben und andere Interaktionen mit einem Unternehmen ausführen können.

Nächste Schritte

Erfahre mehr über die Komponenten, die du zu Nachrichten in deinen Unterhaltungen hinzufügen kannst.

Mehr dazu

Erfahre mehr über das Senden von Nachrichten über die Messenger-Plattform.

• Attachment Upload API-Referenz: Erfahre mehr über das Hochladen und Senden von Medien.
• Send API-Referenz: Erfahre mehr über alle Tags, Inhalte und Anhänge, die du senden kannst.
• Durchsatzratenbegrenzungen: Erfahre mehr über die Durchsatzratenbegrenzungen für das Senden von Nachrichten über die Messenger-Plattform.