{"id":1718,"date":"2026-09-07T08:34:15","date_gmt":"2026-09-07T08:34:15","guid":{"rendered":"https:\/\/360dialog.com\/blog\/?p=1718"},"modified":"2026-09-07T08:47:00","modified_gmt":"2026-09-07T08:47:00","slug":"bsp-integration-meta-business-agent-whatsapp","status":"publish","type":"post","link":"https:\/\/360dialog.com\/blog\/de\/bsp-integration-meta-business-agent-whatsapp\/","title":{"rendered":"Was mit deiner BSP-Integration passiert, wenn Meta Business Agent aktiviert wird"},"content":{"rendered":"\n

Wenn Meta Business Agent f\u00fcr eine WhatsApp-Nummer aktiviert wird, die \u00fcber einen Business Solution Provider (BSP) verwaltet wird, ist die Partner-App nicht mehr die prim\u00e4re Antwortinstanz: Nachrichten von Konsumenten laufen \u00fcber das standby-Webhook-Feld, solange der Agent die Kontrolle h\u00e4lt. Die App erh\u00e4lt die Kontrolle zur\u00fcck, indem sie eine Nachricht sendet, oder, als konfigurierter Eskalationspartner, indem sie Thread Control mit der take-Aktion aufruft.<\/strong>[1] Drei Webhook-Felder \u00fcbertragen den Traffic, zwei Nutzungsbedingungen (Terms of Service) gelten f\u00fcr 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.<\/p>\n\n\n\n

<\/p>\n\n\n\n

Die wichtigsten Punkte<\/h2>\n\n\n\n
    \n
  1. Meta Business Agent ben\u00f6tigt drei Webhook-Feld-Abonnements (messages, standby und messaging_handovers). Nachrichten von Konsumenten wechseln zu standby, solange der Agent die Kontrolle h\u00e4lt.<\/li>\n\n\n\n
  2. Deine App \u00fcbernimmt die Kontrolle, indem sie eine beliebige Nachricht sendet, und beh\u00e4lt sie, bis sie Thread Control mit der release-Aktion aufruft. In Metas Worten: \u201eStopping message sends does not release control.“<\/li>\n\n\n\n
  3. Zwei Nutzungsbedingungen gelten f\u00fcr jeden API-Aufruf: die des Kunden im WhatsApp Manager und die des BSP im Facebook Developer Portal.<\/li>\n\n\n\n
  4. 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.<\/li>\n\n\n\n
  5. 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.<\/li>\n<\/ol>\n\n\n\n

    <\/p>\n\n\n\n

    Was \u00e4ndert sich an deinem Webhook-Setup, wenn Meta Business Agent aktiv ist?<\/h2>\n\n\n\n

    Meta Business Agent erfordert drei Webhook-Feld-Abonnements: messages, standby und messaging_handovers, alle eingerichtet im Developer Portal. Welches Feld eine Nachricht eines Konsumenten \u00fcbertr\u00e4gt, h\u00e4ngt davon ab, wer die Kontrolle h\u00e4lt: standby, solange der Agent sie h\u00e4lt, messages, solange deine App sie h\u00e4lt. Ein messaging_handovers-Ereignis wird immer dann ausgel\u00f6st, wenn die Kontrolle wechselt, und standby ist die Standardeinstellung f\u00fcr neue Unterhaltungen, sobald der Agent aktiviert ist.[4]<\/p>\n\n\n\n

    Die standby-Payload enth\u00e4lt eines von drei Objekten: standby.messages f\u00fcr die eingehende Nachricht des Konsumenten, standby.message_echoes f\u00fcr jede vom Agenten gesendete Nachricht und standby.statuses f\u00fcr die Sende-, Zustellungs- und Lesebest\u00e4tigungen zu diesen Nachrichten.[3] Eingehende Inhalte verwenden dieselbe Payload-Struktur wie ein Standard-Webhook f\u00fcr eingehende Nachrichten, und deine eigenen ausgehenden Nachrichten werden dir nie als Echo zur\u00fcckgesendet.<\/p>\n\n\n\n

    Der vollst\u00e4ndige Leitfaden zu Meta Business Agent<\/a> fasst dieses Routing-Modell zusammen. F\u00fcr eine von einem BSP entwickelte Integration besteht die Code\u00e4nderung darin, den Handler nach dem Feldnamen zu verzweigen, den standby-Kontext f\u00fcr Kontinuit\u00e4t zu speichern, wenn deine App zum aktiven Handler wird, und anhand der message id zu deduplizieren.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Wie funktioniert Thread Control zwischen Meta Business Agent und deiner App?<\/h2>\n\n\n\n

    Thread Control ist der Cloud-API-Endpunkt, der die Kontrolle \u00fcber eine Unterhaltung zwischen Meta Business Agent und einer App verschiebt. Release gibt die Unterhaltung als automatische Antwortinstanz an Meta Business Agent zur\u00fcck. Pass \u00fcbertr\u00e4gt die Kontrolle an den f\u00fcr die Telefonnummer konfigurierten Eskalationspartner oder an den Agenten, wenn control_pass.target_role \u201eai_agent“ ist. Beide Aktionen setzen voraus, dass die aufrufende Instanz die Kontrolle h\u00e4lt. Take \u00fcbernimmt die Kontrolle vom aktuellen Inhaber und ist dem konfigurierten Eskalationspartner vorbehalten; andere Apps erhalten einen Fehler und \u00fcbernehmen die Kontrolle stattdessen durch das Senden einer Nachricht.<\/p>\n\n\n\n

    Metas Get-Started-Seite (aktualisiert am 25. August 2026) dokumentiert POST https:\/\/graph.facebook.com\/v21.0\/<\/a>\/thread_control mit X-API-Version: 2.0.0 und einem Body mit messaging_product \u201ewhatsapp“, 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<\/a> mit X-API-Version 1.0.0. Teste die release-Aktion daher zuerst in deiner eigenen Umgebung.[2]<\/p>\n\n\n\n

    Das Aktivieren von Meta Business Agent pausiert nichts auf deiner Seite: Deine App wechselt in die standby-Rolle, und das Senden einer beliebigen Nachricht \u00fcbertr\u00e4gt die prim\u00e4re Kontrolle sofort zur\u00fcck an deine App. Meta nennt dies die h\u00e4ufigste dokumentierte Ursache f\u00fcr Agenten, die in der Produktion verstummen. In Metas Worten: \u201eYour 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.<\/p>\n\n\n\n

    Wenn die Kontrolle wechselt, erh\u00e4lt 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 \u00fcbernehmen kann.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Welche Nutzungsbedingungen m\u00fcssen akzeptiert werden, bevor API-Aufrufe funktionieren?<\/h2>\n\n\n\n

    Zwei Nutzungsbedingungen gelten f\u00fcr 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.<\/p>\n\n\n\n

    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<\/a> behandelt diese Bedingungen, zu denen Cloud-API-Nummern z\u00e4hlen, die \u00fcber einen Solution Partner oder Embedded Signup verwaltet werden.[12]<\/p>\n\n\n\n

    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<\/a>, 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\u00e4hrend die Akzeptanz im WhatsApp Manager der eigene Schritt des Unternehmens ist.<\/strong><\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Was passiert mit BISU-Tokens und System-User-Berechtigungen?<\/h2>\n\n\n\n

    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\u00e4hrend direkte Integratoren f\u00fcr ihre eigene WABA ein System-User-Token verwenden. Beide Token-Typen ben\u00f6tigen whatsapp_business_messaging und whatsapp_business_management. Ein BISU-Token erm\u00f6glicht es einer Plattform, unter einem einzigen Credential f\u00fcr mehrere Kunden-WABAs zu handeln, und wird \u00fcber 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]<\/p>\n\n\n\n

    Jede Anfrage an die Platform API ben\u00f6tigt zudem den Header X-API-Version: 2.0.0; ohne ihn greift standardm\u00e4\u00dfig die Version 1.0.0, bei der der Skills-Endpunkt nicht verf\u00fcgbar ist. Der System User einer direkten Integration muss die Rolle Admin besitzen und der WABA mit aktivierter Option \u201eView and manage phone numbers“ zugewiesen sein.<\/p>\n\n\n\n

    Bereit, Meta Business Agent f\u00fcr deine eigene WhatsApp-Business-API-Nummer zu nutzen? Mit API starten<\/a>.<\/strong><\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Erscheinen Antworten des Agenten in deinem BSP-Dashboard oder Posteingang?<\/h2>\n\n\n\n

    Ob Antworten des Agenten in deinem BSP-Dashboard oder Posteingang erscheinen, h\u00e4ngt 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 \u00fcbergeben wurde, sowie mit Zustellungs- und Lesebest\u00e4tigungen auf standby.statuses. Meta dokumentiert das Posteingangsverhalten keines BSP, frage daher deinen Anbieter und teste an einer zugelassenen Nummer.<\/p>\n\n\n\n

    Die menschliche \u00dcbergabe (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\u00e4hlt DEFAULT, AGENT oder CUSTOM als Quelle dieser Nachricht.[8] Metas Dokumentation legt nicht fest, was einen Handoff ausl\u00f6st; die Antwort des Agent-Test-Endpunkts enth\u00e4lt jedoch ein Feld handoff_reason, mit dem sich dies beobachten l\u00e4sst.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Welche Nachrichten werden von Meta abgerechnet und welche von deinem BSP?<\/h2>\n\n\n\n

    Meta stellt dem Unternehmen jede Meta-Business-Agent-Nachricht direkt in Rechnung, auch Unternehmen, die \u00fcber 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\u00fchr, die sowohl die Verarbeitung als auch die Zustellung durch den Agenten abdeckt.[7] Das 72-Stunden-Fenster f\u00fcr 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 \u00dcbergabe ist daher eine Servicenachricht: kostenlos bis zum 1. Oktober 2026, danach pro Nachricht berechnet.<\/p>\n\n\n\n

    Meta liefert keine Agentennachrichten f\u00fcr 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\u00e4hrungen und Rechnungen werden im Artikel wer dich f\u00fcr Meta-Business-Agent-Nachrichten abrechnet<\/a> behandelt.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Was solltest du vor der Aktivierung von Meta Business Agent testen?<\/h2>\n\n\n\n

    Teste an einer Live-Nummer, wobei der Agent auf zugelassene Konsumenten beschr\u00e4nkt 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\u00fcgen (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\u00fccklesen und erst dann rollout.enabled auf true setzen.[9] Ein Agent, der mit ai_audience auf ALLOWLISTED_ONLY aktiviert wird, ben\u00f6tigt keine Zahlungsmethode. Ein BSP-Kunde kann also den gesamten Ablauf testen, bevor die Abrechnung eingerichtet ist; die Aktivierung f\u00fcr EVERYONE oder die sp\u00e4tere Erweiterung auf EVERYONE erfordert dagegen eine Zahlungsmethode und liefert bis dahin einen Fehler 400.[10]<\/p>\n\n\n\n

    Pr\u00fcfe vor der Umstellung Folgendes:<\/p>\n\n\n\n