messages
Dieser Rückruf tritt auf, wenn eine Nachricht an deine Seite gesendet wurde. Nachrichten werden immer nacheinander gesendet. Du kannst SMS-Nachrichten oder Nachrichten mit Anhängen erhalten.
Es werden hauptsächlich die Anhangstypen image
, audio
, video
, file
und reel
unterstützt. Du erhältst möglicherweise auch fallback
-Anhänge. Ein gängiges Beispiel für einen „Fallback“ ist, wenn ein*e Nutzer*in eine URL mit einer Seite teilt und ein Anhang auf Grundlage des Teilen von Links erstellt wird. Wenn das Teilen durch eine*n Nutzer*in mit deiner Seite nicht unterstützt wird, wird möglicherweise ein fallback
ohne Payload gesendet.
Du kannst diesen Rückruf abonnieren, indem du message
beim Setup deines Webhooks auswählst.
{ "sender":{ "id":"<PSID>" }, "recipient":{ "id":"<PAGE_ID>" }, "timestamp":1458692752478, "message":{ "mid":"mid.1457764197618:41d102a3e1ae206a38", "text":"hello, world!", "quick_reply": { "payload": "<DEVELOPER_DEFINED_PAYLOAD>" } } }
{ "sender":{ "id":"<PSID>" }, "recipient":{ "id":"<PAGE_ID>" }, "timestamp":1458692752478, "message":{ "mid":"m_1457764197618:41d102a3e1ae206a38", "text":"hello, world!", "reply_to": { "mid":"m_1fTq8oLumEyIp3Q2MR-aY7IfLZDamVrALniheU" } } }
{
"id": "682498302938465",
"time": 1518479195594,
"messaging": [
{
"sender": {
"id": "
Der Nachrichten-Webhook mit Produktvorlagen ist erst ab Version 8.0 der Graph API verfügbar.
Dieser Webhook wird bei einem Szenario angewendet, bei dem ein*e Nutzer*in Produkte aus anderen Threads oder einem Teilen-Vorgang mit der Seite teilt. Dieser Webhook ist auf Produkte beschränkt, die der Seite gehören. Die App benötigt eine Genehmigung für die Berechtigung catalog_management
, um Produktdetails über Webhooks abzurufen.
{
"id": "682498302938465",
"time": 1518479195594,
"messaging": [
{
"sender": {
"id": "
Beispiel gilt für messages
ab Version 6.0
{ "object": "page", "entry": [ { "id": "<PAGE_ID>", "time": 1583173667623, "messaging": [ { "sender": { "id": "<PSID>" }, "recipient": { "id": "<PAGE_ID>" }, "timestamp": 1583173666767, "message": { "mid": "m_toDnmD...", "text": "This is where I want to go: https:\/\/youtu.be\/bbo_fZAjIhg", "attachments": [ { "type": "fallback", "payload": { "url": "<ATTACHMENT_URL >", "title": "TAHITI - Heaven on Earth" } } ] } } ] } ] }
Der Nachrichten-Webhook von der Shops-Produktdetailseite ist erst ab Version 8.0 der Graph API verfügbar.
{ "sender":{ "id":"<PSID>" }, "recipient":{ "id":"<PAGE_ID>" }, "timestamp":1458692752478, "message":{ "mid":"mid.1457764197618:41d102a3e1ae206a38", "text":"hello, world!", "referral": { "product": { "id":"<PRODUCT_ID>" } } } }
{ "object": "page", "entry": [ { "id": "<PAGE_ID>", "time": 1697643211842, "messaging": [ { "sender": { "id": "<PSID>" }, "recipient": { "id": "<PAGE_ID>" }, "timestamp": 1697643027400, "message": { "mid": "m_3vs...", "text": "find flights from SFO to LAX next Thursday", "commands": [ { "name": "flights" } ] } } ] } ] }
sender
sender Field | Description |
---|---|
| The Page-scoped ID for the person who sent a message to your business |
| The reference for a person who used the Chat Plugin to messsage your business |
recipient
recipient Field | Description |
---|---|
| The ID for your Facebook Page |
message
Ab Version 6.0 wurde sticker_id
von message
zu message.attachments.payload
verschoben.
Eigenschaft | Typ | Beschreibung |
---|---|---|
| String | Nachrichten-ID |
| String | Text der Nachricht |
| Objekt | Optionale selbstdefinierte Daten, die von der sendenden App bereitgestellt werden. |
| Objekt | Verweis auf die Nachrichten-ID (Message ID, mid), auf die diese Nachricht antwortet. |
| Array< | Array mit Anhangsdaten. |
| Objekt | Weiterleitung der Nachricht von der Shops-Produktdetailseite. |
message.quick_reply
Eine quick_reply
-Payload wird nur dann mit einer Textnachricht bereitgestellt, wenn der*die Nutzer*in auf einen Schnellantwort-Button tippt.
Eigenschaft | Typ | Beschreibung |
---|---|---|
| String | Von der App bereitgestellte personalisierte Daten. |
message.reply_to
Eigenschaft | Typ | Beschreibung |
---|---|---|
| String | Verweis auf die Nachrichten-ID, auf die diese Nachricht antwortet. |
message.attachments
Eigenschaft | Typ | Beschreibung |
---|---|---|
| String |
|
| String |
message.attachments.payload
Eigenschaft | Typ | Beschreibung |
---|---|---|
| String | Die URL des Anhangstyps. Bezieht sich auf die folgenden Anhangstypen: |
| String | Titel des Anhangs. Bezieht sich auf die folgenden Anhangstypen: |
| Zahl | Beständige ID dieses Stickers. |
| Zahl | ID des Videos, das mit dem angehängten Reel verbunden ist. Bezieht sich auf den folgenden Anhangstyp: |
message.attachments.payload.product.elements
Eigenschaft | Typ | Beschreibung |
---|---|---|
| String | Produkt-ID aus dem Facebook-Produktkatalog. |
| String | Externe ID, die mit dem Produkt verknüpft ist (z. B. SKU/Content-ID). |
| String | URL des Produkts. |
| String | Titel des Produkts. |
| String | Untertitel des Produkts |
message.referral
referral
-Payload wird nur bereitgestellt, wenn der*die Nutzer*in eine Nachricht von der Shops-Produktdetailseite sendet.
Eigenschaft | Typ | Beschreibung |
---|---|---|
| Objekt | Produktinformationen. |
message.referral.product
Eigenschaft | Typ | Beschreibung |
---|---|---|
| String | Produkt-ID. |
message.commands
Eigenschaft | Typ | Beschreibung |
---|---|---|
| String | Der Name des Befehls. |