Meta Business Agent API: Der technische Onboarding-Guide für Entwickler
Die einfachste Art den Meta Business Agent einzurichten ist die WhatsApp Business App oder die Meta Business Suite. Wer aber als Entwickler oder Enterprise-Unternehmen die volle Kontrolle über den Agenten haben, ihn in bestehende Systeme integrieren und programmatisch steuern will, kommt an der API nicht vorbei. Dieser Guide führt dich durch das technische Onboarding.
Dieser Artikel ist Teil unseres vollständigen Meta Business Agent Guides – dort findest du alle Themen rund um den Meta Business Agent auf einen Blick.
Für wen ist dieser Guide?
Dieser Artikel richtet sich an Entwickler und technische Teams, die den Meta Business Agent über die API einrichten und verwalten wollen. Vorausgesetzt werden grundlegende Kenntnisse in REST-APIs, JSON und der WhatsApp Business Platform. Wer keinen technischen Hintergrund hat, ist mit der App- oder Business-Suite-Variante besser bedient.
Den Unterschied zwischen beiden Varianten erklären wir hier: WhatsApp Business App vs. Meta Business Suite – welche Variante passt zu dir?
Voraussetzungen
Bevor du mit dem API-Onboarding beginnst, müssen folgende Voraussetzungen erfüllt sein:
- Meta Developer Account: Registriert unter developers.facebook.com
- Meta Business Portfolio: Ein vollständig eingerichtetes Business Portfolio in der Meta Business Suite
- Developer App: Eine App im Meta Developer Dashboard mit den nötigen Produkten
- WhatsApp Business Konto: Ein registriertes WhatsApp Business Konto, das dem Business Portfolio zugeordnet ist
- Verifiziertes Business: Dein Unternehmen muss in Meta Business Manager verifiziert sein
Schritt 1: System User erstellen
Der erste Schritt ist die Erstellung eines System Users in der Meta Business Suite. System Users sind technische Konten, die für API-Zugriffe genutzt werden, ohne an einen persönlichen Facebook-Account gebunden zu sein. Das ist wichtig für die Stabilität: Wenn ein Mitarbeiter das Unternehmen verlässt, bleibt der API-Zugriff bestehen.
Gehe in der Meta Business Suite zu Einstellungen, dann zu Benutzer und wähle Systembenutzer. Erstelle einen neuen System User mit der Rolle Administrator. Weise diesem System User anschließend die nötigen Assets zu: deine Developer App und dein WhatsApp Business Konto.
Schritt 2: Access Token generieren
Mit dem System User kannst du jetzt einen Access Token generieren. Dieser Token authentifiziert alle API-Calls. Klicke beim System User auf Token generieren, wähle deine Developer App aus und aktiviere folgende Permissions:
- whatsapp_business_management
- whatsapp_business_messaging
Speichere den generierten Token sicher. Er wird bei jedem API-Call im Authorization Header mitgegeben. Beachte die Token-Laufzeit und implementiere einen Refresh-Mechanismus, damit deine Integration nicht unerwartet abbricht.
Schritt 3: Agent Onboarding API aufrufen
Mit dem Access Token kannst du jetzt den Agenten über die API erstellen. Der Onboarding-Call ist ein POST-Request an den Agent-Endpoint mit der WhatsApp Business Phone Number ID als Pfadparameter.
Der Request-Body enthält die grundlegenden Konfigurationsparameter des Agenten: Name, initiale Instructions und die Freigabe der Datenquellen. Meta verarbeitet den Request und gibt eine Agent ID zurück, die du für alle weiteren API-Calls benötigst.
Die vollständige Endpoint-Dokumentation, alle Parameter und Beispiel-Responses behandeln wir ausführlich im Video-Kurs. Dort findest du auch fertige Code-Snippets für die gängigsten Sprachen.
Schritt 4: Knowledge Base aufbauen
Nach der initialen Erstellung des Agenten befüllst du die Knowledge Base programmatisch. Die API unterstützt verschiedene Arten von Wissensquellen:
Text-basierte Inhalte: FAQs, Produktbeschreibungen, Richtlinien als strukturierter Text
Dokumente: PDFs und andere Dokumente werden als File-Upload übergeben und vom Agenten automatisch verarbeitet
Website-URLs: Du kannst URLs übergeben, die der Agent automatisch einliest und synchronisiert
Kataloge: Produktkataloge aus dem Meta Commerce Manager werden direkt verknüpft
Die Reihenfolge, in der du diese Quellen einpflegst, und wie du die Inhalte strukturieren solltest damit der Agent optimal darauf zugreifen kann, ist nicht trivial. Wer hier unsystematisch vorgeht, bekommt einen Agenten der zwar technisch funktioniert aber qualitativ enttäuscht.
Schritt 5: Audience Control und Handoff konfigurieren
Über die API hast du volle Kontrolle über die Audience Control des Agenten. Du kannst programmatisch festlegen, welche Nutzergruppen KI-Antworten bekommen: alle Kontakte, nur Neukontakte oder nur Nutzer aus spezifischen Ad-Kampagnen.
Die Handoff-Konfiguration läuft ebenfalls über die API. Du definierst Trigger-Topics, bei denen der Agent automatisch an einen menschlichen Mitarbeiter übergibt. Diese Topics können keyword-basiert, intent-basiert oder sentiment-basiert sein. Eine saubere Handoff-Konfiguration ist einer der kritischsten Punkte im gesamten Setup.
Wer die API im Enterprise-Kontext mit CRM- und Tool-Anbindung betreibt, sollte sich zusätzlich die Meta Business Agent Platform – Enterprise-Lösung im Überblick ansehen.
Schritt 6: Webhooks einrichten
Für eine vollständige Integration richtest du Webhooks ein, über die Meta deinen Server bei relevanten Events benachrichtigt. Relevante Events sind unter anderem neue Nachrichten, Handoff-Triggering, Agent-Fehler und Performance-Updates.
Der Webhook-Endpoint muss öffentlich erreichbar sein, HTTPS unterstützen und den Meta Verification-Prozess durchlaufen. Meta sendet beim Setup einen Verify-Token an deinen Endpoint, den du zurückgeben musst, bevor Events zugestellt werden.
Schritt 7: Testen und Go-Live
Bevor du den Agenten scharf schaltest, teste ihn systematisch über die API. Meta stellt eine Test-Umgebung zur Verfügung, in der du Gespräche simulieren und die Antwortqualität prüfen kannst, ohne echte Kunden zu involvieren.
Wie ein systematischer Testprozess aussieht, welche Szenarien du unbedingt durchspielen musst und wie du die Qualität der Antworten objektiv bewertest, bevor du live gehst, ist ein eigenes Kapitel im Video-Kurs. Wer diesen Schritt überspringt, riskiert einen schlechten ersten Eindruck bei echten Kunden.
Laufender Betrieb und Monitoring
Nach dem Go-Live ist die Arbeit nicht erledigt. Ein gut betriebener Agent wird kontinuierlich überwacht und optimiert. Die API gibt dir Zugriff auf Performance-Metriken: Antwortquoten, Handoff-Raten, Kundenzufriedenheitssignale und Fehlerprotokolle.
Plane regelmäßige Reviews der Knowledge Base ein, besonders wenn sich Produkte, Preise oder Richtlinien ändern. Ein Agent der veraltete Informationen gibt, schadet dem Vertrauen schneller als kein Agent.
Wer den Meta Business Agent nicht nur technisch zum Laufen bringt, sondern eine Integration aufbaut die langfristig stabil läuft und echten Business-Wert liefert, wird das im Memacon® Meta Business Agent Paket finden – aktuell in Entwicklung. Das Paket wird die vollständige technische Dokumentation enthalten: Code-Snippets, Testprotokolle und Best Practices aus hunderten Projekten. Videokurs, Anleitungen und alles an einem Ort.
Bis es so weit ist: Trag dich jetzt über den Button oder den QR-Code hier unten in den Memacon® Meta Business Agent Newsletter ein und verpasse keine Updates.
WhatsApp-Newsletter
Regelmäßige Infos zum
Meta Business Agent
