Artikel

WhatsApp Business API erklärt: Zugang, Vorlagen, Kosten und Anbindung an ein CRM

Die WhatsApp Business API ist der offizielle Weg von Meta, eine Nummer mit Software statt mit einem Handy zu verbinden. Hier lesen Sie, was Sie dafür brauchen, was es kostet und was sich im Arbeitsalltag ändert.

Kurz gesagt: Die WhatsApp Business API, heute als Cloud API bereitgestellt, ist die offizielle Schnittstelle von Meta, über die Software WhatsApp-Nachrichten für eine geschäftliche Nummer sendet und empfängt. Sie brauchen ein Business-Portfolio bei Meta, eine App, eine Telefonnummer mit Anzeigenamen und genehmigte Vorlagen für alles, was Sie außerhalb des 24-Stunden-Fensters nach der letzten Nachricht eines Kunden verschicken. Meta rechnet pro zugestellter Nachricht ab, nach Kategorie und Land; Nachrichten von Kunden sind kostenlos. NeuroCRM bindet die Cloud API von Hand mit Ihren eigenen Tokens an, alternativ steht das Gateway GREEN-API zur Verfügung.

Was ist die WhatsApp Business API?

Eine Schnittstelle, keine App. Sie laden nichts herunter, und es gibt keine Oberfläche, in die Sie sich einloggen. Ihre Software (ein CRM, ein Helpdesk, Ihr eigenes Skript) spricht über sie mit WhatsApp: Eingehende Nachrichten kommen an einer Webhook-Adresse an, Antworten gehen als API-Aufrufe hinaus.

Die Schnittstelle, die Meta heute dokumentiert, ist die Cloud API, gehostet von Meta selbst. Wer nach „whatsapp api“ oder „whatsapp cloud api“ sucht, meint genau sie. „WhatsApp Business Platform“ ist der übergeordnete Name, unter dem Meta sein gesamtes Messaging-Angebot für Unternehmen führt; die Cloud API ist die Schnittstelle darin.

Was Sie gegenüber einem Handy gewinnen: Mehrere Personen können über eine Nummer antworten, Nachrichten lassen sich von Software verschicken, und jeder Chat kann neben einem Kontakt und einem Deal stehen. Was Sie dafür in Kauf nehmen: Regeln für Vorlagen, ein 24-Stunden-Fenster und eine Abrechnung pro Nachricht – alles weiter unten beschrieben.

Worin unterscheiden sich die App WhatsApp Business, WhatsApp Business Web und die API?

  • App WhatsApp Business. Eine Handy-App, die laut WhatsApp für Inhaber kleiner Unternehmen gedacht ist. Ein Unternehmen, meist eine Person an der Tastatur.
  • WhatsApp Business Web. So suchen Menschen danach, dasselbe Geschäftskonto im Browser zu öffnen. Es bleibt das Chatfenster der App, keine Integration: Nichts ist mit Deals, Aufgaben oder Berichten verbunden.
  • WhatsApp Business API (Cloud API). Eine Programmierschnittstelle. Die Nummer wird auf der Plattform registriert, und die Chats bearbeitet ein Programm, kein Handy.

Wenn Sie nur wenigen Menschen vom Laptop aus antworten, reichen die App und ihre Browserversion womöglich aus. Wechseln Sie zur API, wenn sich mehrere Mitarbeiter die Nummer teilen, wenn Nachrichten automatisch hinausgehen sollen oder wenn die Gespräche in ein CRM fließen müssen.

Wer bekommt Zugang, und was brauchen Sie dafür?

Die Einstiegsanleitung von Meta verlangt ein Facebook-Konto oder ein verwaltetes Meta-Konto, eine Registrierung als Entwickler und ein Gerät mit WhatsApp für Testnachrichten. Im selben Ablauf wählen oder erstellen Sie ein Business-Portfolio bei Meta, legen eine App mit dem Anwendungsfall WhatsApp an und fügen eine Telefonnummer hinzu.

Für die Nummer gelten laut der Dokumentation von Meta zu Telefonnummern einige Regeln:

  • Eine Nummer, die bereits mit WhatsApp genutzt wird, lässt sich erst registrieren, wenn sie zuvor aus WhatsApp gelöscht wurde.
  • Sie muss Ihnen gehören, Länder- und Ortsvorwahl enthalten und zur Bestätigung eine SMS oder einen Anruf empfangen können.
  • Bei der Registrierung ist ein Anzeigename (Display Name) Pflicht. Er erscheint im WhatsApp-Profil der Nummer.

Zum Testen brauchen Sie noch keine Vorlagen: Der Schnellstart von Meta verschickt eine fertige Vorlage namens hello_world. Eigene genehmigte Vorlagen brauchen Sie, sobald Sie zuerst schreiben oder antworten, nachdem sich das Fenster geschlossen hat.

Wie funktioniert das 24-Stunden-Fenster?

Schreibt Ihnen ein Kunde oder ruft er an, öffnet sich ein 24-Stunden-Fenster. Jede neue Nachricht des Kunden startet es neu. Solange es offen ist, dürfen Sie frei formulierte Nachrichten senden. Ist es geschlossen, sind nur noch Vorlagennachrichten erlaubt (so steht es auf der Preisseite von Meta).

Vorlagen fallen in drei Kategorien: Marketing, Utility und Authentifizierung. Sie legen sie im WhatsApp Manager an, und Meta prüft sie; rechnen Sie mit etwas Wartezeit, bevor eine neue Vorlage nutzbar ist.

Wie rechnet Meta die WhatsApp Business API ab?

Laut der Preisseite von Meta, geprüft am 18. November 2026:

  • Seit dem 1. Juli 2025 berechnet Meta jede zugestellte Nachricht, nicht mehr jede Unterhaltung. Der Preis hängt von der Nachrichtenkategorie und der Ländervorwahl des Empfängers ab.
  • Nachrichten, die Kunden Ihnen schicken, werden nicht berechnet.
  • Vorlagen gehören zu Marketing, Utility oder Authentifizierung; Antworten ohne Vorlage innerhalb des Fensters zählen als Service. Außerdem führt Meta den Meta Business Agent auf.
  • Jede geschäftliche Telefonnummer bekommt 1.000 kostenlose Service-Nachrichten pro Monat, das Kontingent erneuert sich monatlich. Ab dem 1. Oktober 2026 werden Service-Nachrichten ab der 1.001. berechnet.
  • Ist für das Messaging-Konto keine Zahlungsmethode hinterlegt, stellt Meta Service-Nachrichten nur innerhalb des Freikontingents zu.
  • Utility-Vorlagen in einem offenen Fenster waren bis zum 30. September 2026 kostenlos und werden seit dem 1. Oktober 2026 berechnet.
  • Schreibt Ihnen ein Kunde über eine Click-to-WhatsApp-Anzeige in der mobilen App und Sie antworten innerhalb des Fensters, öffnet sich ein kostenloses Einstiegsfenster von bis zu 7 Tagen für Marketing-, Utility-, Authentifizierungs- und Service-Nachrichten.

Die Dollarpreise stehen in Preistabellen, die Meta auf dieser Seite verlinkt, und unterscheiden sich nach Land und Kategorie. Sehen Sie in der Tabelle für Ihre Länder nach, bevor Sie ein Budget planen; einen konkreten Preis nennen wir hier nicht.

Die Gebühren von Meta gehen an das WhatsApp-Konto, das Sie verbinden. Ein CRM oder ein anderer Softwareanbieter berechnet seine eigene Gebühr zusätzlich.

Kann ich darüber Marketingnachrichten und Bots verschicken?

Ja, im Rahmen der Regeln von Meta: Marketingvorlagen sind eine eigene Nachrichtenkategorie mit eigenem Preis, und ein Bot ist Software, die dieselbe API nutzt und denselben Regeln für Fenster und Vorlagen unterliegt.

„Nachricht über die WhatsApp API senden“ heißt in der Praxis zweierlei: eine frei formulierte Nachricht innerhalb des Fensters oder eine Vorlagennachricht außerhalb davon. Welche Variante möglich ist, entscheidet der Zeitpunkt der letzten Nachricht des Kunden.

Wie verbindet sich NeuroCRM mit der WhatsApp Business API?

NeuroCRM bietet zwei Wege, WhatsApp anzubinden. Einen ausführlicheren Vergleich der beiden finden Sie unter WhatsApp-CRM: offizielle API oder QR-Gateway. Dieser Artikel behandelt die API-Seite im Detail.

Die Cloud API von Hand verbinden

Unter Einstellungen → Integrationen wählen Sie WhatsApp Business Cloud API und füllen vier Felder aus:

  1. „Telefonnummer-ID“ (Phone Number ID) aus dem Bildschirm API Setup bei Meta.
  2. „Permanenter Zugriffstoken (Systembenutzer)“, den Sie in den Business-Einstellungen unter System Users (Systembenutzer) erzeugen.
  3. „App-Geheimnis“ (App Secret), mit dem die Signatur eingehender Webhooks geprüft wird.
  4. „WhatsApp Business Account ID“ (WABA ID).

Klicken Sie dann auf „Verifizieren und verbinden“. NeuroCRM zeigt eine Callback-URL und ein Verify Token; beides fügen Sie in Ihrer Meta-App unter WhatsApp → Configuration → Webhooks ein und abonnieren das Feld messages. Sie können mehrere Nummern hinzufügen.

Eine Ein-Klick-Lösung gibt es nicht. Die Meta-App, den Systembenutzer und den Token legen Sie selbst an – planen Sie für die erste Verbindung also etwas Zeit ein. Richten Sie die Seite bei Meta ein, bevor Sie loslegen.

Was Ihre Mitarbeiter sehen

Jeder WhatsApp-Chat landet mit einer Kontaktkarte im selben Posteingang wie Ihre anderen Kanäle. NeuroCRM misst die 24 Stunden ab der jüngsten echten WhatsApp-Nachricht des Kunden und behandelt das Fenster schon fünf Minuten vor Ablauf als geschlossen.

Ist das Fenster geschlossen, verschickt NeuroCRM statt Ihres Textes eine genehmigte Vorlage: die von Ihnen gewählte, die Standardvorlage des Arbeitsbereichs oder eine genehmigte Vorlage ohne Variablen und Medien. Ihr Entwurf bleibt im Eingabefeld stehen, bis der Kunde antwortet. Ohne genehmigte Vorlage wird das Senden abgelehnt, und eine zweite Vorlage geht vor der Antwort des Kunden nur hinaus, wenn Sie erneut eine aus der Liste wählen.

Regeln, Automatisierungen und KI

  • Automatisierungen. Außerhalb des Fensters sendet eine Automatisierung nichts und wählt auch keine Vorlage aus: Der Schritt wird als nicht gesendet markiert. Bei Deal-Ereignissen geht die Nachricht in das älteste Gespräch des Kontakts, gleich über welchen Kanal.
  • Vertriebssequenzen. Ein WhatsApp-Schritt verschickt die genehmigte Vorlage, die Sie in diesem Schritt angeben.
  • KI-Antworten. Das Neuro Contact Center ist ein kostenpflichtiges Zusatzmodul: 200 $ im Monat plus 0,50 $ pro erfolgreichem Dialog, mit Ihrem eigenen KI-Schlüssel ohne Aufschlag (0 %) oder über NeuroCRM mit +20 %. Außerhalb des 24-Stunden-Fensters antwortet es nicht und schickt auch keine Vorlage. Termine bucht es nicht selbst.

Die Alternative GREEN-API

GREEN-API ist ein inoffizielles Gateway. Sie verknüpfen eine private Nummer per QR-Code in der Konsole von GREEN-API und tragen dann idInstance und apiTokenInstance in NeuroCRM ein. Der Hinweis der Integration selbst sagt, sie eigne sich für „Fälle, in denen die offizielle WhatsApp Business API nicht verfügbar ist“. Es ist nicht die Plattform von Meta, die oben beschriebenen Regeln für Vorlagen und Fenster gelten hier also nicht.

Was kann NeuroCRM mit der WhatsApp Business API nicht?

  • Keine Verbindung per Klick. Die Zugangsdaten von Meta werden von Hand eingetragen; den Ablauf Embedded Signup von Meta gibt es nicht als Schaltfläche.
  • Keine Coexistence. Eine Nummer, die gleichzeitig in der App WhatsApp Business und über die API genutzt wird, funktioniert mit NeuroCRM nicht.
  • Die Nachrichtengebühren von Meta sind nicht im Preis pro Nutzer enthalten und werden nicht von NeuroCRM festgelegt; Meta stellt sie dem Konto in Rechnung, das Sie verbinden.
  • Keine automatische Wahl einer Vorlage durch Automatisierungen oder die KI außerhalb des 24-Stunden-Fensters.

Was kostet WhatsApp in NeuroCRM?

Ein Nutzer kostet 13 $ im Monat oder 10,40 $ bei jährlicher Zahlung; einen Gratis-Tarif gibt es nicht. Die 14-tägige Testphase enthält alle Funktionen und beliebig viele Nutzer, danach ist der Arbeitsbereich nur noch lesbar. Siehe Preise. Das Neuro Contact Center ist das oben beschriebene separate Zusatzmodul. Die Gebühren von Meta pro Nachricht sind ein dritter Posten, den Meta abrechnet.

Für einen Vergleich von Systemen lesen Sie die NeuroCRM-Vergleiche und den Ratgeber zu Kommo-Alternativen. Wie WhatsApp neben Ihren anderen Kanälen läuft, zeigt der Artikel über den gemeinsamen Posteingang.

Checkliste vor dem Verbinden

  1. Wählen Sie eine Nummer, die Ihnen gehört und auf der Sie eine Bestätigungs-SMS oder einen Anruf empfangen können. Ist sie bereits in WhatsApp, planen Sie ein, sie dort zuerst zu löschen.
  2. Legen Sie das Business-Portfolio bei Meta, die App mit dem Anwendungsfall WhatsApp und einen Systembenutzer mit dauerhaftem Token an.
  3. Legen Sie den Anzeigenamen fest.
  4. Hinterlegen Sie bei Meta eine Zahlungsmethode, sonst werden Service-Nachrichten über das Freikontingent hinaus nicht zugestellt.
  5. Reichen Sie im WhatsApp Manager mindestens eine Utility-Vorlage ein und warten Sie vor dem Start auf die Freigabe durch Meta.
  6. Notieren Sie Phone Number ID und WABA ID aus dem Bildschirm API Setup.
  7. Verbinden Sie die Nummer in NeuroCRM, kopieren Sie Callback-URL und Verify Token zu Meta und abonnieren Sie messages.
  8. Schicken Sie sich selbst eine Nachricht, beantworten Sie sie, warten Sie dann ab, bis das Fenster abläuft, und testen Sie eine Vorlage.

Häufige Fragen

Ist die WhatsApp Business API kostenlos?

Nicht ganz. Meta berechnet jede zugestellte Nachricht – ausgenommen Nachrichten von Kunden, die ersten 1.000 Service-Nachrichten pro Nummer und Monat und Nachrichten in einem kostenlosen Einstiegsfenster.

Was ist der Unterschied zwischen der WhatsApp API und der Cloud API?

Bei einer neuen Einrichtung ist das in der Praxis dasselbe: Die Cloud API ist die Version, die Meta hostet und dokumentiert, und genau sie nutzt die Integration WhatsApp Business Cloud API in NeuroCRM.

Kann ich die Nummer meiner App WhatsApp Business mit der API nutzen?

Laut Meta muss eine Nummer, die bereits mit WhatsApp genutzt wird, vor der Registrierung aus WhatsApp gelöscht werden. Über NeuroCRM lässt sich eine Nummer nicht gleichzeitig in der App und über die API nutzen (Coexistence).

Warum ist meine Nachricht nicht beim Kunden angekommen?

Zwei häufige Gründe: Das 24-Stunden-Fenster war geschlossen, und die Nachricht war keine Vorlage – oder für das Meta-Konto war keine Zahlungsmethode hinterlegt, als die kostenlosen Service-Nachrichten aufgebraucht waren. Bei geschlossenem Fenster verschickt NeuroCRM Ihren freien Text nicht; es sendet zuerst eine genehmigte Vorlage und lässt Ihren Text im Eingabefeld stehen.

Können mehrere Personen über eine API-Nummer antworten?

Ja. Die Chats einer Nummer landen in NeuroCRM in einem gemeinsamen Posteingang, und Sie können mehrere Nummern verbinden.

Quellen

  • Meta, Preise der WhatsApp Business Platform — https://developers.facebook.com/docs/whatsapp/pricing (geprüft am 18. November 2026)
  • Meta, Einstieg in die Cloud API — https://developers.facebook.com/docs/whatsapp/cloud-api/get-started (geprüft am 18. November 2026)
  • Meta, Telefonnummern — https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers (geprüft am 18. November 2026)
  • App WhatsApp Business — https://whatsappbusiness.com/products/business-app/ (geprüft am 18. November 2026)

So ist dieser Artikel entstanden: Das NeuroCRM-Team hat ihn mit Unterstützung von KI geschrieben; Aussagen zum Produkt wurden am Code und an der Hilfe von NeuroCRM geprüft; die Preise stammen aus der veröffentlichten Preisliste zum Aktualisierungsdatum.