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 BeispielS0001).{groupId}— ID der Gruppe im Format123123123123@g.us.
Information
Wenn du @lid in der Teilnehmerliste siehst, sieh dir die Seite Kontakte an.
Eine neue Gruppe erstellen
POST /api/{session}/groups{
"name": "Mi grupo",
"participants": [
{ "id": "5215551234567@c.us" },
{ "id": "5219999999999@c.us" }
]
}Alle Gruppen abrufen
GET /api/{session}/groupsDie 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{ "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{
"code": "https://chat.whatsapp.com/INVITECODE"
}{ "id": "5215551234567@g.us" }Einladungsinfo der Gruppe abrufen
GET /api/{session}/groups/join-info?code=invitecodeOder verwende den vollständigen Link (denke daran, die URL zu kodieren):
GET /api/{session}/groups/join-info?code=https%3A%2F%2Fchat.whatsapp.com%2FinvitecodeGruppen aktualisieren
POST /api/{session}/groups/refreshWarnung
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}/leaveGruppenbild
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{ "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{
"file": {
"url": "https://ejemplo.com/foto.jpg"
}
}Oder mit Daten in base64:
{
"file": {
"data": "BASE64_DE_LA_IMAGEN"
}
}Bild löschen
DELETE /api/{session}/groups/{ID}/pictureDen Gruppenbetreff ändern
PUT /api/{session}/groups/{groupId}/subject{ "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{ "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-onlyPUT /api/{session}/groups/{groupId}/settings/security/info-admin-only{ "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-onlyPUT /api/{session}/groups/{groupId}/settings/security/messages-admin-only{ "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-modePUT /api/{session}/groups/{groupId}/settings/security/member-add-mode{
"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[
{ "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/v2Mögliche Rollen: left, participant, admin, superadmin.
Teilnehmer hinzufügen
POST /api/{session}/groups/{groupId}/participants/add{
"participants": [
{ "id": "5215551234567@c.us" }
]
}Teilnehmer entfernen
POST /api/{session}/groups/{groupId}/participants/remove{
"participants": [
{ "id": "5215551234567@c.us" }
]
}Administratoren
Zum Administrator befördern
POST /api/{session}/groups/{groupId}/admin/promote{
"participants": [
{ "id": "5215551234567@c.us" }
]
}Zum regulären Nutzer herabstufen
POST /api/{session}/groups/{groupId}/admin/demote{
"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-codeCode widerrufen
Macht den aktuellen Einladungscode ungültig und generiert einen neuen.
POST /api/{session}/groups/{groupId}/invite-code/revokeEreignisse
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.