Payload-Referenz
Jede Webhook-Zustellung verwendet diese Struktur. Gemeinsame Felder sind plattformübergreifend konsistent. Plattformspezifische Felder sind unten dokumentiert.
Gemeinsame Felder (alle Plattformen)
| Feld | Typ | Beschreibung |
|---|---|---|
platform | string | "facebook" | "instagram" | "whatsapp" |
event | string | "message.received" | "conversation.started" | "status.update" |
timestamp | number | Unix-Zeitstempel (Sekunden) des Ereigniszeitpunkts |
webhook_id | string | Deine SocialHook-Webhook-Konfigurations-ID |
conversation_id | string | Stabile ID für den Konversations-Thread |
message | object | Nachrichteninhalt-Objekt (variiert je nach Plattform und Typ) |
WhatsApp-spezifische Felder
| Feld | Typ | Beschreibung |
|---|---|---|
from | string | Absender-Telefonnummer im E.164-Format (+15550001234) |
profile.name | string | WhatsApp-Anzeigename des Absenders |
message.type | string | "text" | "image" | "audio" | "video" | "document" | "location" | "sticker" |
message.body | string | Nachrichtentext (für type="text") |
message.media_url | string | URL zum Herunterladen von Medien (für image/audio/video/document) |
Facebook-spezifische Felder
| Feld | Typ | Beschreibung |
|---|---|---|
from.id | string | Facebook-Benutzer-ID des Absenders (PSID) |
from.name | string | Facebook-Anzeigename des Absenders |
page_id | string | ID der Facebook-Seite, die die Nachricht erhalten hat |
message.text | string | Textinhalt der Nachricht |
message.attachments | array | Array von Anhang-Objekten für Bilder, Videos usw. |
Instagram-spezifische Felder
| Feld | Typ | Beschreibung |
|---|---|---|
from.id | string | Instagram-Benutzer-ID des Absenders |
from.username | string | @Benutzername des Absenders |
account_id | string | ID des Instagram-Business-Kontos |
message.text | string | DM-Textinhalt |
story_id | string | Story-ID, wenn die Nachricht eine Story-Antwort ist (optional) |