WhatsApp Business API mit KI wie ChatGPT nutzen

Wie arbeitet eine KI mit der WhatsApp Business API?

Eine KI arbeitet über die Schnittstelle Ihrer WhatsApp-Software mit der WhatsApp Business Platform, häufig WhatsApp Business API genannt. Sie bedient dabei nicht die WhatsApp-App. Die Software verwaltet etwa Kontakte, Vorlagen, Einwilligungen und Kampagnen. Über deren offene API kann ein KI-Dienst Daten abrufen und Abläufe auslösen.

In Vertrieb und Kundenbetreuung von hellomateo geht es dabei um zwei unterschiedliche Aufgaben:

• Die KI antwortet Ihren Kunden. Dafür gibt es bei hellomateo den KI-Assistenten im Chat. Er beantwortet Fragen anhand des Wissens, das Sie hinterlegen.
• Die KI arbeitet für Ihr Team. Sie wertet eingehende Nachrichten aus, gleicht Kontaktlisten ab oder stößt einen Versand an. Diese Aufgaben behandelt der Ratgeber. Das Modul KI-Assistent im Chat ist dafür nicht erforderlich.

Die Anbindung je Dienst erklären die Seiten Claude mit WhatsApp verbinden und ChatGPT mit WhatsApp verbinden.

Prüfen Sie zuerst, ob eine vorhandene Anbindung Ihren Ablauf bereits abdeckt: hellomateo bietet über 70 direkte Integrationen in Branchensoftware. Je nach System übernehmen sie Kontakte, Aufträge und Termine. Die Integrationsübersicht zeigt die Möglichkeiten. Für zusätzliche Abläufe steht die offene API bereit.

Gesonderte Regeln gelten für Anbieter allgemeiner KI-Assistenten, die selbst als Kontakt in WhatsApp erreichbar sind. Seit dem 15. Januar 2026 erlaubt Meta solche Angebote auf der WhatsApp Business Platform nur dort, wo Meta rechtlich dazu verpflichtet ist. Für Nutzer mit deutschen (+49) und österreichischen (+43) Nummern sind sie seit dem 11. März 2026 wieder zugelassen. Die Schweiz steht nicht in Metas Liste. Nach dem Wortlaut betrifft die Einschränkung Angebote, bei denen die KI die Hauptfunktion und nicht nur eine Nebenfunktion ist. Die Einordnung liegt in Metas eigenem Ermessen.

Quellen: Meta: Bedingungen für die WhatsApp Business Platform, Abschnitt 4.7, Stand 23.09.2026; Meta: Regeln für KI-Anbieter, Stand 15.10.2026; hellomateo: Integrationen. Abgerufen am 10.11.2026.

Was lässt sich mit KI und der API von hellomateo automatisieren?

Mit der API von hellomateo können Sie eingehende Nachrichten auswerten, Kontakte und Einwilligungen abgleichen sowie genehmigte Vorlagen versenden. Die öffentliche API-Beschreibung enthielt am 10. November 2026 insgesamt 193 Funktionen, etwa „Kontakte auflisten“ oder „Nachricht senden“. Die Tabelle unterscheidet zwischen selbst ausgeführten Abrufen und Möglichkeiten laut Dokumentation.

Für schreibende Aufgaben müssen die Voraussetzungen in hellomateo erfüllt sein: Eine WhatsApp-Vorlage braucht Metas Genehmigung, eine von außen gestartete Kundenreise einen API-Auslöser. Der Abruf „Nachricht senden“ verlangt keine Angabe zur Einwilligung. Ihr Programm muss die Einwilligung deshalb vor dem Versand abfragen. Aktivieren Sie bei Kampagnen außerdem „require_marketing_opt_in“. Meta verlangt für eigene Kontaktaufnahmen eine vorherige Einwilligung.

Für zugestellte Vorlagen berechnet Meta Gebühren, die hellomateo ohne Aufschlag weitergibt. Einzelheiten stehen im Beitrag zu den Kosten der WhatsApp Business API.

Quellen: hellomateo: OpenAPI-Beschreibung; hellomateo: Kontakte importieren; Meta: Nachrichtenregeln; eigener Test am 10.11.2026. Abgerufen am 10.11.2026.

Welche drei Wege verbinden eine KI mit der WhatsApp Business API?

Sie können ein von der KI geschriebenes Programm selbst starten, einen KI-Agenten die Abrufe ausführen lassen oder die KI in einen Automatisierungsdienst einbauen. Bei der API von hellomateo unterscheiden sich diese Wege vor allem darin, wer den Ablauf startet und welche Daten die KI erhält.

Ein KI-Agent arbeitet mit sämtlichen Rechten des Tokens und kann das Token selbst auslesen. Die Anweisung „nur lesen“ beschränkt seine Rechte technisch nicht. Lassen Sie sich Befehle vor der Ausführung zeigen und bestätigen Sie jeden schreibenden Abruf einzeln. Bei einem Automatisierungsdienst ist das Token dauerhaft hinterlegt. Legen Sie dort fest, wer darauf zugreifen darf.

Make und n8n können die API von hellomateo direkt aufrufen. Die Zapier-App heißt „Mateo“. Sie bietet Aktionen wie das Anlegen eines Kontakts oder den Versand einer Vorlage, aber keine Auslöser. Für eine Reaktion auf eingehende Nachrichten brauchen Sie deshalb einen Webhook. Er meldet einem anderen System automatisch ein Ereignis.

Webhooks richten Sie in hellomateo unter „Einstellungen > Integrationen > Webhooks“ ein. Die Einrichtung mit Zapier erklären die Seiten zu Claude und ChatGPT sowie der Beitrag zur Zapier-Integration.

Quellen: Anthropic: Claude Code; OpenAI: Codex; n8n: HTTP Request; n8n: KI-Agent-Baustein; Make: HTTP; Zapier: Mateo; hellomateo: Webhooks; hellomateo: Integrationen. Abgerufen am 10.11.2026.

Was brauchen Sie für KI und die API von hellomateo?

Für die API von hellomateo brauchen Sie mindestens das Paket Business, ein API-Token und einen KI-Dienst wie ChatGPT oder Claude. Wenn die KI ein Python-Programm schreibt, das Sie selbst starten, benötigen Sie zusätzlich Python und ein Terminal auf Ihrem Rechner.

• Paket: Der API-Zugang ist ab hellomateo Business enthalten.
• API-Token: Ein Administrator erstellt es unter „Einstellungen > Integrationen > API-Token“. Mit diesem Schlüssel meldet sich ein Programm an Ihrem hellomateo-Konto an.
• Dokumentation: Unter developers.getmateo.com stehen die öffentliche Anleitung und eine maschinenlesbare Beschreibung im Format OpenAPI. Daraus kann die KI entnehmen, welche Angaben ein Abruf benötigt und welche Daten er zurückgibt.
• Version: Die Dokumentation ist als „Release Candidate“ gekennzeichnet. Das bedeutet, dass die API vor der allgemeinen Freigabe abschließend geprüft wird. Laut Dokumentation soll das Verhalten der mitgesendeten Version erhalten bleiben. Bis zur Freigabe sind dennoch kleinere Änderungen möglich.

Quellen: hellomateo: Einführung in die API; hellomateo: Anmeldung mit API-Token; hellomateo: Versionen; hellomateo: OpenAPI-Beschreibung; hellomateo: Preise. Abgerufen am 10.11.2026.

Wie starten Sie mit KI und der API von hellomateo?

Starten Sie mit einer lesenden Auswertung über die API von hellomateo. Damit können Sie den Ablauf prüfen, ohne Nachrichten zu versenden oder Kontakte zu ändern.

1. Token erstellen. Legen Sie für die Aufgabe ein eigenes API-Token in hellomateo an. Wählen Sie einen eindeutigen Namen, etwa „KI-Auswertung“.
2. Token hinterlegen. Speichern Sie es als Umgebungsvariable. Das ist eine Angabe, die das Programm auf Ihrem Rechner auslesen kann. Die Befehle stehen unter dieser Liste. Geben Sie das Token nicht in den KI-Chat ein.
3. Aufgabe beschreiben. Nennen Sie das gewünschte Ergebnis, die Adresse der OpenAPI-Beschreibung und die benötigten Kopfzeilen. Kopfzeilen sind Zusatzangaben bei jedem Abruf: „Authorization“ übermittelt das Token, „hellomateo-version“ die API-Version.
4. Programm starten. Speichern Sie den erzeugten Text als Programmdatei, beispielsweise nachrichten.py. Starten Sie sie im selben Terminalfenster mit „python3 nachrichten.py“, unter Windows mit „python nachrichten.py“.
5. Ergebnis kontrollieren. Das Programm speichert eine CSV-Datei im selben Ordner. Diese Tabelle können Sie in Excel öffnen. Vergleichen Sie eine Stichprobe mit hellomateo, bevor Sie die Zahlen verwenden.
6. Schreibende Abläufe gesondert testen. Wenn später Kontakte geändert oder Nachrichten versendet werden sollen, prüfen Sie den Ablauf zuerst mit einem eigenen Testkontakt.

Mit diesen Befehlen hinterlegen Sie das Token für das geöffnete Fenster:

# macOS und Linux, im Terminal
export HELLOMATEO_TOKEN="Ihr Token"
# Windows, in der PowerShell
$env:HELLOMATEO_TOKEN="Ihr Token"

Übergeben Sie der KI diese Aufgabenbeschreibung:

hellomateo hat zwei Programme nach dieser Beschreibung am eigenen Konto ausgeführt: eines von Claude Code am 10. November 2026, eines von Codex von OpenAI am 11. November 2026. Beide nutzen zwei API-Funktionen: den Probeabruf und die seitenweise Liste eingehender Nachrichten. Ausgewertet wurden die eingehenden WhatsApp-Nachrichten aus 30 Tagen. Beide Auswertungen zeigten dasselbe Muster: Die meisten Nachrichten entfielen auf Montage und nur wenige auf das Wochenende. Ein Autohaus kann anhand einer solchen Tabelle beispielsweise die Betreuung des Postfachs planen.

Die bei den Tests verwendete aktuelle API-Version hieß 2026-11-12. Neuere Versionen finden Sie in der Dokumentation.

Die Verbindung können Sie auch ohne das Python-Programm prüfen. Geben Sie dazu im Terminal von macOS oder Linux den folgenden Befehl ein. Gibt die API den Namen Ihres Tokens zurück, funktioniert die Anmeldung:

curl "https://api.getmateo.com/v1/me" \
  --header "Authorization: Bearer $HELLOMATEO_TOKEN" \
  --header "hellomateo-version: 2026-11-12"

Quellen: hellomateo: Einführung in die API; hellomateo: Seitenweise Abrufe; eigener Test am 10.11.2026. Abgerufen am 10.11.2026.

Welche Fehlermeldungen der API von hellomateo treten auf?

Beim Test der API von hellomateo am 10. November 2026 traten fünf unterschiedliche Fehler auf: fehlende oder ungültige Version, ungültiges Token, eine abgewiesene Programmkennung und eine falsche Adresse. Geben Sie der KI den Fehlercode ohne Token und Kundendaten. Damit kann sie das Programm häufig korrigieren. Beim Fehler 1010 hilft zusätzlich die Erklärung aus der Tabelle.

Bei den ersten drei Fehlern steht eine „request_id“ im Antworttext. Die Kennung wird auch als Kopfzeile „Request-Id“ übermittelt. Die Meldung 1010 entsteht vor der API und enthält keine solche Kennung. Wenn Sie die Kundenbetreuung von hellomateo einschalten, geben Sie eine vorhandene Kennung mit an.

Manche Fehler entstehen bereits auf Ihrem Rechner: „No module named requests“ bedeutet, dass die Bibliothek fehlt. „KeyError: HELLOMATEO_TOKEN“ weist auf die fehlende Umgebungsvariable hin. Auch diese Meldungen können Sie der KI zur Korrektur geben.

Quellen: eigener Test am 10.11.2026; hellomateo: Fehler. Abgerufen am 10.11.2026.

Was müssen Sie bei Sicherheit und Datenschutz beachten?

Schützen Sie ein API-Token von hellomateo wie ein Passwort: Es erlaubt den Zugriff auf alle Daten und Funktionen der API, einschließlich Ändern, Senden und Löschen. Einzelne Rechte lassen sich für ein Token nicht begrenzen, Stand 10. November 2026.

• Geben Sie das Token niemals in einen KI-Chat, eine E-Mail oder ein geteiltes Dokument ein.
• Erstellen Sie je Aufgabe ein eigenes Token mit eindeutigem Namen.
• Löschen Sie nach Abschluss nur das Token dieser Aufgabe. Wird ein Token von Ihrer Branchensoftware, Zapier oder einem anderen Ablauf verwendet, unterbricht das Löschen dessen Verbindung.
• Löschen und ersetzen Sie ein betroffenes Token sofort, wenn Sie Missbrauch vermuten.
• Beginnen Sie mit einem rein lesenden Lauf. Verwenden Sie für schreibende Abläufe zunächst einen Testkontakt.
• Lassen Sie einen KI-Agenten nur Feldnamen und Zählwerte ausgeben, keine Inhalte. So wurde der Test von hellomateo durchgeführt.
• Lassen Sie Programm und Ergebnis von einem Menschen prüfen, bevor Nachrichten an Kunden gehen.

Namen, Telefonnummern und Chatinhalte sind personenbezogene Daten. Schreibt die KI lediglich das Programm und Sie führen es selbst aus, erhält die KI diese Daten nicht, solange Sie keine entsprechenden Ergebnisse oder Fehlermeldungen in den Chat kopieren. Führt ein KI-Agent die Abrufe aus, kann er die Antworten verarbeiten. In einem Automatisierungsdienst erhält die KI den Ausschnitt, den Sie dem KI-Schritt übergeben; der Automatisierungsdienst verarbeitet die Daten seines Ablaufs.

Verarbeitet ein Dienst personenbezogene Daten in Ihrem Auftrag, verlangt Art. 28 Abs. 3 DSGVO einen Vertrag zur Auftragsverarbeitung. Prüfen Sie vor dem ersten Abruf echter Kundendaten, ob Ihr Tarif einen solchen Vertrag vorsieht. Näheres erklärt der Beitrag zum AV-Vertrag für WhatsApp Business.

hellomateo speichert Plattformdaten bei Amazon Web Services in Frankfurt, stellt einen Vertrag zur Auftragsverarbeitung nach Art. 28 DSGVO bereit und verwendet Ihre Daten nicht zum Training von KI-Modellen. Diese Angaben beziehen sich auf hellomateo. Für einen zusätzlich angebundenen KI-Dienst oder Automatisierungsdienst müssen Sie die Bedingungen gesondert prüfen.

Metas Abschnitt 4.1 untersagt die Weitergabe von Daten der WhatsApp Business Platform an Dritte, ausgenommen an Lösungsanbieter nach diesen Bedingungen. Das umfasst auch anonymisierte, zusammengefasste und abgeleitete Daten. Wird ein KI-Anbieter als Lösungsanbieter beauftragt, untersagt Abschnitt 4.7 grundsätzlich die Nutzung dieser Daten zum Erstellen, Entwickeln, Trainieren oder Verbessern von KI-Modellen. Der Wortlaut nennt eine begrenzte Ausnahme: die Feinabstimmung eines Modells ausschließlich für die eigene Nutzung, sofern dadurch keine anderen Modelle erstellt, entwickelt, trainiert oder verbessert werden.

Klären Sie die Zulässigkeit Ihres Vorhabens, bevor ein KI-Dienst Chatinhalte oder Kontaktdaten aus WhatsApp verarbeitet. Beim ersten Weg können Sie die Auswertung lokal durchführen und die Zählwerte auf Ihrem Rechner behalten, ohne Daten an die KI weiterzugeben.

Quellen: hellomateo: Anmeldung mit API-Token; Meta: Bedingungen für die WhatsApp Business Platform, Abschnitte 4.1 und 4.7, Stand 23.09.2026; Art. 28 DSGVO. Abgerufen am 10.11.2026.

Wo liegen die Grenzen von KI und API bei hellomateo?

Eine KI kann über die API von hellomateo nur die vorhandenen Funktionen nutzen und auf dem aufbauen, was Sie in hellomateo eingerichtet haben. Für Ihre Planung sind vier Grenzen relevant:

• Kampagnen: Über die API können Sie einmalige Kampagnen anlegen und sofort oder zu einem festgelegten Zeitpunkt senden. Wiederkehrende Abläufe richten Sie als Kundenreise in hellomateo ein. Die Kampagnenauswertung über die API lieferte beim Test am 10. November 2026 für die Kampagnen des eigenen Kontos keine Zahlen. Nutzen Sie für diese Auswertung deshalb den Kampagnenbericht in hellomateo.
• Versand: Außerhalb der 24 Stunden nach der letzten Kundennachricht sind nur genehmigte Vorlagen erlaubt. Frei formulierte KI-Texte kommen als Antwort im offenen Zeitfenster oder als Platzhalterwert einer Vorlage infrage. Beides braucht eine Prüfung.
• Größe: Ein Abruf darf in der Regel höchstens 1 MB Inhalt senden. Für Sammelimporte von Kontakten, Aufträgen und Terminen gelten 5 MB.
• Webhooks: hellomateo hat die Webhooks im November 2026 erneuert. Verwenden Sie für die Einrichtung die aktuelle Dokumentation.

Wie Sie ein Vertriebs-CRM anbinden, erklärt der Ratgeber zur WhatsApp CRM Integration.

Quellen: hellomateo: OpenAPI-Beschreibung; hellomateo: Größenbegrenzungen; Meta: Nachrichtenregeln. Abgerufen am 10.11.2026.