Skip to Content
Wazend

Gruppen

Verwalte WhatsApp-Gruppen mit Wazend: erstellen, auflisten, beitreten, Teilnehmer oder Administratoren hinzufügen/entfernen, Sicherheit, Bild und mehr.

Verwalte WhatsApp-Gruppen mit der API.

  • {session} — Name deiner Sitzung (steht im Dashboard, zum Beispiel S0001).
  • {groupId} — ID der Gruppe im Format 123123123123@g.us.

Information

Wenn du @lid in der Teilnehmerliste siehst, sieh dir die Seite Kontakte an.

Eine neue Gruppe erstellen

POST /api/{session}/groups
Body
{
  "name": "Mi grupo",
  "participants": [
    { "id": "5215551234567@c.us" },
    { "id": "5219999999999@c.us" }
  ]
}

Alle Gruppen abrufen

GET /api/{session}/groups

Die Antwort hängt von der Engine ab, die du verwendest.

Abfrageparameter:

GET /api/{session}/groups?limit=20&offset=0&sortBy=subject&sortOrder=desc
  • limit=10 — begrenzt die Anzahl der zurückgegebenen Gruppen.

  • offset=0 — überspringt N Gruppen ab dem Anfang.

  • sortBy — sortiert nach Feld:

    • sortBy=id — nach Gruppen-ID.
    • sortBy=subject — nach Gruppenbetreff.
  • sortOrder=desc|asc — Reihenfolge:

    • desc — absteigend (neueste zuerst, A-Z).
    • asc — aufsteigend (älteste zuerst, Z-A).
  • exclude=participants — schließt die Teilnehmerdaten aus der Antwort aus.

Tipp

Wenn timeout angezeigt wird oder die Anfrage zu lange dauert, verwende limit, um die Objekte in kleineren Teilen abzurufen.

Warnung

Wenn du mit der Engine NOWEB den Fehler rate-overlimit siehst, versuche den NOWEB Store zu aktivieren.

Die Anzahl der Gruppen abrufen

GET /api/{session}/groups/count
Antwort
{ "count": 10 }

Einer Gruppe beitreten

Wenn du den Einladungslink hast, tritt über den Code oder die vollständige URL bei:

POST /api/{session}/groups/join
Body
{
  "code": "https://chat.whatsapp.com/INVITECODE"
}
Antwort
{ "id": "5215551234567@g.us" }

Einladungsinfo der Gruppe abrufen

GET /api/{session}/groups/join-info?code=invitecode

Oder verwende den vollständigen Link (denke daran, die URL zu kodieren):

GET /api/{session}/groups/join-info?code=https%3A%2F%2Fchat.whatsapp.com%2Finvitecode

Gruppen aktualisieren

POST /api/{session}/groups/refresh

Warnung

Rufe es nicht häufig auf, es kann einen Fehler rate-overlimit verursachen. Normalerweise hat die Gruppen-API bereits die aktualisierten Informationen.

Die Gruppe abrufen

GET /api/{session}/groups/{groupId}

Die Gruppe löschen

DELETE /api/{session}/groups/{groupId}

Die Gruppe verlassen

POST /api/{session}/groups/{groupId}/leave

Gruppenbild

Denke daran, das Symbol @ der ID als %40 zu kodieren (z. B. 5215551234567%40g.us).

Bild abrufen

GET /api/{session}/groups/{ID}/picture?refresh=false
Antwort
{ "url": "https://ejemplo.com/foto.jpg" }

url kann null sein, wenn die Gruppe kein Bild hat. Verwende refresh=true, um die Aktualisierung zu erzwingen (standardmäßig 24 Stunden gecacht; aktualisiere nicht häufig, um rate-overlimit zu vermeiden).

Bild ändern

PUT /api/{session}/groups/{ID}/picture
Body
{
  "file": {
    "url": "https://ejemplo.com/foto.jpg"
  }
}

Oder mit Daten in base64:

Body
{
  "file": {
    "data": "BASE64_DE_LA_IMAGEN"
  }
}

Bild löschen

DELETE /api/{session}/groups/{ID}/picture

Den Gruppenbetreff ändern

PUT /api/{session}/groups/{groupId}/subject
Body
{ "subject": "Nuevo asunto" }

Gibt true zurück, wenn die Aktualisierung erfolgreich war. Kann false zurückgeben, wenn du nicht über die erforderlichen Berechtigungen verfügst.

Die Gruppenbeschreibung ändern

PUT /api/{session}/groups/{groupId}/description
Body
{ "description": "Neue Beschreibung" }

Gibt true zurück, wenn die Aktualisierung erfolgreich war. Kann false zurückgeben, wenn du nicht über die erforderlichen Berechtigungen verfügst.

Sicherheit · Info nur von Administratoren bearbeiten

Ermöglicht es, dass nur Administratoren die Gruppeninformationen (Titel, Beschreibung, Bild) bearbeiten.

GET /api/{session}/groups/{groupId}/settings/security/info-admin-only
PUT /api/{session}/groups/{groupId}/settings/security/info-admin-only
Body
{ "adminsOnly": true }

Gibt true zurück, wenn die Aktualisierung erfolgreich war. Kann false zurückgeben, wenn du nicht über die erforderlichen Berechtigungen verfügst.

Sicherheit · Nachrichten nur von Administratoren

Ermöglicht es, dass nur Administratoren Nachrichten senden.

GET /api/{session}/groups/{groupId}/settings/security/messages-admin-only
PUT /api/{session}/groups/{groupId}/settings/security/messages-admin-only
Body
{ "adminsOnly": true }

Gibt true zurück, wenn die Aktualisierung erfolgreich war. Kann false zurückgeben, wenn du nicht über die erforderlichen Berechtigungen verfügst.

Sicherheit · wer Mitglieder hinzufügen kann

Steuert, ob alle Mitglieder oder nur Administratoren neue Mitglieder hinzufügen können.

GET /api/{session}/groups/{groupId}/settings/security/member-add-mode
PUT /api/{session}/groups/{groupId}/settings/security/member-add-mode
Body
{
  "membersCanAddNewMember": true
}

Gibt true zurück, wenn die Aktualisierung erfolgreich war. Kann false zurückgeben, wenn du nicht über die erforderlichen Berechtigungen verfügst.

Teilnehmer

Teilnehmer abrufen

GET /api/{session}/groups/{groupId}/participants
Antwort
[
  { "id": "5215551234567@c.us", "role": "participant" },
  { "id": "5219999999999@c.us", "role": "admin" }
]

Auch mit einer nahezu identischen Antwort zwischen Engines verfügbar:

GET /api/{session}/groups/{groupId}/participants/v2

Mögliche Rollen: left, participant, admin, superadmin.

Teilnehmer hinzufügen

POST /api/{session}/groups/{groupId}/participants/add
Body
{
  "participants": [
    { "id": "5215551234567@c.us" }
  ]
}

Teilnehmer entfernen

POST /api/{session}/groups/{groupId}/participants/remove
Body
{
  "participants": [
    { "id": "5215551234567@c.us" }
  ]
}

Administratoren

Zum Administrator befördern

POST /api/{session}/groups/{groupId}/admin/promote
Body
{
  "participants": [
    { "id": "5215551234567@c.us" }
  ]
}

Zum regulären Nutzer herabstufen

POST /api/{session}/groups/{groupId}/admin/demote
Body
{
  "participants": [
    { "id": "5215551234567@c.us" }
  ]
}

Einladungscode

Code abrufen

Mit dem Code kannst du den Link https://chat.whatsapp.com/{inviteCode} bilden, um ihn mit deinen Kontakten zu teilen.

GET /api/{session}/groups/{groupId}/invite-code

Code widerrufen

Macht den aktuellen Einladungscode ungültig und generiert einen neuen.

POST /api/{session}/groups/{groupId}/invite-code/revoke

Ereignisse

Empfange Gruppenereignisse über Ereignisse: group.v2.join, group.v2.leave, group.v2.participants und group.v2.update. Siehe Detailbeschreibung der Payload auf der Ereignis-Seite.