AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Facebook-Mention-Webhook: wenn jemand Ihre Seite erwähnt

Das Feld mention der Seiten-Webhooks von Facebook benachrichtigt eine App, wenn jemand die Seite in einem Beitrag oder Kommentar mit @ erwähnt. Meta sendet einen Eintrag in changes mit field auf mention, dessen value post_id, bei einem Kommentar comment_id, den Text in message, angehängte Links und Medien sowie item und verb enthalten kann, in einem POST, der mit X-Hub-Signature-256 signiert ist.

easyCoexistence abonniert jede Seite, die Sie verbinden, für das Feld mention, neben feed und messages, und leitet deren Erwähnungsereignisse bei Eintreffen an Ihren HTTPS-Endpoint weiter, signiert mit einem Geheimnis für diese Seite und ohne gespeicherte Kopie, damit Ihr Agent von jeder Erwähnung erfährt, sobald sie geschieht.

mention

Webhook-Feld der Seite für neue Erwähnungen einer Seite, auch in Kommentaren und Beiträgen.

pages_manage_metadata

Berechtigung, die ein Seiten-Admin mit MODERATE-Rechten erteilen muss, bevor Seiten-Webhooks die Callback-URL einer App erreichen.

@ + name

So erwähnen Personen eine Seite in einem Beitrag oder Kommentar: @ eingeben und den Namen der Seite, dann auswählen.

36 hours

Wie lange Meta eine fehlgeschlagene Seitenbenachrichtigung mit abnehmender Häufigkeit erneut sendet, bevor sie verworfen wird.

tagged_time

Feld, das der Edge /{page-id}/tagged jedem öffentlichen Beitrag hinzufügt, in dem die Seite markiert wurde.

Was löst den Mention-Webhook aus?

Eine Person erwähnt die Seite in einem Beitrag oder Kommentar. Auf Facebook erfolgt eine Erwähnung, indem man @ und den Namen der Seite eingibt und in den Vorschlägen auswählt. Meta beschreibt das Feld in der Referenz als neue Erwähnungen einer Seite, auch in Kommentaren und Beiträgen. Das Hilfe-Center von Facebook weist darauf hin, dass Einstellungen einer Seite verhindern können, dass Personen sie erwähnen.

Wie sieht eine Erwähnungsbenachrichtigung aus?

Ein POST mit object gleich page und einem Eintrag für die erwähnte Seite: deren ID, eine Zeit und ein changes-Array, dessen field mention ist. Die Meta-Referenz listet die Felder des value auf, gibt aber kein Beispiel an. Daher ist diese Erwähnung in einem Beitrag aus dieser Liste nachgebildet:

A mention in a post, from the fields in Meta's reference
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1793520000,
      "changes": [
        {
          "field": "mention",
          "value": {
            "item": "post",
            "verb": "add",
            "post_id": "<POST_ID>",
            "message": "<TEXT_WITH_THE_MENTION>"
          }
        }
      ]
    }
  ]
}

Was bedeutet jedes Feld einer Erwähnung?

Dies sind die Felder des value in der Meta-Referenz. Welche davon eine Benachrichtigung enthält, hängt vom Beitrag oder Kommentar ab:

  • post_id: die ID des Beitrags, der die Seite erwähnt hat.
  • comment_id: die ID des Kommentars, wenn die Erwähnung in einem Kommentar steht; parent_id: die ID von dessen übergeordnetem Element.
  • message: der Text, der die Erwähnung enthält.
  • link, photo, photos und video: Links zu dem, was der Beitrag oder Kommentar angehängt hat.
  • item und verb: die Art des Objekts und was damit geschehen ist, aus denselben Listen, die das Feld feed verwendet.
  • created_time: wann der Beitrag oder Kommentar erstellt wurde.
  • from und message_tags: der Autor und die im Text markierten Profile, beide nur als Workplace-Felder markiert.
  • Ebenfalls aufgeführt: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id und open_graph_story_id.

Welche Berechtigung braucht das Feld mention?

pages_manage_metadata. Meta verlangt, dass ein Seiten-Admin mit MODERATE-Rechten sie erteilt, bevor Seiten-Webhooks eine App erreichen. Die Seite wird über POST /{page-id}/subscribed_apps abonniert, wobei mention in subscribed_fields steht. Dafür braucht man ein Seiten-Token von jemandem mit der Aufgabe CREATE_CONTENT, MANAGE oder MODERATE, mit pages_manage_metadata und pages_show_list. Auch die App abonniert mention, denn nur Felder, die auf beiden Ebenen abonniert sind, werden zugestellt. Seiten, die von Personen ohne Rolle in der App betrieben werden, brauchen diese Berechtigungen im Advanced Access.

Wie liest man den Beitrag oder Kommentar, der die Seite erwähnt?

Über seine ID, mit dem Token der Seite, sofern Meta es erlaubt. Ein Seiten-Token liest Beiträge, die auf der Seite oder von ihr veröffentlicht wurden. Öffentlich geteilte Beiträge anderer Seiten brauchen pages_manage_posts und das Feature Page Public Content Access, mit einem Token eines Seiten-Admins. Und Meta bindet das Lesen eines persönlichen Beitrags an die Berechtigung user_posts dieser Person.

Looking up the post or the comment
GET https://graph.facebook.com/<POST_ID>
  ?fields=message,permalink_url,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

GET https://graph.facebook.com/<COMMENT_ID>
  ?fields=message,from,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

Wo sonst kann eine Seite ihre Erwähnungen finden?

Im Edge tagged. GET /{page-id}/tagged listet die öffentlichen Beiträge, in denen die Seite markiert wurde, jeweils mit einer tagged_time. Das umfasst auch Beiträge aus der Zeit vor der Einrichtung des Webhooks. Dafür braucht man ein Seiten-Token von jemandem mit der Aufgabe CREATE_CONTENT, MANAGE oder MODERATE, mit pages_read_user_content und pages_show_list. Meta sagt, dass das Feature Page Public Content Access erforderlich sein kann. Bei einem persönlichen Beitrag liefert Meta das Feld from nur an die Person, die ihn geschrieben hat.

Wie stellt easyCoexistence Erwähnungsereignisse zu?

Beim Verbinden jeder Seite abonniert es mention neben feed und messages. Seine App prüft X-Hub-Signature-256 bei jeder Zustellung, antwortet Meta sofort und sendet jeden Eintrag für die Seite unverändert an den HTTPS-Endpoint, den Sie mit set_social_webhook_destination oder PUT /channels/:id/webhook in der Partner API setzen:

  • X-EC-Signature enthält t=<unix>,v1=<hex>: den HMAC-SHA256 aus dem Zeitstempel, einem Punkt und dem rohen Body, mit dem Signaturgeheimnis der Seite als Schlüssel.
  • Das Geheimnis beginnt mit whsec_ und wird nur einmal angezeigt. Setzt man die URL erneut, wird ein neues ausgegeben; eine null-URL beendet die Weiterleitung.
  • Jeder Eintrag wird einmal gesendet, mit bis zu 8 Sekunden Wartezeit, an eine HTTPS-Adresse, die auf eine öffentliche IP auflöst, ohne Weiterleitungen zu folgen und ohne Kopie zu speichern.
A forwarded mention, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>

{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793520000,
    "changes": [
      {
        "field": "mention",
        "value": {
          "item": "post",
          "verb": "add",
          "post_id": "<POST_ID>",
          "message": "<TEXT_WITH_THE_MENTION>"
        }
      }
    ]
  }
}

Häufige Fehler

  • entry.time für den Zeitpunkt der Erwähnung halten. Meta setzt es auf den Zeitpunkt, zu dem die Benachrichtigung gesendet wurde; created_time im value datiert den Beitrag oder Kommentar.
  • Eine fehlgeschlagene Abfrage als defektes Ereignis behandeln. Meta warnt, dass manche post_id- und comment_id-Werte in Erwähnungsbenachrichtigungen aus Berechtigungs- oder Datenschutzgründen nicht abfragbar sind. Behalten Sie daher den Nachrichtentext aus dem Ereignis selbst.
  • Den Beitrag abrufen, bevor die Weiterleitung beantwortet ist. Weiterleitungen werden nicht wiederholt. Geben Sie also sofort einen 2xx-Code zurück und schlagen Sie den Beitrag danach nach.
Mit EasyCoexistence

Ab US$ 9 pro Verbindung und Monat, sinkend auf US$ 0.75 mit jeder weiteren Verbindung, mit 3 Tagen kostenloser Testphase.

Häufig gestellte Fragen

Sagt der Mention-Webhook, wer die Seite erwähnt hat?

Für eine Seite nicht: Metas Referenz markiert from nur als Workplace-Feld. Die Abfrage von Beitrag oder Kommentar über seine ID kann dessen Autor liefern, soweit es die Berechtigungen von Meta erlauben.

Kann ich Erwähnungen von vor der Abonnierung der Seite erhalten?

Nicht über den Webhook, da Meta keinen Benachrichtigungsverlauf zum Abfragen führt. Der Edge tagged listet die öffentlichen Beiträge, in denen die Seite markiert wurde.

Worin unterscheidet sich das Feld mention von feed?

feed meldet Änderungen auf dem eigenen Feed der Seite, etwa Beiträge, Kommentare und Reaktionen dort; mention meldet, dass die Seite in einem Beitrag oder Kommentar erwähnt wird. Jedes Feld wird einzeln abonniert.

Wirken die Kommentarregeln von easyCoexistence auf Erwähnungen?

Nein. Regeln und Automationen wirken auf Kommentare aus dem Feld feed und auf Messenger-Nachrichten; Änderungen mit mention werden genau so an Ihren Endpoint weitergeleitet, wie Meta sie gesendet hat.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am