WhatsApp-Gruppen und die API bei einer Coexistence-Nummer
Mit der Groups API von Meta kann eine Cloud API-Nummer kleine Gruppen mit Einladungslink anlegen und dort Nachrichten senden. Laut Meta ist sie aber für Nummern der WhatsApp Business App nicht verfügbar, und genau das ist eine Coexistence-Nummer. Bestehende Gruppen aus der App werden auch nicht synchronisiert. Auf einer geteilten Nummer bleiben Gruppen eine reine App-Funktion.
Die Groups API für Telefonnummern der WhatsApp Business App, von Meta mit dem Coexistence-Onboarding verknüpft.
Maximale Teilnehmerzahl einer Gruppe, die über die Groups API erstellt wurde.
Die Groups API steht Unternehmen mit einem Official Business Account offen.
Gruppenchats auf einer Nummer, die aus der WhatsApp Business App onboarded wurde.
Gibt es für WhatsApp eine Groups API?
Ja. Mit der Groups API von Meta kann ein Unternehmen auf einer Cloud API-Nummer Gruppen erstellen, auflisten und aktualisieren, Text, Medien und Template-Nachrichten hineinsenden, den Einladungslink verwalten, Beitrittsanfragen annehmen oder ablehnen und Teilnehmer entfernen.
Sie ist bewusst klein gehalten. Gruppen sind nur per Einladung zugänglich, der Beitritt läuft über einen Link, den das Unternehmen verschickt, und die Limits von Meta beschreiben eher einen Projektraum als eine Community.
- Bis zu 8 Teilnehmer pro Gruppe.
- Bis zu 10.000 Gruppen pro Unternehmensnummer.
- Ein Cloud API-Unternehmen pro Gruppe.
- Text, Medien, textbasierte Templates und medienbasierte Templates.
Kann eine Coexistence-Nummer sie nutzen?
Nein. Auf der Seite zur Groups API steht, dass sie für Telefonnummern der WhatsApp Business App nicht verfügbar ist. Diese Formulierung verweist auf Metas eigene Anleitung zum Onboarding von Nutzern der WhatsApp Business App, also auf Coexistence. Als Voraussetzung gilt außerdem ein Official Business Account. Diesen Status vergibt Meta laut der eigenen OBA-Seite nicht an Telefonnummern der WhatsApp Business App.
Der Ausschluss gilt also von Meta aus für jeden Anbieter. Eine Nummer, die zwischen der App und der API geteilt wird, kann über die API keine Gruppen erstellen, nichts in sie senden und erhält keine Gruppenereignisse.
Was passiert mit den Gruppen, die schon in der App sind?
Sie bleiben in der App und funktionieren dort weiter. Die Coexistence-Dokumentation von Meta nennt Gruppenchats unter den Inhalten, die beim Onboarding einer Nummer nicht synchronisiert werden. Weder der Verlauf noch neue Gruppennachrichten erreichen also die API.
Das Team am Telefon kann weiterhin Gruppen erstellen, darin schreiben und sie lesen, genau wie zuvor. Software sieht diesen Datenverkehr schlicht nicht. Hängt ein Ablauf an einer Gruppe, etwa wenn Mitarbeitende Lieferungen abstimmen, läuft er in der App weiter. Jede Automatisierung drumherum muss stattdessen auf Einzelchats aufbauen.
Was kann ich statt Gruppen über die API verwenden?
Einzelchats, denn darauf ist die Plattform ausgelegt. Eine Nachricht, die an eine Gruppe von Kunden gegangen wäre, geht an jeden Kunden einzeln: innerhalb des 24-Stunden-Kundenservicefensters als Freitext, außerhalb davon als freigegebenes Template.
Braucht ein Unternehmen tatsächlich per API verwaltete Gruppen, setzt die Groups API eine Nummer voraus, die ausschließlich bei der Cloud API registriert ist und einen Official Business Account hat. Dafür müsste die Nummer Coexistence verlassen. Das ist eine strukturelle Entscheidung für die Leitung und keine Einstellung, und sie nimmt die App aus dieser Leitung heraus.
Häufige Fehler
- Zu lesen, dass es eine Groups API gibt, und anzunehmen, sie gelte auch für eine Coexistence-Nummer. Meta schließt Nummern der Business App aus.
- Zu erwarten, dass der Gruppenverlauf nach dem Onboarding in der API erscheint. Gruppenchats werden nicht synchronisiert.
- Einen gruppenbasierten Ablauf um ein Limit von 8 Teilnehmern herum zu planen, ohne zu prüfen, ob es passt.
EasyCoexistence verbindet Nummern über das Coexistence-Onboarding von Meta, daher gilt für Gruppen genau das, was Meta festlegt: Gruppen bleiben in der App, Einzelchats laufen über die API.
Häufig gestellte Fragen
Kann ich über die API eine Nachricht an eine WhatsApp-Gruppe senden?
Nur von einer reinen API-Nummer mit Official Business Account über die Groups API. Von einer Coexistence-Nummer aus nicht.
Funktionieren meine bestehenden Gruppen weiter?
Ja, in der WhatsApp Business App. Sie werden nicht mit der API synchronisiert.
Wie viele Personen können einer API-Gruppe beitreten?
Meta begrenzt Gruppen, die über die Groups API erstellt werden, auf 8 Teilnehmer.
Ist das eine Einschränkung meines Anbieters?
Nein. Meta legt den Ausschluss für Nummern der WhatsApp Business App bei jedem Anbieter fest.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am