Aktiviere Meta Business Agent auf einer BSP-verwalteten WhatsApp-Nummer, indem du sieben Schritte in Metas Entwicklertools durchführst: MBA-Nutzungsbedingungen im WhatsApp Manager akzeptieren, Abrechnung einrichten, einen Systembenutzer mit der Rolle Admin erstellen, deine App und WABA diesem Benutzer zuweisen, einen BISU-Token mit den erforderlichen Berechtigungen generieren, deine App für die WABA registrieren und die Webhook-Felder abonnieren, die Konversationen zwischen dem Agent und deiner Anwendung weiterleiten. Einen umfassenden Überblick über das Produkt findest du im vollständigen Leitfaden zu Meta Business Agent.
Wichtigste Erkenntnisse
- Die Einrichtung von Meta Business Agent auf einer BSP-verwalteten Nummer erfordert sieben einzelne Schritte, die jeweils vom erfolgreichen Abschluss des vorherigen abhängen.
- Der BSP oder Tech Provider muss die Tech-Provider-Nutzungsbedingungen im Facebook Developer Portal akzeptieren, bevor MBA-API-Aufrufe funktionieren.
- MBA erfordert einen BISU-Token mit den Berechtigungen
whatsapp_business_messagingundwhatsapp_business_management. Ein Token ohne eine der beiden Berechtigungen gibt einen 401-Unauthorized-Fehler zurück.[1] - Der Onboarding-API-Aufruf (
POST /{entity_id}/agent_onboarding) ist ein erforderlicher Schritt, bevor der Agent über den Settings-Endpoint konfiguriert werden kann.[2] - Teste mit
ai_audienceaufALLOWLISTED_ONLYgesetzt, bevor du live gehst. Während des Testens ist keine Zahlungsmethode erforderlich.[3]
Welche Voraussetzungen gelten für die Aktivierung von Meta Business Agent auf einer BSP-verwalteten Nummer?
Bevor du mit der Einrichtung beginnst, sammle drei IDs und stelle sicher, dass deine Telefonnummer berechtigt ist. Du benötigst eine WhatsApp Business Account (WABA) ID aus dem WhatsApp Manager, eine Business-Portfolio-ID aus der Meta Business Suite und eine App-ID aus dem Facebook Developer Portal.[1] Die App muss die Berechtigung whatsapp_business_messaging erhalten haben.
Die Telefonnummer muss alle sechs Berechtigungsbedingungen erfüllen.[4] Sie muss in einer unterstützten Branche mit einer gültigen Geschäftskategorie sein. Alle Branchen werden unterstützt, mit Ausnahme von Finanzen, Regierung, Gesundheit, Alkohol, Glücksspiel, rezeptfreien Arzneimitteln und Partnervermittlung. Die Nummer muss über Cloud API verwaltet werden, auch über einen Solution Partner oder Embedded Signup. Weder die WABA noch das zugehörige Unternehmen darf eingeschränkt oder gesperrt sein. Das Unternehmen muss sich in einem für MBA autorisierten Land befinden und die Vertrauens- und Verifizierungsanforderungen erfüllen.
Prüfe die Berechtigung programmatisch mit GET /{phone_number_id}/agent_eligibility unter Verwendung des Headers X-API-Version: 2.0.0.[4] Die vollständige Liste der Bedingungen findest du in der Berechtigungs-Checkliste.
MBA-Nutzungsbedingungen akzeptieren
Akzeptiere die MBA-Nutzungsbedingungen im WhatsApp Manager, indem du zur entsprechenden WABA navigierst und den Tab Meta Business Agent öffnest. Dieser Tab erscheint nur, wenn mindestens eine Telefonnummer in der WABA berechtigt ist.[1] Wähle die berechtigten Nummern aus und schließe die Annahme ab. Der Agent ist nach diesem Schritt noch nicht aktiviert.
Bei BSP-verwalteten Nummern sind zwei Annahmen erforderlich. Der Kunde akzeptiert die MBA-Nutzungsbedingungen im WhatsApp Manager. Der BSP oder Tech Provider muss die Tech-Provider-Nutzungsbedingungen separat akzeptieren, indem er sich als Tech Provider im Facebook Developer Portal registriert.[1] Meta Business Agent lehnt API-Aufrufe ab, bis beide Annahmen registriert sind.
Abrechnung für Meta Business Agent einrichten
Richte eine Zahlungsmethode in Metas Billing Hub ein, bevor du den Agent für den Produktivbetrieb aktivierst. Nachrichten werden nicht zugestellt, wenn das Konto keine Zahlungsmethode hinterlegt hat.[1] Navigiere zu business.facebook.com/latest/billing_hub/ und füge eine Zahlungsmethode für das Business Portfolio hinzu, das mit der WABA verknüpft ist.
Die Aktivierung des Agents mit ai_audience auf ALLOWLISTED_ONLY erfordert keine Zahlungsmethode.[3] Eine Zahlungsmethode ist erst erforderlich, wenn du auf EVERYONE erweiterst.
Systembenutzer erstellen und konfigurieren
Erstelle einen Systembenutzer mit der Rolle Admin in der Meta Business Suite und weise diesem Benutzer dann sowohl die App als auch die WABA zu. MBA-API-Anfragen authentifizieren sich als Systembenutzer.[1] Falls bereits ein passender Systembenutzer existiert, springe direkt zur Asset-Zuweisung.
Gehe zur Meta Business Suite (business.facebook.com/settings/), öffne Einstellungen, wähle unter Benutzer den Punkt Systembenutzer, klicke auf + Hinzufügen, gib einen Namen ein, wähle die Rolle Admin und klicke auf Systembenutzer erstellen.
Um Assets zuzuweisen, wähle den Systembenutzer aus, klicke auf das Drei-Punkte-Menü und dann auf Assets zuweisen. Wähle Apps, finde die App und aktiviere das Kontrollkästchen. Finde dann die WABA, aktiviere das Kontrollkästchen und klicke auf den Schieberegler neben Telefonnummern anzeigen und verwalten. Klicke auf Assets zuweisen, um zu speichern.
Wenn du mehrere WABAs verwaltest und Hilfe bei der Konfiguration von Systembenutzern benötigst, sprich mit 360Dialog über die Vereinfachung des Prozesses durch eine einzige Partner-Integration.
BISU-Token mit den erforderlichen Berechtigungen generieren
Generiere einen Business Integration System User (BISU) Token für den Systembenutzer. Ein BISU-Token ermöglicht es deiner Plattform, im Namen mehrerer Kunden-WABAs mit einer einzigen Berechtigung zu agieren.[1] Meta dokumentiert zwei Token-Optionen: einen Standard-Systembenutzer-Token für Direktintegratoren und einen BISU-Token für Solution Partners und Tech Providers.
MBA erfordert einen BISU-Token mit den Berechtigungen whatsapp_business_messaging und whatsapp_business_management. Ein Token ohne eine der beiden Berechtigungen gibt einen 401-Unauthorized-Fehler zurück.[5] Dies ist der häufigste Fehlerpunkt bei der Einrichtung. Stelle sicher, dass beide Berechtigungen ausgewählt sind, bevor du den Token generierst.
Füge den Header X-API-Version: 2.0.0 bei jeder MBA-API-Anfrage hinzu.[1] Anfragen ohne diesen Header verwenden standardmäßig Version 1.0.0, in der der Skills-Endpoint nicht verfügbar ist.
Das Partner-Support-Team von 360Dialog kann deine Token-Konfiguration prüfen, bevor du auf einen 401-Fehler stößt.
Erforderliche Webhook-Felder abonnieren
Registriere deine App für die WABA und konfiguriere die drei erforderlichen Webhook-Felder, die deine App mit der Konversations-Pipeline verbinden.[1]
Registriere zunächst die App für die WABA. Wähle im Graph API Explorer die App, wähle Get App Token, wähle das Business Portfolio und die WABA und sende dann POST /{WABA_ID}/subscribed_apps. Verifiziere mit GET /{WABA_ID}/subscribed_apps.
Abonniere anschließend die Webhook-Felder im Facebook Developer Portal. Öffne die App, navigiere zum WhatsApp-Tab und öffne Configuration. Abonniere drei Felder: messages, standby und messaging_handovers.[1]
Diese Felder steuern das Konversations-Routing zwischen MBA und deiner Anwendung. MBA agiert als primärer Responder. Deine Partner-App empfängt Verbrauchernachrichten über den standby-Webhook, solange der Agent die Kontrolle hält, und über den messages-Webhook, wenn deine App die Kontrolle hält. Der messaging_handovers-Webhook wird bei jedem Kontrollwechsel ausgelöst. Deine Partner-App übernimmt die Kontrolle, indem sie eine Nachricht in die Konversation sendet oder Thread Control mit der Aktion take aufruft (beschränkt auf den konfigurierten Eskalationspartner). Um die Kontrolle zurückzugeben, rufe Thread Control mit der Aktion release auf. Das Einstellen des Nachrichtenversands gibt die Kontrolle nicht frei – der release-Endpoint muss explizit aufgerufen werden.
Einen detaillierten Blick auf die Änderungen beim Konversations-Routing findest du unter Was sich für deine BSP-Integration ändert.
Als BSP, der die WhatsApp Business API-Infrastruktur für Kundenkonten verwaltet, unterstützt 360Dialog als Official Meta Solution Partner den vollständigen MBA-Aktivierungspfad für Nummern, die über seine Plattform verwaltet werden.
Wenn deine Plattform bereit für die MBA-Einrichtung ist, starte mit der API, um auf der WhatsApp Business API-Infrastruktur von 360Dialog aufzubauen.
Wissen, Skills und Connectors des Agents konfigurieren
Konfiguriere den Agent über drei API-Phasen: Onboard, Configure und Operate. Das Minimum zur Aktivierung des Agents ist der Aufruf des Onboarding-Endpoints und anschließend des Settings-Endpoints.[1]
Beginne mit der Onboarding-API: Sende POST /{entity_id}/agent_onboarding mit einem leeren Body für WhatsApp.[2] Dies gibt eine agent_id zurück und erstellt die Agent-Konfiguration. Bis dieser Aufruf erfolgreich ist, meldet jeder andere MBA-Endpoint, dass kein Agent für die Entität existiert.
Nach dem Onboarding konfiguriere das Wissen über die dedizierten Endpoints: Skills (Systemanweisungen), Business-Informationen (Öffnungszeiten, Standorte, Richtlinien), FAQs, Websites (URLs, die der Agent crawlen soll), Files (hochgeladene Wissensquellen), Connectors (externe API-Definitionen) und Connector-Tools.[1] Der Produktkatalog wird separat im Meta Commerce Manager verwaltet.
Konfiguriere das Übergabeverhalten über den Settings-Endpoint. Der Boolean handoff.enabled steuert, ob der Agent die Thread-Kontrolle nach einer Übergabenachricht freigibt. Das Feld message_selection unterstützt drei Modi: CUSTOM (das Unternehmen liefert die Nachricht), AGENT (KI verfasst sie pro Konversation) und DEFAULT (feste Standardnachricht).[3]
Meta Business Agent vor dem Livegang testen
Teste mit einer eingeschränkten Zielgruppe, bevor du den Agent echten Kunden aussetzt. Die korrekte Reihenfolge ist: Testkonsumenten zur Erlaubnisliste hinzufügen, ai_audience auf ALLOWLISTED_ONLY setzen und dann den Agent aktivieren.[1] Wenn du den Agent aktivierst, bevor du die Zielgruppe einschränkst, wird er Live-Konversationen ausgesetzt.
Füge Testtelefonnummern hinzu, indem du POST /{entity_id}/agent_config/allowlist mit consumer_phone_number im E.164-Format aufrufst.[1] Liste Einträge mit GET auf und entferne sie mit DELETE am selben Endpoint.
Aktiviere den Agent, indem du PUT /{entity_id}/agent_config/settings mit rollout.enabled auf true gesetzt aufrufst.[3] Meta stellt außerdem eine Agent Test API unter /{entity_id}/agent_test bereit, die Testnachrichten synchron durch die gesamte Pipeline sendet, ohne dass der Agent aktiviert sein muss und ohne die verbrauchten Tokens abzurechnen.[5]
Bevor du ai_audience auf EVERYONE umstellst, prüfe die Webhook-Abonnements mit GET /{WABA_ID}/subscribed_apps, verifiziere die Einstellungen mit GET /{entity_id}/agent_config/settings, hinterlege eine Zahlungsmethode im Billing Hub und validiere die Übergabelogik, indem du eine Eskalation über die Agent Test API auslöst.[1] Überwache den Agent-Insights-Endpoint, um zu prüfen, welche Wissensquellen und Skills der Agent während der Testkonversationen nutzt. Das Deaktivieren des Agents stoppt Antworten in allen aktiven Threads. Eine Reaktivierung bewirkt, dass er nur auf neue Threads antwortet.[3]
360Dialog-Kunden erhalten dedizierten Partner-Support bei jedem Schritt der MBA-Einrichtung, von der Token-Konfiguration bis zum Go-live. Mit API starten, um loszulegen.
Häufig gestellte Fragen
Kann ich Meta Business Agent mit einer BSP-verwalteten Nummer verwenden?
Ja. Meta Business Agent funktioniert mit Nummern, die über einen BSP oder Tech Provider verwaltet werden, solange die Nummer Cloud API nutzt. Der BSP oder Tech Provider muss die Tech-Provider-Nutzungsbedingungen im Facebook Developer Portal akzeptieren, und der BISU-Token muss die Berechtigungen whatsapp_business_messaging und whatsapp_business_management enthalten.
Funktioniert Meta Business Agent in allen Branchen?
MBA unterstützt alle Branchen mit Ausnahme von Finanzen, Regierung, Gesundheit, Alkohol, Glücksspiel, rezeptfreien Arzneimitteln und Partnervermittlung. Die Telefonnummer muss außerdem eine gültige Geschäftskategorie im WhatsApp Manager hinterlegt haben. Prüfe die Berechtigung mit GET /{phone_number_id}/agent_eligibility und dem Header X-API-Version: 2.0.0, bevor du mit der Einrichtung beginnst.
Was passiert, wenn dem BISU-Token eine Berechtigung fehlt?
Ein BISU-Token ohne die Berechtigung whatsapp_business_messaging oder whatsapp_business_management gibt einen 401-Unauthorized-Fehler bei MBA-API-Aufrufen zurück. Generiere den Token mit beiden Berechtigungen neu. Dies ist der häufigste Fehlerpunkt bei der MBA-Einrichtung – prüfe daher beide Berechtigungen, bevor du einen API-Aufruf ausführst.
Muss ich die Abrechnung vor dem Testen einrichten?
Die Aktivierung des Agents mit ai_audience auf ALLOWLISTED_ONLY erfordert keine Zahlungsmethode. Eine Zahlungsmethode ist erst erforderlich, wenn du ai_audience auf EVERYONE für den Produktivbetrieb umstellst. Die Agent Test API unter /{entity_id}/agent_test sendet ebenfalls Testnachrichten, ohne die verbrauchten Tokens abzurechnen.
Was ist der Unterschied zwischen den Thread-Control-Aktionen Release, Pass und Take?
Die Aktion release gibt die Kontrolle von der Partner-App an MBA zurück. Die Aktion pass überträgt die Kontrolle an den Eskalationspartner oder an MBA, wenn control_pass.target_role auf ai_agent gesetzt ist. Die Aktion take ist auf den konfigurierten Eskalationspartner beschränkt und übernimmt die Kontrolle über die Konversation direkt.
Quellen
[1] „Get started,“ Meta for Developers, abgerufen am 14. September 2026, https://developers.facebook.com/documentation/meta-business-agent/get-started.
[2] „Agent Onboarding,“ Meta for Developers, abgerufen am 14. September 2026, https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-onboarding.
[3] „Agent Settings,“ Meta for Developers, abgerufen am 14. September 2026, https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-settings.
[4] „Overview,“ Meta for Developers, abgerufen am 14. September 2026, https://developers.facebook.com/documentation/meta-business-agent/overview.
[5] „Quickstart,“ Meta for Developers, abgerufen am 14. September 2026, https://developers.facebook.com/documentation/meta-business-agent/quickstart.
