Wenn Meta Business Agent für eine WhatsApp-Nummer aktiviert wird, die über einen Business Solution Provider (BSP) verwaltet wird, ist die Partner-App nicht mehr die primäre Antwortinstanz: Nachrichten von Konsumenten laufen über das standby-Webhook-Feld, solange der Agent die Kontrolle hält. Die App erhält die Kontrolle zurück, indem sie eine Nachricht sendet, oder, als konfigurierter Eskalationspartner, indem sie Thread Control mit der take-Aktion aufruft.[1] Drei Webhook-Felder übertragen den Traffic, zwei Nutzungsbedingungen (Terms of Service) gelten für jeden API-Aufruf, und Meta stellt dem Unternehmen direkt 2,00 USD pro 1 Million Tokens in Rechnung. Der Mechanismus ist auf Metas Entwicklerseiten dokumentiert und kann an zugelassenen (allowlisted) Nummern getestet werden, bevor ein echter Konsument den Agenten erreicht.
Die wichtigsten Punkte
- Meta Business Agent benötigt drei Webhook-Feld-Abonnements (messages, standby und messaging_handovers). Nachrichten von Konsumenten wechseln zu standby, solange der Agent die Kontrolle hält.
- Deine App übernimmt die Kontrolle, indem sie eine beliebige Nachricht sendet, und behält sie, bis sie Thread Control mit der release-Aktion aufruft. In Metas Worten: „Stopping message sends does not release control.“
- Zwei Nutzungsbedingungen gelten für jeden API-Aufruf: die des Kunden im WhatsApp Manager und die des BSP im Facebook Developer Portal.
- Solution Partners und Tech Provider authentifizieren sich mit einem Business Integration System User (BISU)-Token, das beide erforderlichen Berechtigungen besitzt, plus dem Header X-API-Version: 2.0.0.
- Ein Agent, der auf ai_audience ALLOWLISTED_ONLY gesetzt ist, kann ohne Zahlungsmethode aktiviert werden. Das Testen mit zugelassenen Konsumenten kommt also vor der Abrechnung.
Was ändert sich an deinem Webhook-Setup, wenn Meta Business Agent aktiv ist?
Meta Business Agent erfordert drei Webhook-Feld-Abonnements: messages, standby und messaging_handovers, alle eingerichtet im Developer Portal. Welches Feld eine Nachricht eines Konsumenten überträgt, hängt davon ab, wer die Kontrolle hält: standby, solange der Agent sie hält, messages, solange deine App sie hält. Ein messaging_handovers-Ereignis wird immer dann ausgelöst, wenn die Kontrolle wechselt, und standby ist die Standardeinstellung für neue Unterhaltungen, sobald der Agent aktiviert ist.[4]
Die standby-Payload enthält eines von drei Objekten: standby.messages für die eingehende Nachricht des Konsumenten, standby.message_echoes für jede vom Agenten gesendete Nachricht und standby.statuses für die Sende-, Zustellungs- und Lesebestätigungen zu diesen Nachrichten.[3] Eingehende Inhalte verwenden dieselbe Payload-Struktur wie ein Standard-Webhook für eingehende Nachrichten, und deine eigenen ausgehenden Nachrichten werden dir nie als Echo zurückgesendet.
Der vollständige Leitfaden zu Meta Business Agent fasst dieses Routing-Modell zusammen. Für eine von einem BSP entwickelte Integration besteht die Codeänderung darin, den Handler nach dem Feldnamen zu verzweigen, den standby-Kontext für Kontinuität zu speichern, wenn deine App zum aktiven Handler wird, und anhand der message id zu deduplizieren.
Wie funktioniert Thread Control zwischen Meta Business Agent und deiner App?
Thread Control ist der Cloud-API-Endpunkt, der die Kontrolle über eine Unterhaltung zwischen Meta Business Agent und einer App verschiebt. Release gibt die Unterhaltung als automatische Antwortinstanz an Meta Business Agent zurück. Pass überträgt die Kontrolle an den für die Telefonnummer konfigurierten Eskalationspartner oder an den Agenten, wenn control_pass.target_role „ai_agent“ ist. Beide Aktionen setzen voraus, dass die aufrufende Instanz die Kontrolle hält. Take übernimmt die Kontrolle vom aktuellen Inhaber und ist dem konfigurierten Eskalationspartner vorbehalten; andere Apps erhalten einen Fehler und übernehmen die Kontrolle stattdessen durch das Senden einer Nachricht.
Metas Get-Started-Seite (aktualisiert am 25. August 2026) dokumentiert POST https://graph.facebook.com/v21.0//thread_control mit X-API-Version: 2.0.0 und einem Body mit messaging_product „whatsapp“, der Aktion und dem Konsumenten im to-Feld. Die Referenz zu Thread Control (Cloud API) (aktualisiert am 4. September 2026) dokumentiert dieselben drei Aktionen unter https://api.facebook.com/business/whatsapp/phone_numbers/{phone_number_id}/thread_control mit X-API-Version 1.0.0. Teste die release-Aktion daher zuerst in deiner eigenen Umgebung.[2]
Das Aktivieren von Meta Business Agent pausiert nichts auf deiner Seite: Deine App wechselt in die standby-Rolle, und das Senden einer beliebigen Nachricht überträgt die primäre Kontrolle sofort zurück an deine App. Meta nennt dies die häufigste dokumentierte Ursache für Agenten, die in der Produktion verstummen. In Metas Worten: „Your app retains control until you explicitly release it. Stopping message sends does not release control.“ Eine automatische Antwort, die auf eine standby-Nachricht reagiert, bringt den Agenten daher zum Schweigen, bis deine App release aufruft.
Wenn die Kontrolle wechselt, erhält die App, die sie verloren hat, einen control_taken-Webhook auf messaging_handovers mit previous_owner_app_id, new_owner_app_id, new_owner_business_id und dem metadata-String aus dem Aufruf. Es ist die einzige messaging_handovers-Payload, die auf den Entwicklerseiten zu Meta Business Agent dokumentiert ist. Metas Seiten beschreiben bislang nicht, wie der Eskalationspartner konfiguriert wird oder ob eine BSP-App diese Rolle übernehmen kann.
Welche Nutzungsbedingungen müssen akzeptiert werden, bevor API-Aufrufe funktionieren?
Zwei Nutzungsbedingungen gelten für jeden Meta-Business-Agent-API-Aufruf an einer BSP-verwalteten Nummer: Der Kunde akzeptiert die Meta Business Agent Terms of Service im WhatsApp Manager, und der Solution Partner oder Tech Provider akzeptiert die Tech Provider Terms of Service im Facebook Developer Portal. Solange nicht beide vorliegen, lehnt Meta Aufrufe mit 403 Forbidden und einem Terms-of-Service-Fehler ab.
Der Tab auf Kundenseite erscheint im WhatsApp Manager nur, wenn mindestens eine Telefonnummer im WhatsApp Account (ehemals WhatsApp Business Account oder WABA) berechtigt ist. Die Checkliste zur Berechtigung behandelt diese Bedingungen, zu denen Cloud-API-Nummern zählen, die über einen Solution Partner oder Embedded Signup verwaltet werden.[12]
Die Partnerseite erfordert den Tech-Provider-Status: eine Meta-App mit dem Anwendungsfall WhatsApp, Unternehmensverifizierung, App Review mit zwei Demonstrationsvideos sowie erweiterten Zugriff (advanced access) auf die Berechtigungen whatsapp_business_messaging und whatsapp_business_management.[5] 360Dialog, ein Official Meta Solution Partner, betreibt die WhatsApp-Business-API-Infrastruktur und Partner Platform, in die ISVs und Reseller ihre Integration einbinden. Bei einer von 360Dialog verwalteten Nummer ist die Tech-Provider-Akzeptanz der Schritt auf Partnerseite, während die Akzeptanz im WhatsApp Manager der eigene Schritt des Unternehmens ist.
Was passiert mit BISU-Tokens und System-User-Berechtigungen?
Solution Partners und Tech Provider authentifizieren API-Aufrufe der Meta Business Agent Platform im Namen von Kunden-WABAs mit einem Business Integration System User (BISU)-Token, während direkte Integratoren für ihre eigene WABA ein System-User-Token verwenden. Beide Token-Typen benötigen whatsapp_business_messaging und whatsapp_business_management. Ein BISU-Token ermöglicht es einer Plattform, unter einem einzigen Credential für mehrere Kunden-WABAs zu handeln, und wird über Embedded Signup mit Facebook Login for Businesses erzeugt.[6] Ein Token, dem eine der beiden Berechtigungen fehlt, liefert laut Metas Quickstart den Fehler 401.[11]
Jede Anfrage an die Platform API benötigt zudem den Header X-API-Version: 2.0.0; ohne ihn greift standardmäßig die Version 1.0.0, bei der der Skills-Endpunkt nicht verfügbar ist. Der System User einer direkten Integration muss die Rolle Admin besitzen und der WABA mit aktivierter Option „View and manage phone numbers“ zugewiesen sein.
Bereit, Meta Business Agent für deine eigene WhatsApp-Business-API-Nummer zu nutzen? Mit API starten.
Erscheinen Antworten des Agenten in deinem BSP-Dashboard oder Posteingang?
Ob Antworten des Agenten in deinem BSP-Dashboard oder Posteingang erscheinen, hängt davon ab, ob der BSP das standby-Webhook-Feld in dieses Produkt eingebunden hat. Meta liefert jede Antwort des Agenten an deine App als Echo auf standby.message_echoes, mit dem exakten Request-Body, der an POST /{phone-number-id}/messages übergeben wurde, sowie mit Zustellungs- und Lesebestätigungen auf standby.statuses. Meta dokumentiert das Posteingangsverhalten keines BSP, frage daher deinen Anbieter und teste an einer zugelassenen Nummer.
Die menschliche Übergabe (Human Handoff) auf Seiten des Agenten wird durch zwei Felder in den Agent Settings geregelt: handoff.enabled bestimmt, ob der Agent die Thread Control nach dem Senden einer Handoff-Nachricht freigibt, und handoff.message_selection wählt DEFAULT, AGENT oder CUSTOM als Quelle dieser Nachricht.[8] Metas Dokumentation legt nicht fest, was einen Handoff auslöst; die Antwort des Agent-Test-Endpunkts enthält jedoch ein Feld handoff_reason, mit dem sich dies beobachten lässt.
Welche Nachrichten werden von Meta abgerechnet und welche von deinem BSP?
Meta stellt dem Unternehmen jede Meta-Business-Agent-Nachricht direkt in Rechnung, auch Unternehmen, die über einen Solution Provider auf die WhatsApp Business Platform zugreifen, zu einem einheitlichen globalen Satz von 2,00 USD pro 1 Million Tokens. Eine typische Nachricht verbraucht 20.000 bis 25.000 Tokens, umgerechnet etwa 4 bis 5 US-Cent, als eine einzige Token-basierte Gebühr, die sowohl die Verarbeitung als auch die Zustellung durch den Agenten abdeckt.[7] Das 72-Stunden-Fenster für den kostenlosen Einstiegspunkt und das 24-Stunden-Kundenservicefenster befreien Agentennachrichten nicht von der Abrechnung. Eine Non-Template-Nachricht wird entweder als Agentennachricht oder als Servicenachricht abgerechnet, nie als beides. Eine menschliche Antwort nach einer Übergabe ist daher eine Servicenachricht: kostenlos bis zum 1. Oktober 2026, danach pro Nachricht berechnet.
Meta liefert keine Agentennachrichten für ein Unternehmen ohne hinterlegte Zahlungsmethode auf seinem Business-Agent-Konto: eine monatlich abgerechnete Meta-Kreditlinie oder, ab dem 8. September 2026, eine Visa- oder Mastercard-Kredit- oder Debitkarte. Kreditlinien, Karten, Währungen und Rechnungen werden im Artikel wer dich für Meta-Business-Agent-Nachrichten abrechnet behandelt.
Was solltest du vor der Aktivierung von Meta Business Agent testen?
Teste an einer Live-Nummer, wobei der Agent auf zugelassene Konsumenten beschränkt ist. Unter der Standardeinstellung ai_audience EVERYONE beantwortet der Agent jeden Konsumenten. Metas dokumentierte Reihenfolge lautet: jeden Testkonsumenten mit POST /{entity_id}/agent_config/allowlist hinzufügen (eine consumer_phone_number pro Aufruf, im E.164-Format), ai_audience mit PUT /{entity_id}/agent_config/settings auf ALLOWLISTED_ONLY setzen, dies mit GET zurücklesen und erst dann rollout.enabled auf true setzen.[9] Ein Agent, der mit ai_audience auf ALLOWLISTED_ONLY aktiviert wird, benötigt keine Zahlungsmethode. Ein BSP-Kunde kann also den gesamten Ablauf testen, bevor die Abrechnung eingerichtet ist; die Aktivierung für EVERYONE oder die spätere Erweiterung auf EVERYONE erfordert dagegen eine Zahlungsmethode und liefert bis dahin einen Fehler 400.[10]
Prüfe vor der Umstellung Folgendes:
- Beide Nutzungsbedingungen sind akzeptiert, und ein Testaufruf liefert nicht mehr 403.
- Die App ist für alle drei Webhook-Felder abonniert, und eine Nachricht eines zugelassenen Konsumenten kommt auf standby an.
- Jede Automatisierung, die für diese Nummer senden kann, ist erfasst; jede, die auslöst, entzieht dem Agenten die Kontrolle.
- Ein release-Aufruf ist erfolgreich, und die nächste Nachricht des Konsumenten kommt wieder auf standby an.
- Onboarding wurde für die Nummer aufgerufen; andernfalls liefern Konfigurationsaufrufe einen Fehler 500 mit „no workspace found“.
Meta Business Agent fügt einer Nummer eine zweite Antwortinstanz hinzu, und der häufigste dokumentierte Fehlerfall, ein in der Produktion verstummter Agent, hängt davon ab, welche der beiden die Kontrolle hält. Eine Integration, die weiß, welches Feld sie liest, alles freigibt, was sie übernimmt, und die Abfolge zuerst an einer Allowlist überprüft, ist bereit für die Umstellung, die in 360Dialogs erster Berichterstattung zum Rollout beschrieben wird.
Um zu besprechen, was die Aktivierung von Meta Business Agent für eine über 360Dialog verwaltete Nummer bedeutet, sprich mit uns.
Häufig gestellte Fragen
Was ist der Unterschied zwischen Release und Pass bei Thread Control?
Release gibt eine Unterhaltung als automatische Antwortinstanz an Meta Business Agent zurück, während Pass die Kontrolle an den für die Telefonnummer konfigurierten Eskalationspartner überträgt, oder an den Agenten, wenn control_pass.target_role „ai_agent“ ist. Beide Aktionen setzen voraus, dass die aufrufende Instanz die Kontrolle hält, und nach einem Release kommen die Nachrichten des Konsumenten wieder auf deinem standby-Feld an.
Was ist ein Eskalationspartner bei Meta Business Agent?
Ein Eskalationspartner ist das für eine Telefonnummer konfigurierte Unternehmen, das Thread Control mit der take-Aktion aufrufen darf und dabei die Kontrolle von Meta Business Agent, einer anderen App oder einer inaktiven Unterhaltung übernimmt. Andere Apps erhalten bei take einen Fehler, und Meta dokumentiert bislang nicht, wie der Eskalationspartner konfiguriert wird.
Brauche ich ein BISU-Token, wenn ich direkt mit der Cloud API integriere?
Ein direkter Integrator authentifiziert sich mit einem System-User-Token für seinen eigenen WhatsApp Account. Ein Business Integration System User (BISU)-Token ist für Solution Partners und Tech Provider gedacht, die die Meta-Business-Agent-Platform-APIs im Namen von Kunden-WhatsApp-Accounts aufrufen. Beide Token-Typen benötigen die Berechtigungen whatsapp_business_messaging und whatsapp_business_management.
Was passiert, wenn meine App die release-Aktion von Thread Control nie aufruft?
Deine App behält die Kontrolle über jede Unterhaltung, an die sie eine Nachricht gesendet hat, und Meta Business Agent antwortet dort nicht mehr, bis die Kontrolle freigegeben wird. Meta stellt klar, dass das Einstellen des Nachrichtenversands die Kontrolle nicht freigibt. Die Nachrichten des Konsumenten kommen daher weiterhin auf deinem messages-Feld an, während der Agent schweigt.
Kann ich Meta Business Agent vor dem Live-Gang auf Testnummern beschränken?
Meta Business Agent lässt sich auf Testnummern beschränken, indem du jeden Konsumenten zur Allowlist hinzufügst und ai_audience auf ALLOWLISTED_ONLY setzt, bevor du rollout.enabled auf true setzt. Bei der Standardeinstellung EVERYONE wird die Allowlist ignoriert. Ein ausschließlich auf zugelassene Konsumenten beschränkter Agent kann ohne Zahlungsmethode aktiviert werden; die Erweiterung auf EVERYONE erfordert eine.
Quellen
[1] „Get started with Meta Business Agent Platform APIs.“ Updated August 25, 2026. https://developers.facebook.com/documentation/meta-business-agent/get-started. Accessed September 7, 2026.
[2] „Thread Control (Cloud API).“ Updated September 4, 2026. https://developers.facebook.com/documentation/meta-business-agent/reference/operate/thread-control-cloud-api. Accessed September 7, 2026.
[3] „Standby webhooks.“ Updated August 4, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/standby. Accessed September 7, 2026.
[4] „Meta Business Agent Troubleshooting.“ Updated August 27, 2026. https://developers.facebook.com/documentation/meta-business-agent/troubleshooting. Accessed September 7, 2026.
[5] „Become a Tech Provider.“ Updated August 20, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providers. Accessed September 7, 2026.
[6] „Access Tokens.“ Updated June 30, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens/. Accessed September 7, 2026.
[7] „Upcoming pricing updates for Meta Business Agent, service and utility messages.“ Updated August 25, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/non-template-messages. Accessed September 7, 2026.
[8] „Agent Settings.“ Updated September 4, 2026. https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-settings. Accessed September 7, 2026.
[9] „Agent Allowlist.“ Updated September 4, 2026. https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-allowlist. Accessed September 7, 2026.
[10] „Meta Business Agent Changelog.“ Updated September 3, 2026. https://developers.facebook.com/documentation/meta-business-agent/changelog/. Accessed September 7, 2026.
[11] „Meta Business Agent Quickstart.“ Updated August 27, 2026. https://developers.facebook.com/documentation/meta-business-agent/quickstart. Accessed September 7, 2026.
[12] „Meta Business Agent Platform overview.“ Updated August 28, 2026. https://developers.facebook.com/documentation/meta-business-agent/overview. Accessed September 7, 2026.
