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.

2. 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.

3. 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.
4. 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.

Wechsel von der verwalteten Verbindung #

Sie können mit der verwalteten WhatsApp Business-Verbindung beginnen und später zu Ihrer eigenen Meta-App wechseln. Beide existieren im selben Konto, daher muss nichts neu erstellt werden.

• Ihre Kontakte und Ihr Chatverlauf bleiben erhalten. Kontakte, Unterhaltungen, Tags, Agenten und die Wissensdatenbank gehören zu Ihrem Konto, nicht zur Verbindung. Das Entfernen oder Ersetzen einer Nummer löscht nichts davon, und wenn jemand, der Ihnen zuvor geschrieben hat, die Nummer erneut kontaktiert, landet dies in derselben Unterhaltung.
• Die Nummer muss zuerst auf der Seite von Meta verschoben werden. WhatsApp erlaubt es, dass eine Nummer jeweils nur an einem Ort aktiv ist. Bitten Sie den Support, die Nummer aus der verwalteten Einrichtung freizugeben, fügen Sie sie Ihrem eigenen WhatsApp Business Account im WhatsApp Manager hinzu und folgen Sie dann den Schritten auf dieser Seite. Rechnen Sie damit, dass die Nummer während des Wechsels für kurze Zeit offline ist.
• Verwenden Sie eine Nummer, die Ihnen gehört, wenn Sie einen Wechsel planen. Eine innerhalb von Your AI Connector gemietete Nummer ist eine virtuelle Leitung, die zur verwalteten Einrichtung gehört und nicht einfach auf Ihre eigene Meta-App übertragen werden kann. Ein Wechsel würde also eine neue WhatsApp-Nummer bedeuten.
• Vorlagen müssen erneut genehmigt werden. Meta genehmigt Vorlagen pro WhatsApp Business Account. Erstellen Sie daher die von Ihnen verwendeten Vorlagen unter Ihrem eigenen Konto neu (siehe Vorlagen unten).
• Agenturen: Jedes Unterkonto verbindet seine eigene Meta-App, sodass Kunden einzeln nacheinander wechseln können.

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 eine Nachricht gesendet haben. Außerhalb dieses Zeitfensters erlaubt WhatsApp Unternehmen nur dann, Konversationen mit einer genehmigten Nachrichtenvorlage zu beginnen – eine einfache Textnachricht wird von Meta zwar akzeptiert, aber nicht zugestellt.
• Meta stellt Ihnen Konversationen direkt zu den veröffentlichten länderspezifischen Tarifen über die in Ihrem WhatsApp-Konto bei Meta hinterlegte Zahlungsmethode in Rechnung. Your AI Connector berechnet für diese Verbindung keine Gebühren pro Nachricht; die KI-Nutzung wird wie gewohnt in Credits abgerechnet.
• Hinterlegen Sie eine gültige Zahlungsmethode in diesem WhatsApp-Konto. Ohne diese blockiert Meta jede Konversation, die Ihr Unternehmen initiiert – Broadcasts und jede Vorlagennachricht – und zeigt den Fehler im WhatsApp Manager an. Bei dieser Verbindung wird ein Broadcast nicht gestartet, solange dies der Fall ist, und Sie werden aufgefordert, eine Zahlungsmethode hinzuzufügen, anstatt dass jede Nachricht einzeln fehlschlägt. Antworten an Personen, die Ihnen zuerst geschrieben haben, werden derzeit noch versendet, 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 die Anzahl der Kontakte und die Länderaufteilung mit dem Hinweis an, dass Meta diese Ihrem WhatsApp Business-Konto in Rechnung stellt, anstatt eine Gesamtsumme in Credits.
• Testnummern sind kostenlos. Die Testnummer, die Meta jeder neuen App zuweist, kann bis zu fünf verifizierte Empfänger kostenlos anschreiben – eine praktische Möglichkeit, das vollständige Setup auszuprobieren, bevor Sie eine echte Nummer damit verknüpfen.

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 Daten herstellen“ — kopieren Sie jeden Wert erneut; ein versehentliches Leerzeichen ist meist die Ursache. Die Meldung enthält die Antwort von Meta, die normalerweise den falschen Wert nennt.
• Die Fehlermeldung 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, drücken Sie auf Standardzugriff abrufen, generieren Sie dann ein neues Token, bei dem beide Berechtigungen aktiviert sind, und überprüfen Sie Ihre Daten 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 für denselben Systembenutzer; das alte funktioniert weiterhin, bis Sie es widerrufen, aber nur das neue ist sichtbar.
• Antworten schlagen fehl mit „Diese Konversation ging über die WhatsApp Business-Nummer … ein, die nicht die verbundene Nummer ist“ — Ihre Meta-App hat mehr als eine Nummer, und Kunden schreiben an eine Nummer, die hier nicht verbunden ist. Ihre Nachrichten werden zwar angezeigt, da Meta die Nachrichten der App für jede Nummer sendet, aber Antworten können nur von der verbundenen Nummer aus gesendet werden, weshalb die KI sie nicht beantwortet. Die WhatsApp-Karte auf der Seite Kanäle zeigt eine Warnung mit dieser Nummer an, während die Nachrichten weiterhin eingehen. Die Zeile der Nummer auf dieser Karte hat keine Schaltfläche „Neu verbinden“ (nur Als primär festlegen und Löschen): Öffnen Sie Ihre Meta-App-Verbindungsseite erneut (WhatsApp verbinden auf der Karte WhatsApp Business API, dann Eine bereits vorhandene Nummer verwenden, dann Ihre eigene Meta-App), drücken Sie auf der dortigen Verbindungskarte auf Neu verbinden und wählen Sie die Nummer aus, an die Ihre Kunden tatsächlich schreiben. Das Token des Systembenutzers benötigt Zugriff auf dieses WhatsApp-Konto. Wenn diese Nummer Your AI Connector überhaupt nicht erreichen soll, entfernen Sie sie (oder ihr WhatsApp-Konto) stattdessen aus Ihrer Meta-App.
• 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 der Verbindungskarte auf Verbindung überprüfen. 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 bereits irgendwo eingerichtet und hat ihre PIN behalten. Deaktivieren Sie die zweistufige Verifizierung dafür im WhatsApp Manager und drücken Sie dann auf Neu 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 Neu verbinden.
• „Diese Nummer wird über die On-Premises API gehostet“ — sie läuft über das ältere, selbst gehostete Produkt von WhatsApp, das sich eine Nummer nicht mit der Cloud API teilen kann. Migrieren Sie sie zuerst im WhatsApp Manager zur Cloud API.