Grupy

Zarzadzaj grupami WhatsApp za pomoca Wappfy API. Mozesz tworzyc grupy, zarzadzac uczestnikami, obslugiwac linki zaproszeniowe i wiele wiecej. Wszystkie endpointy grup sa przypisane do konkretnej instancji:

/api/instances/{instanceId}/groups/...

Tworzenie grupy

Utworz nowa grupe WhatsApp z poczatkowymi uczestnikami.

curl -X POST https://api.wappfy.io/api/instances/inst_abc123/groups \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Project Alpha",
    "participants": [
      "5511999998888@s.whatsapp.net",
      "5511888887777@s.whatsapp.net"
    ]
  }'

const response = await fetch(
  "https://api.wappfy.io/api/instances/inst_abc123/groups",
  {
    method: "POST",
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      name: "Project Alpha",
      participants: [
        "5511999998888@s.whatsapp.net",
        "5511888887777@s.whatsapp.net",
      ],
    }),
  }
);

const group = await response.json();
console.log(group.data.group_id);

Odpowiedz:

{
  "data": {
    "group_id": "120363012345678901@g.us",
    "name": "Project Alpha",
    "participants": [
      {
        "id": "5511999998888@s.whatsapp.net",
        "is_admin": false
      },
      {
        "id": "5511888887777@s.whatsapp.net",
        "is_admin": false
      }
    ]
  }
}

Lista grup

Pobierz wszystkie grupy, ktorych czlonkiem jest instancja.

curl https://api.wappfy.io/api/instances/inst_abc123/groups \
  -H "X-Api-Key: YOUR_API_KEY"

const response = await fetch(
  "https://api.wappfy.io/api/instances/inst_abc123/groups",
  {
    headers: { "X-Api-Key": "YOUR_API_KEY" },
  }
);

const { data } = await response.json();
console.log(`Found ${data.length} groups`);

Odpowiedz:

{
  "data": [
    {
      "group_id": "120363012345678901@g.us",
      "name": "Project Alpha",
      "participant_count": 5
    },
    {
      "group_id": "120363098765432109@g.us",
      "name": "Support Team",
      "participant_count": 12
    }
  ]
}

Informacje o grupie

Pobierz szczegolowe informacje o konkretnej grupie.

curl https://api.wappfy.io/api/instances/inst_abc123/groups/120363012345678901@g.us \
  -H "X-Api-Key: YOUR_API_KEY"

Odpowiedz:

{
  "data": {
    "group_id": "120363012345678901@g.us",
    "name": "Project Alpha",
    "description": "Team workspace for Project Alpha",
    "owner": "5511999998888@s.whatsapp.net",
    "created_at": "2026-01-15T10:00:00Z",
    "participants": [
      {
        "id": "5511999998888@s.whatsapp.net",
        "is_admin": true,
        "is_super_admin": true
      },
      {
        "id": "5511888887777@s.whatsapp.net",
        "is_admin": false,
        "is_super_admin": false
      }
    ]
  }
}

Aktualizacja grupy

Zaktualizuj nazwe lub opis grupy. Musisz byc administratorem grupy, aby wykonac ta operacje.

curl -X PATCH https://api.wappfy.io/api/instances/inst_abc123/groups/120363012345678901@g.us \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Project Alpha v2",
    "description": "Updated workspace for Project Alpha"
  }'

Tylko administratorzy grupy moga aktualizowac nazwe i opis grupy. Jesli instancja nie jest administratorem, zostanie zwrocony blad 403.

Opuszczenie grupy

Usun instancje z grupy.

curl -X POST https://api.wappfy.io/api/instances/inst_abc123/groups/120363012345678901@g.us/leave \
  -H "X-Api-Key: YOUR_API_KEY"

Po opuszczeniu grupy bedziesz potrzebowal linku zaproszeniowego lub innego administratora, aby Cie ponownie dodal.

Uczestnicy

Lista uczestnikow

Pobierz wszystkich uczestnikow grupy.

curl https://api.wappfy.io/api/instances/inst_abc123/groups/120363012345678901@g.us/participants \
  -H "X-Api-Key: YOUR_API_KEY"

Odpowiedz:

{
  "data": [
    {
      "id": "5511999998888@s.whatsapp.net",
      "is_admin": true,
      "is_super_admin": true
    },
    {
      "id": "5511888887777@s.whatsapp.net",
      "is_admin": false,
      "is_super_admin": false
    },
    {
      "id": "5511777776666@s.whatsapp.net",
      "is_admin": true,
      "is_super_admin": false
    }
  ]
}

Dodawanie uczestnikow

Dodaj jednego lub wiecej uczestnikow do grupy. Musisz byc administratorem grupy.

curl -X POST https://api.wappfy.io/api/instances/inst_abc123/groups/120363012345678901@g.us/participants \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "participants": [
      "5511666665555@s.whatsapp.net",
      "5511555554444@s.whatsapp.net"
    ]
  }'

await fetch(
  "https://api.wappfy.io/api/instances/inst_abc123/groups/120363012345678901@g.us/participants",
  {
    method: "POST",
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      participants: [
        "5511666665555@s.whatsapp.net",
        "5511555554444@s.whatsapp.net",
      ],
    }),
  }
);

Usuwanie uczestnikow

Usun jednego lub wiecej uczestnikow z grupy. Musisz byc administratorem grupy.

curl -X DELETE https://api.wappfy.io/api/instances/inst_abc123/groups/120363012345678901@g.us/participants \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "participants": [
      "5511666665555@s.whatsapp.net"
    ]
  }'

Kody zaproszeniowe

Pobieranie kodu zaproszeniowego

Wygeneruj lub pobierz link zaproszeniowy grupy. Musisz byc administratorem grupy.

curl https://api.wappfy.io/api/instances/inst_abc123/groups/120363012345678901@g.us/invite-code \
  -H "X-Api-Key: YOUR_API_KEY"

Odpowiedz:

{
  "data": {
    "invite_code": "https://chat.whatsapp.com/AbCdEfGhIjKlMn"
  }
}

Dolaczanie za pomoca kodu zaproszeniowego

Dolacz do grupy za pomoca kodu zaproszeniowego.

curl -X POST https://api.wappfy.io/api/instances/inst_abc123/groups/join \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "invite_code": "AbCdEfGhIjKlMn"
  }'

Przekaz tylko czesc z kodem, a nie pelny URL. Dla https://chat.whatsapp.com/AbCdEfGhIjKlMn przekaz AbCdEfGhIjKlMn.

Wysylanie wiadomosci do grup

Aby wyslac wiadomosc do grupy, uzyj standardowego endpointu wysylania wiadomosci z identyfikatorem czatu grupy:

curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "120363012345678901@g.us",
    "type": "text",
    "text": "Hello team!"
  }'

Identyfikatory czatow grupowych zawsze koncza sie na @g.us.

Informacje o endpointach

Metoda	Endpoint	Opis
`POST`	`/api/instances/{id}/groups`	Utworz nowa grupe
`GET`	`/api/instances/{id}/groups`	Lista wszystkich grup
`GET`	`/api/instances/{id}/groups/{groupId}`	Informacje o grupie
`PATCH`	`/api/instances/{id}/groups/{groupId}`	Aktualizuj nazwe/opis grupy
`POST`	`/api/instances/{id}/groups/{groupId}/leave`	Opusc grupe
`GET`	`/api/instances/{id}/groups/{groupId}/participants`	Lista uczestnikow
`POST`	`/api/instances/{id}/groups/{groupId}/participants`	Dodaj uczestnikow
`DELETE`	`/api/instances/{id}/groups/{groupId}/participants`	Usun uczestnikow
`GET`	`/api/instances/{id}/groups/{groupId}/invite-code`	Pobierz kod zaproszeniowy
`POST`	`/api/instances/{id}/groups/join`	Dolacz za pomoca kodu zaproszeniowego

Obsluga bledow

Kod statusu	Opis
`403`	Nie jestes administratorem tej grupy.
`404`	Grupa nie znaleziona lub instancja nie jest czlonkiem.
`409`	Uczestnik jest juz w grupie (przy dodawaniu) lub nie jest w grupie (przy usuwaniu).
`422`	Nieprawidlowy format uczestnika. Uzyj `{phone}@s.whatsapp.net`.

Pierwsze Kroki

Przewodniki

Grupy

Grupy

Tworzenie grupy

Lista grup

Informacje o grupie

Aktualizacja grupy

Opuszczenie grupy

Uczestnicy

Lista uczestnikow

Dodawanie uczestnikow

Usuwanie uczestnikow

Kody zaproszeniowe

Pobieranie kodu zaproszeniowego

Dolaczanie za pomoca kodu zaproszeniowego

Wysylanie wiadomosci do grup

Informacje o endpointach

Obsluga bledow

​Grupy

​Tworzenie grupy

​Lista grup

​Informacje o grupie

​Aktualizacja grupy

​Opuszczenie grupy

​Uczestnicy

​Lista uczestnikow

​Dodawanie uczestnikow

​Usuwanie uczestnikow

​Kody zaproszeniowe

​Pobieranie kodu zaproszeniowego

​Dolaczanie za pomoca kodu zaproszeniowego

​Wysylanie wiadomosci do grup

​Informacje o endpointach

​Obsluga bledow

Grupy

Tworzenie grupy

Lista grup

Informacje o grupie

Aktualizacja grupy

Opuszczenie grupy

Uczestnicy

Lista uczestnikow

Dodawanie uczestnikow

Usuwanie uczestnikow

Kody zaproszeniowe

Pobieranie kodu zaproszeniowego

Dolaczanie za pomoca kodu zaproszeniowego

Wysylanie wiadomosci do grup

Informacje o endpointach

Obsluga bledow