WhatsApp-Gruppen

Eine WhatsApp-Gruppe ermöglicht ein Gespräch zwischen Ihrem Unternehmen und einer kleinen Anzahl von Personen. Alle in diesem Chat können das Gespräch sehen und darauf antworten. Nutzen Sie eine Gruppe, wenn mehr als zwei Parteien beteiligt sind: bei einem Supportfall, in dem Kunde, Techniker und Installateur denselben Gesprächsverlauf benötigen, bei einer VIP- oder Concierge-Betreuung für einen bestimmten Kunden, bei einem gemeinsamen Kurs oder einer Challenge oder bei einer Lieferung, bei der Käufer und Kurier mit Ihnen und miteinander sprechen.

Gruppen unterscheiden sich in zwei Punkten von allen anderen Versandarten über WhatsApp. Diese entscheiden darüber, ob Gruppen für Ihren Zweck geeignet sind:

• Die Gruppe ist ein gemeinsamer Raum, kein Fan-out. Eine Nachricht erreicht alle in der Gruppe, und ihre Antworten sind für die Gruppe sichtbar. Eine Kampagne an viele Personen, die einander nicht sehen dürfen, ist ein Einzelversand an jede von ihnen, keine Gruppe.
• Personen treten selbst über einen Link bei. WhatsApp bietet keine Operation, die einer Gruppe einen Teilnehmer hinzufügt. Der Beitritt ist daher nur über einen Einladungslink möglich, den Sie ihnen senden, und sie entscheiden selbst darüber. Damit setzt eine Gruppe eine ausdrückliche Zustimmung voraus. Sie können eine Gruppe also auch nicht aus einer vorhandenen Liste von Telefonnummern zusammenstellen.

Gruppen sind bewusst klein: WhatsApp begrenzt jede auf 8 Teilnehmende, sodass eine Gruppe ein Arbeitsraum ist und kein Broadcast-Kanal.

Bevor Sie eine Gruppe erstellen

Zwei Voraussetzungen bestimmen, ob Sie eine Gruppe erstellen können: Ihr eigener Zugriff auf den Workspace und die Nummer, mit der Sie die Gruppe erstellen.

Die Seite Groups finden Sie unter WhatsApp > Groups. Zum Öffnen benötigen Sie die Berechtigung whatsapp_management mit Lesezugriff. Die Berechtigung whatsapp mit Lesezugriff blendet den Bereich WhatsApp in der Navigation ein. Zum Erstellen einer Gruppe benötigen Sie whatsapp_management mit Schreibzugriff. Ein Mitglied mit reinem Lesezugriff sieht daher die Gruppen des Workspace, aber keine Schaltfläche Create group. Benutzer, Teams und Rollen beschreibt, wie Sie beide Berechtigungen erteilen.

WhatsApp erlaubt Gruppen nur für eine Geschäftsnummer mit dem Status eines offiziellen Unternehmenskontos. Das Feld Business number listet eine Nummer daher nur auf, wenn beide Voraussetzungen erfüllt sind:

• Die Nummer ist mit Ihrem Workspace verbunden. Sie hat also die Einrichtung der Telefonnummer abgeschlossen und wird auf der Seite Numbers als verbunden angezeigt.
• WhatsApp hat der Nummer den Status eines offiziellen Unternehmenskontos erteilt. Ein Verifizierungszeichen neben der Nummer in der Liste zeigt diesen Status an.

Keine andere Nummer in Ihrem Workspace kann eine Gruppe verwalten. Den Status eines offiziellen Unternehmenskontos vergibt Meta, nicht wir. Ausschlaggebend sind die Unternehmensverifizierung Ihres Kontos, die Qualitätsbewertung und die Markenpräsenz.

Gruppe erstellen

1. Öffnen Sie die Seite Groups und wählen Sie Create group.
2. Wählen Sie die Business number, die die Gruppe verwaltet. Die Gruppe behält diese Nummer ihr ganzes Leben lang, sie kann nachträglich nicht geändert werden.
3. Geben Sie einen Group name mit bis zu 128 Zeichen ein. Den Namen sehen Eingeladene, bevor sie beitreten; benennen Sie die Gruppe daher nach ihrem Zweck statt nach einer internen Referenz.
4. Fügen Sie eine Beschreibung mit bis zu 2.048 Zeichen hinzu, wenn der Zweck mehr erfordert, als der Name vermittelt.
5. Wählen Sie Join approval. Automatic approval, die Standardeinstellung, nimmt jeden auf, der den Einladungslink öffnet; Approval required verwandelt jeden Beitritt in eine Beitrittsanfrage, über die Sie entscheiden. Wie die Business-Nummer ist diese Einstellung nach dem Erstellen der Gruppe fest; eine Gruppe, die geprüft werden soll, muss von Anfang an so erstellt werden.
6. Wählen Sie Create group.

Die Gruppe erscheint mit dem Status Pending. Die Erstellung ist asynchron: Wir zeichnen die Anfrage auf, und WhatsApp bestätigt die Gruppe kurz darauf, wodurch sie auf Active wechselt und ihr Einladungslink befüllt wird. Wenn WhatsApp die Anfrage ablehnt, wechselt die Gruppe auf Failed und das Detail zeigt den Grund. Eine fehlgeschlagene Gruppe ist endgültig; erstellen Sie eine neue, statt diese erneut zu versuchen.

Personen in die Gruppe einladen

Öffnen Sie die Gruppe auf der Seite Groups und kopieren Sie den Invite link aus dem Tab Details. Senden Sie diesen Link über einen beliebigen Kanal, der die gewünschten Personen bereits erreicht. Was der Link bewirkt, hängt vom Genehmigungsmodus ab, der beim Erstellen der Gruppe gewählt wurde; diese Wahl ist für die Lebensdauer der Gruppe fest. Bei einer Gruppe mit automatischer Genehmigung tritt jeder, der den Link hat, sofort bei; bei einer Gruppe mit Genehmigungspflicht löst das Öffnen eine Beitrittsanfrage aus, über die Sie entscheiden. Behandeln Sie den Link in jedem Fall wie ein Zugangsdatum: Senden Sie ihn an namentlich bekannte Personen, statt ihn zu veröffentlichen, und erstellen Sie pro Fall oder Kunde eine eigene Gruppe, statt einen Link breit wiederzuverwenden.

Bevor WhatsApp die Gruppe bestätigt, zeigt das Feld Not available an; das ist der Pending-Status, kein Fehler.

Das Entfernen einer Person ist dauerhaft. WhatsApp blockiert den erneuten Beitritt dieser Person, und ein neuer Einladungslink hebt die Sperre nicht auf. Da es keine Möglichkeit gibt, sie wieder hinzuzufügen, erfordert eine erneute Kontaktaufnahme eine neue Gruppe.

Gruppe verfolgen

Öffnen Sie eine Gruppe aus der Liste, um zu sehen, wer darin ist und wie die Gruppe auf WhatsApp aussieht:

• Details: Gruppen-ID, Business-Nummer, Teilnehmerzahl, Beitrittsgenehmigungsmodus, Einladungslink sowie Erstellungs- und Aktualisierungszeitpunkte.
• Participants: alle beigetretenen Personen, aufgelistet nach WhatsApp-Benutzername, falls vorhanden, und immer nach ihrer geschäftsbezogenen Benutzer-ID. Eine Telefonnummer erscheint nur bei Teilnehmern, die sie mit Ihrem Unternehmen geteilt haben. Ihre eigene Business-Nummer verwaltet die Gruppe und wird nicht aufgelistet.
• Pins: die in der Gruppe angepinnten Nachrichten mit dem Zeitpunkt, an dem jeder Pin abläuft.

Die Listenseite zeigt gruppenübergreifend dieselben Informationen: Name, Status, Business-Nummer, Teilnehmerzahl und Erstellungsdatum, mit einer Suche über Name und Beschreibung sowie einem Filter nach Status.

Gruppen über die API verwalten

Dieselben zwölf Operationen stehen hinter den oben beschriebenen Dashboard-Seiten. Alles, was Sie hier tun können, geht auch über /v1/whatsapp/groups, die bird whatsapp groups-Befehle oder eine typisierte SDK-Methode. Alle erfordern whatsapp_management-Zugriff: Read-Level für Leseoperationen, Write-Level für alles andere.

Das Erstellen einer Gruppe ist asynchron. Die 202 liefert die Gruppe im Status pending und ohne Einladungslink, weil WhatsApp den Link ausstellt, sobald die Gruppe bestätigt ist. Lesen Sie die Gruppe zurück, bis ihr status den Wert pending verlässt: active bedeutet, dass die Gruppe existiert und ihr Einladungslink funktioniert, und failed ist endgültig, wobei last_operation.last_error.description die Begründung von WhatsApp selbst trägt. Halten Sie bei beiden an, und wiederholen Sie eine failed Erstellung nie, ohne das Gesendete zu ändern.

const group = await bird.whatsapp.groups.create({
  whatsapp_number_id: "wan_01krdgeqcxet5s7t44vh8rt9mg",
  subject: "Norwood Fleet — Tuesday route",
});
console.log(group.status); // pending

group = client.whatsapp.groups.create(
    whatsapp_number_id="wan_01krdgeqcxet5s7t44vh8rt9mg",
    subject="Norwood Fleet — Tuesday route",
)
print(group.status)  # pending

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	bird "github.com/messagebird/bird-sdk-go"
	"github.com/messagebird/bird-sdk-go/option"
)

func main() {
	client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
	if err != nil {
		log.Fatal(err)
	}
	group, err := client.Whatsapp.Groups.Create(context.Background(), bird.WhatsappGroupsCreateParams{
		WhatsappNumberID: "wan_01krdgeqcxet5s7t44vh8rt9mg",
		Subject:          "Norwood Fleet — Tuesday route",
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(*group.Status) // pending
}

$group = $bird->whatsapp->groups->create(
    (new WhatsAppGroupCreate())
        ->setWhatsappNumberId('wan_01krdgeqcxet5s7t44vh8rt9mg')
        ->setSubject('Norwood Fleet — Tuesday route'),
);

curl -X POST https://us1.platform.bird.com/v1/whatsapp/groups \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"whatsapp_number_id":"wan_01krdgeqcxet5s7t44vh8rt9mg","subject":"Norwood Fleet — Tuesday route"}'

Der curl-Aufruf benennt den US-Host; wenn Ihr Schlüssel mit bk_eu1_ beginnt, rufen Sie stattdessen https://eu1.platform.bird.com auf. Die SDKs lesen die Region aus Ihrem Schlüssel und setzen daher keinen Host.

Wählen Sie zuerst die Business-Nummer. GET /v1/whatsapp/numbers meldet den Official Business Account Status pro Nummer als is_official_business_account, und eine Nummer ohne diesen Status gibt 412 WhatsAppGroupsNotEligible zurück.

Ändern, Löschen und Entfernen eines Teilnehmers sind auf dieselbe Weise asynchron: Die Antwort bestätigt die Annahme der Anfrage, und ein 409 WhatsAppGroupUpdateInProgress lehnt eine zweite Änderung ab, solange eine ausstehend ist. Wo das Ergebnis landet, unterscheidet sich. Eine Änderung oder ein Löschen wird über den last_operation der Gruppe selbst abgeschlossen; eine Entfernung über den Eintrag dieses Teilnehmers in participants. Das gleichzeitige Entfernen mehrerer Personen gibt jeder ihren eigenen Status, und nur die ausstehende Entfernung dieser Person blockiert einen weiteren Versuch bei ihr. Einladungslink-Rotation, Anpinnen und Lösen von Pins antworten 200 mit dem angewendeten Ergebnis, weil WhatsApp diese in seiner Antwort bestätigt.

Beitrittsanfragen werden in Batches von bis zu 50 entschieden, und ein Batch ist teilweise anwendbar: Die Antwort trennt decided von failed, wobei jeder Fehler den von WhatsApp gelieferten Grund enthält. Lesen Sie die Antwort statt des Statuscodes.

Die vollständigen Request- und Response-Strukturen finden Sie in der API-Referenz: create, list, get, update, delete, Einladungslink rotieren, Teilnehmer entfernen, auflisten, genehmigen und ablehnen von Beitrittsanfragen sowie Nachricht anpinnen und Pin lösen.

Was WhatsApp begrenzt

WhatsApp bestimmt die Limits, unter denen eine Gruppe läuft, und ändert sie nach eigenem Zeitplan. Stand September 2026 setzt die Gruppendokumentation ein Limit von 8 Teilnehmern pro Gruppe, 10.000 Gruppen pro Business-Nummer und 3 angepinnten Nachrichten pro Gruppe mit einer Dauer von jeweils 1 bis 30 Tagen. Ein Business-Konto verwaltet eine Gruppe; ein anderes Unternehmen kann Ihrer nicht beitreten.

Für Gruppen gelten außerdem die Einschränkungen, die WhatsApp Gruppenchats auferlegt. Anrufe, interaktive Nachrichten, Authentifizierungsvorlagen, Commerce-Nachrichten und verschwindende Nachrichten sind an eine Gruppe nicht zustellbar, und der Nachrichtenverlauf einer Gruppe lässt sich nicht zurücklesen.

Nachrichten an eine Gruppe senden

Eine Gruppe wird über dieselben Endpunkte angeschrieben wie jeder andere Empfänger, mit der Gruppen-ID in to anstelle einer Telefonnummer. Senden an eine WhatsApp-Gruppe führt durch den Versand, was ein Gruppenchat akzeptiert und was nicht, und wie die Zustellung einer einzelnen Nachricht über die Teilnehmer hinweg gemeldet wird. Empfang von WhatsApp-Gruppennachrichten behandelt die Gegenrichtung: welcher Teilnehmer eine eingehende Nachricht geschrieben hat, welches Fenster seine Nachricht öffnet und was der whatsapp.received-Webhook liefert.

Nächste Schritte