Your AI Connector Docs

Verbinden Sie Ihre eigene Meta-App

Betreiben Sie WhatsApp über Ihre eigene Meta-App und bezahlen Sie Meta direkt zu deren eigenen Tarifen. Your AI Connector erhebt bei dieser Verbindung keine Gebühren pro Nachricht, und es gibt kein Twilio-Konto dazwischen. Da das WhatsApp-Konto Ihnen gehört, sehen Ihre Kunden immer nur Ihren Firmennamen.

Dies ist die technischste der WhatsApp-Verbindungsoptionen – Sie erstellen eine App auf der Entwickler-Website von Meta und kopieren vier Werte zurück in Your AI Connector. Planen Sie etwa 20 Minuten ein. Wenn das nach mehr klingt, als Sie bewältigen möchten, bleibt die verwaltete WhatsApp Business-Verbindung der einfachste Weg für den Einstieg.

Was Sie benötigen

  • Zugriff auf Ihr Meta Business Manager-Konto.
  • Eine Telefonnummer, die noch nicht in der WhatsApp-App verwendet wird.
  • Etwa 20 Minuten Zeit.

Teil 1 — Richten Sie Ihre App bei Meta ein

Führen Sie diese Schritte zuerst auf der Seite von Meta aus. Sie werden dabei vier Werte sammeln: eine App-ID, ein App-Geheimnis, ein Zugriffstoken und eine WhatsApp-Konto-ID.

1. Erstellen Sie eine App

Gehen Sie zu developers.facebook.com, öffnen Sie Meine Apps und klicken Sie auf App erstellen. Wählen Sie den Typ Business und geben Sie ihr einen beliebigen Namen – der Name ist nur für Sie sichtbar.

2. Fügen Sie der App WhatsApp hinzu

Suchen Sie auf dem App-Dashboard in der Produktliste nach WhatsApp und klicken Sie auf Einrichten. Meta erstellt ein Test-WhatsApp-Konto mit einer kostenlosen Testnummer, damit Sie Dinge ausprobieren können, bevor Sie eine echte Nummer verbinden.

3. Aktivieren Sie die WhatsApp-Berechtigungen

Dies ist der Schritt, den die meisten Anleitungen überspringen, und das Überspringen ist der häufigste Grund, warum die Verbindung später fehlschlägt.

Öffnen Sie in Ihrer App App-Überprüfung und dann Berechtigungen und Funktionen. Suchen Sie nach whatsapp_business_management. Wenn dort Kein Zugriff steht, klicken Sie auf Standardzugriff anfordern – Meta fordert Sie auf, Ihr Passwort erneut einzugeben, und gewährt den Zugriff sofort. Es gibt keine Wartezeit und keine App-Überprüfung; es ist nur ein einziger Klick.

whatsapp_business_messaging hat normalerweise bereits Standardzugriff. Beide Berechtigungen müssen vor dem nächsten Schritt Standardzugriff anzeigen, da dem von Ihnen generierten Token sonst eine davon fehlt.

4. Systembenutzer erstellen

Öffnen Sie in den Meta Business-Einstellungen den Bereich Nutzer und dann Systembenutzer. Fügen Sie einen Benutzer hinzu und erteilen Sie ihm Administratorzugriff sowohl auf Ihre App als auch auf Ihr WhatsApp-Konto.

5. Token für diesen Benutzer generieren

Wählen Sie den Systembenutzer aus und klicken Sie auf Token generieren. Wählen Sie Ihre App aus, entscheiden Sie sich für einen Token, der nie abläuft, und aktivieren Sie sowohl whatsapp_business_messaging als auch whatsapp_business_management. Meta zeigt den Token nur einmal an – kopieren Sie ihn sofort.

6. WhatsApp-Konto-ID finden

Öffnen Sie in den Business-Einstellungen Konten und dann WhatsApp-Konten und wählen Sie Ihr Konto aus. Die lange Nummer unter dem Namen ist die ID.

Ihre App-ID und Ihr App-Geheimnis finden Sie in den App-Einstellungen unter Grundlegend. Klicken Sie neben dem App-Geheimnis auf Anzeigen, um es sichtbar zu machen.

Teil 2 – Verbindung in Your AI Connector herstellen

Öffnen Sie Einstellungen, dann Kanäle, suchen Sie die Karte WhatsApp Business API und klicken Sie auf WhatsApp verbinden. Wählen Sie Eine Nummer verwenden, die Sie bereits haben, dann Ihre eigene Meta-App. Der Assistent öffnet sich mit einer kurzen Übersicht – klicken Sie auf Einrichtung starten.

  1. Ihre Details. Dieser Schritt wiederholt die fünf Schritte auf Meta-Seite aus Teil 1 neben einem Formular für Ihre vier Werte. Fügen Sie die App-ID, das App-Geheimnis, das Zugriffstoken und die WhatsApp-Konto-ID genau so ein, wie Meta sie anzeigt, ohne zusätzliche Leerzeichen, und drücken Sie Meine Details prüfen. Es wird nichts gespeichert, bevor es funktioniert – Your AI Connector prüft sie zuerst mit Meta.
  1. Nummer für die Verbindung auswählen. Der Assistent listet jede Nummer Ihres WhatsApp-Kontos auf, jeweils mit Metas eigener Qualitätsbewertung. Wählen Sie die Nummer aus, über die dieser Arbeitsbereich senden und empfangen soll, und klicken Sie auf Diese Nummer verbinden.
  1. Aktivierung und Bereitstellung. Your AI Connector aktiviert die Nummer für die Cloud-API und registriert deren Webhook automatisch bei Meta, sodass eingehende Nachrichten Ihren Posteingang erreichen – in den meisten Fällen gelangen Sie direkt zur Verbindungskarte mit einer „Nummer verbunden“-Bestätigung. Falls der automatische Schritt nicht abgeschlossen werden kann, zeigt der Assistent die Callback-URL und das Verify-Token mit Kopier-Buttons an und führt Sie durch das manuelle Hinzufügen bei Meta; dieselben Werte bleiben auf der Verbindungskarte sichtbar, falls Meta Sie jemals auffordern sollte, diese erneut einzugeben.
  2. Der Assistent prüft die Verbindung selbst. Im letzten Schritt wird das Setup automatisch verifiziert – Sie müssen nicht warten. Sobald die Karte „verbunden“ anzeigt, senden Sie sich von einem anderen Telefon aus eine WhatsApp-Nachricht und beobachten Sie, wie sie in Ihren Chats ankommt: Unterhaltungen über diese Nummer fließen nun wie bei jedem anderen Kanal ein, und Ihre KI-Agenten können darauf antworten. Falls die Prüfung etwas findet, das Meta noch benötigt (zum Beispiel die Verifizierung der Nummer), zeigt Ihnen die Karte genau an, was zu tun ist, und Verbindung prüfen führt die Prüfung erneut durch, sobald Sie das Problem behoben haben.

Sie können jederzeit auf dieselbe Seite zurückkehren, um den Verbindungsstatus zu überprüfen, die Verbindung mit neuen Details zu erneuern oder auf Trennen zu klicken — Ihre Nummer, Ihr Meta-Konto und Ihre Abrechnung bleiben in Ihrem Besitz.

Gut zu wissen

  • Das 24-Stunden-Fenster gilt wie bei jeder WhatsApp Business-Verbindung. Sie können jederzeit frei auf Personen antworten, die Ihnen in den letzten 24 Stunden geschrieben haben. Außerhalb dieses Fensters erlaubt WhatsApp Unternehmen nur den Start von Konversationen mit einer genehmigten Nachrichtenvorlage – eine einfache Textnachricht wird von Meta zwar akzeptiert, aber nicht zugestellt.
  • Meta stellt Ihnen Konversationen direkt in Rechnung zu den veröffentlichten Ländertarifen über die Zahlungsmethode, die in Ihrem WhatsApp-Konto bei Meta hinterlegt ist. Your AI Connector berechnet bei dieser Verbindung keine Gebühren pro Nachricht; die KI-Nutzung wird wie üblich in Credits abgerechnet.
  • Hinterlegen Sie eine gültige Zahlungsmethode für dieses WhatsApp-Konto. Ohne diese blockiert Meta jede Konversation, die Ihr Unternehmen startet – Broadcasts, Kampagnen und jede Vorlagennachricht – und zeigt den Fehler im WhatsApp Manager an. Bei dieser Verbindung lässt sich ein Broadcast oder eine Kampagne in diesem Fall nicht starten, und Sie werden aufgefordert, eine Zahlungsmethode hinzuzufügen, anstatt dass die Nachricht einzeln fehlschlägt. Antworten an Personen, die Ihnen zuerst geschrieben haben, gehen vorerst weiterhin raus, aber ab dem 1. Oktober 2026 berechnet Meta auch diese, sodass ein Konto ohne funktionierende Zahlungsmethode ab diesem Datum vollständig stummgeschaltet wird. Das Gesamtbild finden Sie unter WhatsApp-Kosten & die Änderung im Oktober 2026.
  • Ihre Kostenschätzung sieht hier anders aus. Da diese Gebühren niemals Ihre Credits betreffen, zeigt die Schätzung im Überprüfungsschritt eines Broadcasts (und im Startschritt einer Kampagne) die Anzahl der Kontakte und die Länderaufteilung mit dem Hinweis an, dass Meta diese Ihrem WhatsApp Business-Konto in Rechnung stellt, anstatt eines Credit-Gesamtbetrags.
  • Testnummern sind kostenlos. Die Testnummer, die Meta jeder neuen App gibt, kann bis zu fünf verifizierte Empfänger kostenlos anschreiben – eine praktische Möglichkeit, die vollständige Einrichtung auszuprobieren, bevor Sie eine echte Nummer darauf verweisen.

Vorlagen

Nachrichtenvorlagen funktionieren über diese Verbindung und werden in Ihrem eigenen WhatsApp Business-Konto gespeichert. Erstellen Sie eine auf der Seite Vorlagen; sie wird dann in diesem Konto erstellt und von Meta überprüft. Das Ergebnis (genehmigt, ausstehend oder abgelehnt) wird Ihnen hier angezeigt. Vorlagen, die Sie bereits im WhatsApp Manager haben, erscheinen automatisch in der Liste, und über die Schaltfläche Von Meta synchronisieren können Sie alle Änderungen abrufen, die Sie dort gerade vorgenommen haben. Das Senden funktioniert wie bei jeder anderen WhatsApp-Verbindung – wählen Sie eine genehmigte Vorlage aus, um eine Unterhaltung zu beginnen oder eine Unterhaltung außerhalb des 24-Stunden-Fensters wieder zu öffnen. Die Details finden Sie unter Verwendung von Vorlagen mit Ihrem eigenen Meta WhatsApp-Konto.

Falls etwas nicht funktioniert

  • „Wir konnten keine Verbindung mit diesen Details herstellen“ – kopieren Sie jeden Wert erneut; ein versehentliches Leerzeichen ist meist die Ursache. Die Meldung enthält Metas eigene Antwort, die normalerweise den falschen Wert nennt.
  • Der Fehler besagt, dass das Token fehlt whatsapp_business_management – Ihrer App wurde diese Berechtigung noch nicht erteilt. Gehen Sie zurück zu Teil 1, Schritt 3, klicken Sie auf Standardzugriff abrufen, generieren Sie dann ein neues Token, bei dem beide Berechtigungen aktiviert sind, und überprüfen Sie Ihre Details erneut. Das erneute Generieren des Tokens ohne diesen Schritt führt weiterhin zum selben Fehler.
  • Ihr Token ist verschwunden – Meta zeigt ein Token nur einmal an. Generieren Sie ein neues vom selben Systembenutzer; das alte funktioniert weiterhin, bis Sie es widerrufen, aber nur das neue ist sichtbar.
  • Von Ihnen gestartete Nachrichten kommen nicht an – beachten Sie den Hinweis zum 24-Stunden-Fenster oben: Außerhalb dieses Fensters werden nur Vorlagennachrichten zugestellt.
  • Es kommt überhaupt nichts an – die Nummer ist wahrscheinlich noch nicht für die Cloud-API aktiviert. Eine Nummer kann immer nur an einem Ort gleichzeitig aktiv sein. Wenn sie also noch in der WhatsApp Business-App auf einem Telefon angemeldet ist, entfernen Sie sie dort zuerst und drücken Sie dann auf Verbindung prüfen auf der Verbindungskarte. Your AI Connector aktiviert sie für Sie und teilt Ihnen sofort mit, falls Meta noch etwas fehlt.
  • „Diese Nummer hat bereits eine PIN für die zweistufige Verifizierung“ – die Nummer wurde zuvor irgendwo eingerichtet und hat ihre PIN behalten. Deaktivieren Sie die zweistufige Verifizierung dafür im WhatsApp Manager und drücken Sie dann auf Erneut verbinden.
  • „Meta hat diese Nummer noch nicht verifiziert“ – schließen Sie die Verifizierung der Nummer im WhatsApp Manager ab (Meta sendet einen Code an die Nummer) und drücken Sie dann auf Erneut verbinden.
  • „Diese Nummer wird über die On-Premises-API gehostet“ – sie läuft über das ältere, selbst gehostete Produkt von WhatsApp, das eine Nummer nicht mit der Cloud-API teilen kann. Migrieren Sie sie zuerst im WhatsApp Manager zur Cloud-API.