Cum să automatizați și să gestionați grupurile WhatsApp prin API

Introducere

Pentru cine este acest ghid:

• Dezvoltatori și ingineri software care integrează funcții WhatsApp în sisteme CRM, SaaS sau de afaceri personalizate;
• Integratori no-code și specialiști în automatizare care folosesc Make, Zapier sau n8n;

Cazuri de utilizare:

• Crearea automată a grupurilor dedicate de asistență sau de integrare a clienților;
• Sincronizarea listelor de participanți ai grupului cu etapele de vânzări din CRM;
• Difuzarea anunțurilor și alertelor tranzacționale în chat-urile de grup;
• Conectarea chatbot-urilor interactivi la conversațiile de grup;

Cerințe preliminare:

• Un număr de WhatsApp activ standard (aplicație personală sau de afaceri obișnuită, nu WABA oficial);
• Cunoștințe de bază despre solicitările HTTP sau acces la o platformă de automatizare no-code;

Ce poți face cu Grupurile WhatsApp prin API

• Trimite mesaje către grupuri: Trimite actualizări, anunțuri sau remindere direct în orice grup.
• Creează grupuri WhatsApp noi: Generează automat grupuri pe baza unor evenimente precum onboarding-ul clienților sau înscrierea la cursuri.
• Adaugă membri într-un grup: Invită contacte în grup programatic, fără aprobare manuală.
• Promovează membri la administratori: Atribuie sau revocă drepturi de admin pentru participanți selectați.
• Preia participanții grupului: Obține lista completă de membri pentru analiză sau sincronizare cu CRM-ul.
• Detectează evenimente în grup: Monitorizează mesaje, intrări și ieșiri folosind webhook-uri.
• Conectează boți la grupuri: Permite boților să citească și să răspundă la mesaje de grup conform logicii definite.

De ce API-ul oficial de grupuri Meta eșuează în producție

Cum să îți conectezi WhatsApp-ul și să începi să folosești API-ul

1. 1) Accesează dashboard-ul și deschide Canalul Implicit — este deja creat pentru tine.
2. 2) La Pasul 1 vei vedea un cod QR cu instrucțiuni.
3. 3) Pe telefon, deschide WhatsApp → Setări → Dispozitive conectate → Conectează un dispozitiv, apoi scanează codul QR.
4. 4) După conectare, dă un nume canalului (ex: "Chatbotul Meu") pentru identificare ușoară.
5. 5) Vei fi redirecționat la ecranul de setări al canalului, poți sări acest pas și reveni ulterior.

Accesează setările WhatsApp pe telefon

Scanează codul QR în WhatsApp

Pentru a conecta telefonul, folosește codul QR

Cheia ta API

Cum să trimiți mesaje către grupuri WhatsApp prin API (cu exemple de cod)

1. 1) Mai întâi, obține ID-ul grupului. Folosește endpoint-ul GET /groups pentru a prelua lista grupurilor WhatsApp cu identificatorii lor unici. Pentru detalii complete, vezi documentația: Get groups.
2. 2) Odată ce ai ID-ul grupului, poți trimite un mesaj. Generează grupuri automat pe baza unor evenimente precum onboarding-ul clienților. Folosește endpoint-ul POST /messages/text, specificând ID-ul grupului în parametrul to și conținutul mesajului în body. Pentru detalii, vezi: Send text message.

1. 1) La crearea unui grup, ID-ul va fi specificat în răspunsul API. Mai jos arătăm cum;
2. 2) Endpoint Get a list of groups;
3. 3) Endpoint Get a list of all chats;

                                            
curl --request POST \
     --url https://gate.whapi.cloud/messages/text \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_API_TOKEN' \
     --header 'content-type: application/json' \
     --data '
{
  "to": "[email protected]",
  "body": "Hello, this message was sent via API!"
}
'

                                            
// composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://gate.whapi.cloud/messages/text', [
  'body' => '{"to":"[email protected]","body":"Hello, this message was sent via API!"}',
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer YOUR_API_TOKEN',
    'content-type' => 'application/json',
  ],
]);

echo $response->getBody();

                                            
# python -m pip install requests

import requests

url = "https://gate.whapi.cloud/messages/text"

payload = {
    "to": "[email protected]",
    "body": "Hello, this message was sent via API!"
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

                                            
// npm install axios --save

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://gate.whapi.cloud/messages/text',
  headers: {
    accept: 'application/json',
    'content-type': 'application/json',
    authorization: 'Bearer YOUR_API_TOKEN'
  },
  data: {to: '[email protected]', body: 'Hello, this message was sent via API!'}
};

axios
  .request(options)
  .then(res => console.log(res.data))
  .catch(err => console.error(err));

                                            
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"to\":\"[email protected]\",\"body\":\"Hello, this message was sent via API!\"}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/messages/text")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("content-type", "application/json")
  .addHeader("authorization", "Bearer YOUR_API_TOKEN")
  .build();

Response response = client.newCall(request).execute();

                                            
//dotnet add package RestSharp

using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/messages/text");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer YOUR_API_TOKEN");
request.AddJsonBody("{\"to\":\"[email protected]\",\"body\":\"Hello, this message was sent via API!\"}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

Trimiterea fișierelor media și a documentelor în grupuri

// Send an image or PDF document to a WhatsApp group
const groupId = "[email protected]";
const res = await fetch('https://gate.whapi.cloud/messages/image', {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'content-type': 'application/json',
    'authorization': `Bearer ${process.env.WHAPI_TOKEN}`
  },
  body: JSON.stringify({
    to: groupId,
    media: "https://whapi.cloud/assets/img/whapi/logo-text.svg",
    caption: "Welcome to your automated support channel!"
  })
});
const result = await res.json();
console.log("Media message sent:", result);

Cum să trimiți mesaje către grupuri folosind instrumente no-code precum Make sau n8n

Exemplu de obținere a ID-ului grupului în Make (Integromat)

• to: ID-ul grupului.
• body: conținutul mesajului

Exemplu de trimitere a unui mesaj către grup prin Make

Exemplu de cerere personalizată pentru trimiterea unui mesaj către grup prin Zapier

Cum să creezi un grup WhatsApp prin API

1. 1) Folosește metoda POST cu endpoint-ul https://gate.whapi.cloud/groups pentru a crea un grup nou. Furnizează numele grupului în parametrul subject și include cel puțin un număr în parametrul participants — acest lucru este necesar pentru crearea cu succes a grupului.
2. 2) După crearea cu succes, API-ul va returna un ID de grup. Vei avea nevoie de acest identificator pentru a trimite mesaje către grup.
3. 3) Pentru a trimite un mesaj către grup, folosește metoda standard de trimitere a mesajelor. Specifică ID-ul grupului în parametrul to și conținutul în body.

                                            
curl --request POST \
     --url https://gate.whapi.cloud/groups \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token' \
     --header 'content-type: application/json' \
     --data '
{
  "participants": [
    "498935516106",
    "4915155985667"
  ],
  "subject": "SEO Common GmbH"
}
'

                                            
// composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://gate.whapi.cloud/groups', [
  'body' => '{"participants":["498935516106","4915155985667"],"subject":"SEO Common GmbH"}',
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer Your_Token',
    'content-type' => 'application/json',
  ],
]);

echo $response->getBody();

                                            
# python -m pip install requests

import requests

url = "https://gate.whapi.cloud/groups"

payload = {
    "participants": ["498935516106", "4915155985667"],
    "subject": "SEO Common GmbH"
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Bearer Your_Token"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

                                            
// npm install axios --save

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://gate.whapi.cloud/groups',
  headers: {
    accept: 'application/json',
    'content-type': 'application/json',
    authorization: 'Bearer Your_Token'
  },
  data: {participants: ['498935516106', '4915155985667'], subject: 'SEO Common GmbH'}
};

axios
  .request(options)
  .then(res => console.log(res.data))
  .catch(err => console.error(err));

                                            
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"participants\":[\"498935516106\",\"4915155985667\"],\"subject\":\"SEO Common GmbH\"}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/groups")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("content-type", "application/json")
  .addHeader("authorization", "Bearer Your_Token")
  .build();

Response response = client.newCall(request).execute();

                                            
//dotnet add package RestSharp

using RestSharp;


var options = new RestClientOptions("https://gate.whapi.cloud/groups");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer Your_Token");
request.AddJsonBody("{\"participants\":[\"498935516106\",\"4915155985667\"],\"subject\":\"SEO Common GmbH\"}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

Cum să creezi un grup WhatsApp folosind o platformă no-code

{
  "participants": [
    "498935516106",
    "4915155985667"
  ],
  "subject": "SEO Common GmbH"
}

Exemplu de cerere personalizată pentru crearea unui grup prin Make

Cum să adaugi participanți într-un grup WhatsApp

1. 1) Asigură-te că ai ID-ul grupului în care vrei să adaugi membri. Acesta este un parametru obligatoriu. Am explicat mai sus cum să obții ID-ul.
2. 2) Trimite o cerere POST către https://gate.whapi.cloud/groups/{GroupID}/participants pentru a adăuga membri noi. Trebuie să incluzi ID-ul grupului în URL și să furnizezi un array de numere de telefon pentru participanții pe care vrei să îi adaugi.

Adăugare directă vs Link-uri de invitație

                                            
curl --request POST \
     --url https://gate.whapi.cloud/groups/120367831625595066%40g.us/participants \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token' \
     --header 'content-type: application/json' \
     --data '
{
  "participants": [
    "373983445541",
    "373983445542",
    "373983445543"
  ]
}
'

                                            
// composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://gate.whapi.cloud/groups/120367831625595066%40g.us/participants', [
  'body' => '{"participants":["373983445541","373983445542","373983445543"]}',
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer Your_Token',
    'content-type' => 'application/json',
  ],
]);

echo $response->getBody();

                                            
# python -m pip install requests

import requests

url = "https://gate.whapi.cloud/groups/120367831625595066%40g.us/participants"

payload = { "participants": ["373983445541", "373983445542", "373983445543"] }
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Bearer Your_Token"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

                                            
// npm install axios --save

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://gate.whapi.cloud/groups/120367831625595066%40g.us/participants',
  headers: {
    accept: 'application/json',
    'content-type': 'application/json',
    authorization: 'Bearer Your_Token'
  },
  data: {participants: ['373983445541', '373983445542', '373983445543']}
};

axios
  .request(options)
  .then(res => console.log(res.data))
  .catch(err => console.error(err));

                                            
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"participants\":[\"373983445541\",\"373983445542\",\"373983445543\"]}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/groups/120367831625595066%40g.us/participants")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("content-type", "application/json")
  .addHeader("authorization", "Bearer Your_Token")
  .build();

Response response = client.newCall(request).execute();

                                            
//dotnet add package RestSharp

using RestSharp;


var options = new RestClientOptions("https://gate.whapi.cloud/groups/120367831625595066%40g.us/participants");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer Your_Token");
request.AddJsonBody("{\"participants\":[\"373983445541\",\"373983445542\",\"373983445543\"]}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

Cum să adaugi participanți într-un grup folosind instrumente no-code

{
  "participants": [
    "373983445541",
    "373983445542",
    "373983445543"
  ]
}

Automatizare no-code în lumea reală: crearea automată a grupurilor de suport (Make și n8n)

1. Creați grupul: trimiteți o cerere POST /groups cu un subiect precum "Asistență clienți: Nume companie" și numărul dvs. principal de bot.
2. Adăugați participanți: apelați POST /groups/{groupId}/participants pentru a adăuga numărul de telefon al clientului și managerul de cont desemnat.
3. Trimiteți un mesaj de bun venit: trimiteți o cerere POST /messages/image sau POST /messages/text pentru a livra un PDF de integrare sau un banner de bun venit.

Cum să preiei participanții unui grup WhatsApp prin API

1. 1) Asigură-te că ești membru al grupului pe care vrei să-l accesezi. Fără acest lucru, nu vei putea prelua lista de participanți.
2. 2) Folosește metoda API Get Groups pentru a prelua toate grupurile asociate contului tău WhatsApp. Dacă știi deja ID-ul grupului dorit, consultă-l direct folosind endpoint-ul Get group.
3. 3) Răspunsul va include un array de obiecte grup, fiecare conținând informații precum ID-ul, numele și un câmp participants cu lista membrilor. Exemplu de răspuns:

{
  "id": "[email protected]",
  "name": "A group of researchers",
  "participants": [
    { "id": "972558557032", "rank": "member" },
    { "id": "14409416972", "rank": "creator" },
    { "id": "905589461962", "rank": "member" }
  ]
}

                                            
curl --request GET \
     --url 'https://gate.whapi.cloud/groups?count=100' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token'

                                            
// composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://gate.whapi.cloud/groups?count=100', [
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer Your_Token',
  ],
]);

echo $response->getBody();

                                            
# python -m pip install requests

import requests

url = "https://gate.whapi.cloud/groups?count=100"

headers = {
    "accept": "application/json",
    "authorization": "Bearer Your_Token"
}

response = requests.get(url, headers=headers)

print(response.text)

                                            
// npm install axios --save

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://gate.whapi.cloud/groups?count=100',
  headers: {accept: 'application/json', authorization: 'Bearer Your_Token'}
};

axios
  .request(options)
  .then(res => console.log(res.data))
  .catch(err => console.error(err));

                                            
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/groups?count=100")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer Your_Token")
  .build();

Response response = client.newCall(request).execute();

                                            
//dotnet add package RestSharp

using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/groups?count=100");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer Your_Token");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

Cum să preiei membrii unui grup WhatsApp prin no-code

Cum să conectezi un bot la un grup WhatsApp

• Creează un bot WhatsApp în Node.js;
• Creează un bot WhatsApp în Python;
• Creează un bot WhatsApp în PHP;
• Creează un bot WhatsApp în Java;

Sfaturi, limitări și bune practici

• Nu adăuga utilizatori în grupuri fără consimțământul lor. Respectă confidențialitatea și evită invitațiile nesolicitate;
• Evită trimiterea de spam sau conținut nedorit, deoarece contul tău poate fi marcat sau blocat permanent;
• Whapi.Cloud nu impune limite stricte de viteză pentru API pe canalele plătite, dar WhatsApp poate raporta conturile care trimit mai mult de ~20 de mesaje pe minut fără istoric de încălzire. Utilizați un ritm uman și întârzieri aleatorii de 1.5–3.5 secunde între acțiuni.

// PATCH https://gate.whapi.cloud/groups/{groupId}/admins
const groupId = "[email protected]";
const res = await fetch(`https://gate.whapi.cloud/groups/${groupId}/admins`, {
  method: 'PATCH',
  headers: {
    'accept': 'application/json',
    'content-type': 'application/json',
    'authorization': `Bearer ${process.env.WHAPI_TOKEN}`
  },
  body: JSON.stringify({
    participants: ["4915155985667"]
  })
});
const status = await res.json();
console.log("Admin promotion status:", status);

Depanarea problemelor

Botul nu răspunde la mesajele primite

Botul trimite mesaje fără oprire

Webhook-uri și probleme comune de automatizare a grupurilor

• Buclă de mesaje a botului: asigurați-vă că codul dvs. verifică indicatorul from_me în datele primite pentru a evita buclele infinite de răspuns.
• Eroare de permisiune refuzată: aceasta se întâmplă când încercați să adăugați un participant în timp ce contul de bot nu este administrator al grupului. Verificați rangul botului prin GET /groups/{GroupID}.
• Lipsa numerelor în listă: sincronizarea metadatelor grupului durează până la 15 secunde. Dacă apelați API-ul imediat după creare, numerele de telefon ale participanților pot dura câteva momente pentru a fi rezolvate.

Nu poți adăuga un utilizator în grup?

• Trebuie să fii administratorul grupului. Doar adminii pot adăuga membri noi.
• Utilizatorul poate avea restricții de invitație în setările de confidențialitate. Dacă este cazul, nu poate fi adăugat automat prin API.
• Grupul poate fi la limita maximă de 1024 participanți. În acest caz, elimină membri inactivi sau creează un grup nou.
• Politicile anti-spam ale WhatsApp pot bloca adăugarea anumitor numere în grupuri — mai ales dacă contactul nu este salvat în agenda dvs. sau nu a interacționat cu dvs. Pentru a reduce acest risc, vă recomandăm cu tărie să adăugați mai întâi contactul în listă în mod programatic, folosind API-ul nostru de adăugare a contactelor.

Mesaj nedelivrat?

• Verifică ID-ul grupului — ID-uri incorecte sau expirate vor duce la eșecul livrării.
• Dacă mesajul este trimis dar nu apare în grup, verifică formatul. De exemplu, grupurile WhatsApp pot să nu afișeze anumite tipuri de conținut, precum imagini webp sau butoane interactive.

Permisiune refuzată?

• Numărul tău nu este recunoscut ca admin al grupului.
• API-ul poate să nu fi sincronizat corect statutul tău de admin sau numărul. În acest caz, încearcă să reautorizezi canalul API pentru a actualiza permisiunile și metadatele.

Membrii grupului nu sunt afișați?

Ce înseamnă @lid în lista de participanți?

// GET https://gate.whapi.cloud/contacts/ids/{contactLid}
const contactLid = "1524746986546@lid";
const res = await fetch(`https://gate.whapi.cloud/contacts/ids/${contactLid}`, {
  method: 'GET',
  headers: {
    'accept': 'application/json',
    'authorization': `Bearer ${process.env.WHAPI_TOKEN}`
  }
});
const { phone } = await res.json();
console.log("Resolved JID phone number:", phone);

Implementare și utilizarea serverelor

Firebase

AWS (Amazon Web Services)

Heroku

Sumar și ce urmează