DokumentationJourney OptimizerHandbuch für Journey Optimizer

Erstellen von Feedback-Webhooks für durch API ausgelöste Kampagnen webhooks

Letzte Aktualisierung: 20. Oktober 2026

Erstellt für:

  • Erfahren
  • Admin

Auf dieser Seite: Erfahren Sie, wie Sie Feedback-Webhooks erstellen und konfigurieren, die Statusaktualisierungen von Nachrichten in Echtzeit für durch API ausgelöste Transaktionskampagnen in Adobe Journey Optimizer an Ihre Systeme übermitteln.

style
shade-box

Feedback-Webhooks ermöglichen es Ihnen, Statusaktualisierungen in Echtzeit für Nachrichten zu erhalten, die über durch API ausgelöste Transaktions-Kampagnen gesendet werden. Durch die Konfiguration eines Webhooks können Sie automatisch Versandergebnisse direkt in Ihren Systemen empfangen, was Monitoring, Protokollierung und automatisierte Verarbeitung ermöglicht.

Sie können Webhook-Konfigurationen über das Menü Administration/Kanäle/Feedback-Webhook-Einstellungen verwalten.

NOTE
Pro Kombination aus Organisation und Sandbox ist nur eine Webhook-Konfiguration zulässig.

Erstellen eines Feedback-Webhooks feedback-webhook

Gehen Sie wie folgt vor, um einen Webhook zu erstellen:

  1. Navigieren Sie zu Administration/Kanäle/Feedback Webhook-Einstellungen.

  2. Klicken Sie auf Feedback-Webhook erstellen.

  3. Geben Sie im Abschnitt Grundkonfiguration die folgenden Details an:

    • Webhook-Name: Geben Sie einen beschreibenden Namen zur Identifizierung des Webhooks ein.
    • Kanäle - Wählen Sie die Kanäle aus, für die dieser Webhook Feedback erhalten soll (E-Mail und/oder Mobile).
    • Webhook-URL: Geben Sie den HTTPS-Endpunkt an, an den Feedback-Ereignisse gesendet werden sollen.

  4. Wählen Sie im Abschnitt Authentifizierung die Authentifizierungsmethode aus.

    • Keine Authentifizierung: Es werden keine Authentifizierungs-Header hinzugefügt.
    • JWT-Authentifizierung: Geben Sie die erforderlichen Details an, wenn Ihr Endpunkt eine JWT-Authentifizierung erfordert.

  5. Im Abschnitt Header-Parameter können Sie zusätzliche benutzerdefinierte Header konfigurieren, die mit jeder Webhook-Anfrage gesendet werden sollen.

  6. Klicken Sie auf Senden, um die Konfiguration zu speichern.

NOTE
Sie können einen Webhook jederzeit bearbeiten. Öffnen Sie ihn dazu im Inventar und klicken Sie auf die Schaltfläche Bearbeiten.

Webhook-Payload-Struktur

Nach der Ausführung einer Nachricht sendet Journey Optimizer die folgende Payload an den konfigurierten Endpunkt.

Informationen zur Definition der Ereignisfelder für Nachrichten-Feedback, z. B. messageExclusion, finden Sie in der Adobe Journey Optimizer-Schemareferenz.

Die Payload enthält die folgenden Details zum Kampagnen- und Mobilversand:

  • messageExecution.campaignType - Kampagnentyp: Scheduled oder ApiTriggered.
  • messageDeliveryFeedback.encoding - Vom Provider gemeldete SMS-Kodierung, z. B. GSM oder UNICODE.
  • messageDeliveryFeedback.numberOfMessageParts : Anzahl der SMS-Teile (Segmente), in die die Nachricht aufgeteilt wurde und die als Zeichenfolge gesendet wurden.
  • messageDeliveryFeedback.deliveryTimestamp - Vom Anbieter gemeldete Ereigniszeit im ISO-8601-Format.
NOTE
Die Felder encoding, numberOfMessageParts und deliveryTimestamp werden derzeit nur für den Sinch-SMS-Anbieter ausgefüllt. Felder ohne Wert werden als null gesendet.

E-Mail-Beispiel-Payload

{
  "requestId": "8NoByJneShCdCGRnrGS1t1m3CdA73dhR",
  "imsOrg": "myImsOrg",
  "sandbox": {
    "id": "068abf40-575e-11ea-8512-9b1bfdb82603",
    "name": "prod"
  },
  "channel": "email",
  "eventType": "message.feedback",
  "messageExecution": {
    "messageExecutionID": "HUMA-26362805",
    "messageType": "transactional",
    "campaignID": "16f24a15-7e21-477c-848a-d5695ca7f137",
    "campaignVersionID": "2ca10c10-56dd-4505-87cd-fa5da84e7a5d",
    "campaignType": "ApiTriggered"
  },
  "messageDeliveryFeedback": {
    "feedbackStatus": {
      "value": "bounce"
    },
    "offers": null,
    "messageExclusion": null,
    "messageFailure": {
      "category": "sync",
      "type": "Ignored",
      "code": "25",
      "reason": "Admin Failure"
    },
    "retryCount": 0,
    "encoding": null,
    "numberOfMessageParts": null,
    "deliveryTimestamp": null
  },
  "identityMap": {
    "email": [
      {
        "id": "john.doe@luma.com",
        "primary": true
      }
    ]
  }
}

SMS-Beispiel-Payload

Das folgende Beispiel zeigt ein Versandfeedback für eine SMS-Nachricht, die über Sinch gesendet wurde:

{
  "requestId": "4f1c2d9e-...",
  "imsOrg": "XXXX@AdobeOrg",
  "sandbox": {
    "id": "...",
    "name": "prod"
  },
  "channel": "sms",
  "eventType": "message.feedback",
  "channelContext": {
    "profileAddress": null,
    "profileNumber": "+15555550123"
  },
  "messageExecution": {
    "messageExecutionID": "UMA-...",
    "messageType": "marketing",
    "campaignID": "...",
    "campaignVersionID": "...",
    "messageID": "...",
    "messageProfileID": "...",
    "campaignType": "ApiTriggered"
  },
  "messageDeliveryFeedback": {
    "feedbackStatus": {
      "value": "delivered"
    },
    "offers": null,
    "messageExclusion": null,
    "messageFailure": null,
    "retryCount": null,
    "responseCode": null,
    "responseDurationMillis": null,
    "encoding": "GSM",
    "numberOfMessageParts": "2",
    "deliveryTimestamp": "2026-10-06T18:22:41.512Z"
  },
  "identityMap": {
    "Phone": [
      {
        "id": "+15555550123"
      }
    ]
  }
}

Der Webhook kann die folgenden Ereignisse erfassen:

  • Gesendet
  • zugestellt
  • Bounce (siehe obiges Beispiel)
  • Fehler

Jede eingehende Anfrage enthält auch eine eindeutige requestId, die an den Webhook zurückgesendet wird.

Nächste Schritte next

Nachdem ein Feedback-Webhook erstellt wurde, können Sie ihn bei der Konfiguration einer Zielgruppe von durch API ausgelösten Transaktionskampagnen aktivieren. Weitere Informationen finden Sie in diesem Abschnitt: Aktivieren von Webhooks

recommendation-more-help
journey-optimizer-help