WhatsApp Business Management API

Webhook-Einrichtung

Abonniere Webhooks, um bei Änderungen an den Einstellungen deines WhatsApp Business-Kontos und Qualitätssignalen Benachrichtigungen zu erhalten.

Die Einrichtung von Webhooks hat keine Auswirkungen auf die Telefonnummer in deiner WhatsApp Business-App. Sobald du deine Telefonnummer über die WhatsApp Business-Plattform migriert hast, kannst du diese Nummer nicht mehr in der WhatsApp Business-App verwenden.

Erstellen eines Endpunkts

Bevor du Benachrichtigungen empfangen kannst, musst du auf deinem Server einen Endpunkt für den Empfang von Benachrichtigungen erstellen.

Dein Endpunkt muss zwei Arten von HTTPS-Anfragen verarbeiten können: Verifizierungsanfragen und Event-Benachrichtigungen. Da beide Anfragen HTTPS verwenden, muss dein Server über ein korrekt konfiguriertes und installiertes TLS- oder SSL-Zertifikat verfügen. Selbstsignierte Zertifikate werden nicht unterstützt.

Erfahre mehr über Verifizierungsanfragen und Event-Benachrichtigungen

Webhooks abonnieren

Um Webhooks zu abonnieren, benötigst du eine Meta-App-ID und Berechtigungen. Gehe dafür zum Dashboard der Meta-App. Dort tust du Folgendes:

  1. Eine Meta-App im Meta-App-Dashboard erstellen
  2. Das Webhooks-Produkt im App-Dashboard zu deiner Meta-App hinzufügen

    Jede Meta-App kann nur einen konfigurierten Endpunkt zur selben Zeit haben. Wenn du deine Webhook-Updates an mehrere Endpunkte senden musst, brauchst du mehrere Meta-Apps.

Wenn du bereit bist, deine Nachrichten für Unternehmen zu skalieren, musst du unter Umständen folgende Aufgaben ausführen:

  1. Die Berechtigung whatsapp_business_management in deinem App-Dashboard hinzufügen
  2. Den App Review von Meta erfolgreich abschließen  – Dieser Schritt erfordert Zeit, jedoch kannst du während des gesamten Review-Prozesses weiter testen.

Verfügbare Abonnementfelder

Verfügbare Abonnementfelder

Name des Feldes Beschreibung

account_review_update

Wenn ein WhatsApp Business-Konto überprüft wurde, erhältst du eine Benachrichtigung.

account_update

Wenn bei deinem WhatsApp Business-Konto eine Änderung vorgenommen wurde, erhältst du eine Benachrichtigung. Diese Änderung kann beispielsweise eine Aktualisierung der Telefonnummer, ein Richtlinienverstoß, die Sperrung eines WhatsApp Business-Kontos sein und mehr.

business_capability_update

Wenn eine Funktion aktualisiert wurde, erhältst du eine Benachrichtigung. Das kann eine Änderung bei der maximal zulässigen Anzahl von Telefonnummern, über die ein WhatsApp Business-Konto verfügen kann, oder von Unterhaltungen pro Telefonnummer sein.

message_template_status_update

Wenn die Nachrichtenvorlage genehmigt bzw. abgelehnt oder deaktiviert wurde, erhältst du eine Benachrichtigung.

messages

Du erhältst eine Benachrichtigung, wenn dein Unternehmen eine Nachricht von einem*einer Kund*in erhalten hat, wenn du eine Nachricht an eine*n Kund*in sendest, wenn eine Nachricht an eine*n Kund*in zugestellt wird und wenn deine Nachricht von einem*einer Kund*in gelesen wurde.

phone_number_name_update

Wenn der mit einer Telefonnummer verknüpfte Name genehmigt oder abgelehnt wurde, erhältst du eine Benachrichtigung.

phone_number_quality_update

Wenn der Qualitätsstatus einer Telefonnummer aktualisiert wurde, erhältst du eine Benachrichtigung.

security

Eine Benachrichtigung wird an dich gesendet, wenn:

  • du beantragst, dass die Verifizierung in zwei Schritten deaktiviert wird
  • die Verifizierung in zwei Schritten deaktiviert ist
  • die Verifizierung in zwei Schritten aktualisiert wird

    • In der Referenz zu Webhooks für WhatsApp Business-Konten findest du weitere Informationen zu den einzelnen Payload-Feldern. In der Referenz zu Webhooks für WhatsApp Cloud API findest du weitere Informationen zu den verschiedenen Arten von messages-Benachrichtigungen, die du erhalten kannst.

    Benachrichtigungs-Payload

    Alle Benachrichtigungen haben das folgende allgemeine Format:

    [{
    "object": "whatsapp_business_account",
    "entry": [{
       "id": "{whatsapp-business-account-id}",
        "time": {unix-timestamp},
        "changes": [{
            "field": "{subscribed-field}",
            "value": {
                # Information that was update
            }
          }]
      }]
  }]

    Das Array auf oberster Ebene enthält zwei Hauptobjekte:

    ParameterBeschreibung

    object

    Dies ist das Objekt, das abonniert wurde.

    entry

    Das Objekt enthält die Details der Änderung, die den Webhooks-Aufruf ausgelöst hat.

    Alle verfügbaren Webhook-Objekte findest du unter Komponenten.

    Beispiele für App-Endpunkte