Aggiungi o rimuovi partecipanti dai gruppi WhatsApp con API

12 agosto 2024

Scopri come aggiungere o rimuovere partecipanti "automaticamente" ai gruppi WhatsApp. Potenzia il tuo marchio e porta le tue vendite al livello successivo.

Seguendo la nostra serie di articoli con consigli sui gruppi WhatsApp con Wassenger’s API, oggi ti mostreremo come aumentare le vendite aggiungendo o rimuovendo partecipanti dai gruppi e come aiutarti a categorizzare i tuoi clienti in diversi gruppi per mantenere la tua azienda aggiornata e ottimizzata.

  • Scopri come creare un gruppo tramite la nostra API qui
  • Scopri come gestire i gruppi WhatsApp qui

🤩 🤖 Wassenger è una soluzione API completa per WhatsApp. Iscriviti per una prova gratuita di 7 giorni e inizia in pochi minuti!

Requisiti

  • Avere un numero WhatsApp già collegato alla piattaforma e online.
  • Ottenere l'ID univoco del tuo numero fornito da Wassenger da qui.
  • ID del gruppo WhatsApp (WID) che puoi trovare in due modi:

Come ottenere l'ID del gruppo WhatsApp

Puoi ottenere l'ID del gruppo WhatsApp utilizzando uno di questi metodi:

  1. Web: vai su impostazioni del numero > Gruppi > Copia il Group WID.
  2. API: richiedi i gruppi disponibili sul tuo numero utilizzando questo endpoint.

Endpoint API

Utilizzeremo il seguente endpoint API per gestire i partecipanti del gruppo:

Aggiungi partecipanti

Preparare la richiesta

Punta all'URL dell'API usando il metodo POST per aggiungere partecipanti

Prova l'API direttamente dal tuo browser cliccando qui

https://api.wassenger.com/v1/devices/{deviceId}/groups/{groupId}/participants

Intestazioni HTTPS richieste > Ottieni la tua chiave API qui

Content-Type: application/json
Token: $API_TOKEN

Usa il corpo in formato JSON

{
  "participants": [
    {
      "phone": "+12345678900",
      "admin": true
    },
    {
      "phone": "+12345678901",
      "admin": false
    }
  ]
}

Aggiungere partecipanti usando codice

Scopri come usare il codice nel tuo browser senza installare alcun software.

Inoltre, puoi trovare diversi linguaggi che puoi testare su Replit.com:

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/devices/61b37a069cba0c15d6/groups/1203630298136@g.us/participants"
payload = { "participants": [
{
"phone": "+12345678909", 
"admin": True
}, 
{
"phone": "+12345678901", 
"admin": False
}
] }
headers = {
"Content-Type": "application/json", 
"Token": "API_TOKEN_GOES_HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/devices/61b37a069cba0c15d6C/groups/12036302981363@g.us/participants',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode([
    'participants' => [
      [
        'phone' => '+12345678909',
        'admin' => null,
      ],
      [
        'phone' => '+12345678901',
        'admin' => null,
      ],
    ],
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Token: API_TOKEN_GOES_HERE',
  ],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo 'cURL Error #:' . $err;
} else {
  echo $response;
}
// Examples requires to have installed pecl_http package, a simple and elegant HTTP client for PHP.
// Install it by running: pecl install pecl_http
// More information: https://pecl.php.net/package/pecl_http/3.2.0
<?php
$client = new http\Client();
$request = new http\Client\Request();
$body = new http\Message\Body();
$body->append(
  json_encode([
    'participants' => [
      [
        'phone' => '+12345678901',
        'admin' => null,
      ],
      [
        'phone' => '+12345678902',
        'admin' => null,
      ],
    ],
  ])
);
$request->setRequestUrl(
  'https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c/groups/12036302981363@g.us/participants'
);
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setHeaders([
  'Content-Type' => 'application/json',
  'Token' => 'API_TOKEN_GOES_HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();
package main
import(
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url:= "https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c/groups/120363029813@g.us/participants"
payload:= strings.NewReader("{\"participants\":[{\"phone\":\"+12345678901\", \"admin\":true}, {\"phone\":\"+12345678902\", \"admin\":false}]}")
req, _:= http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
req.Header.Add("Token", "API_TOKEN_GOES_HERE")
res, _:= http.DefaultClient.Do(req)
defer res.Body.Close()
body, _:= io.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
// This code requires you to have installed RestSharp package.
// Documentation: https://restsharp.dev
// Installation: https://www.nuget.org/packages/RestSharp
var client = new RestClient("https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c/groups/1203630298136@g.us/participants");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Token", "API_TOKEN_GOES_HERE");
request.AddParameter("application/json", "{\"participants\":[{\"phone\":\"+12345678901\", \"admin\":true}, {\"phone\":\"+12345678902\", \"admin\":false}]}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

require 'uri' require 'net/http'

url = URI("https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c/groups/12036302981363@g.us/participants")

http = Net::HTTP.new(url.host, url.port) http.use_ssl = true

request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request["Token"] = 'API_TOKEN_GOES_HERE' request.body = "{\"participants\":[{\"phone\":\"+12345678901\",\"admin\":true},{\"phone\":\"+12345678902\",\"admin\":false}]}"

response = http.request(request) puts response.read_body

// This code requires you to have installed Unirest package.
// Documentation: https://kong.github.io/unirest-java/#requests
// Installation: http://kong.github.io/unirest-java/
HttpResponse<String> response = Unirest.post("https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c897/groups/1203630298136@g.us/participants")
.header("Content-Type", "application/json")
.header("Token", "API_TOKEN_GOES_HERE")
.body("{\"participants\":[{\"phone\":\"+12345678901\", \"admin\":true}, {\"phone\":\"+12345678902\", \"admin\":false}]}")
.asString();

🤩 🤖 Wassenger è una piattaforma di comunicazione completa e una soluzione API per WhatsApp. Esplora oltre 100 casi d'uso API e automatizza qualsiasi cosa su WhatsApp iscrivendoti per una prova gratuita e iniziando in pochi minuti**!**

Rimuovi partecipanti

Preparare la richiesta

Punta all'URL dell'API usando il metodo DELETE per rimuovere partecipanti

https://api.wassenger.com/v1/devices/{deviceId}/groups/{groupId}/participants

Intestazioni HTTPS richieste > Ottieni la tua chiave API qui

Content-Type: application/json
Token: $API_TOKEN

Usa il corpo in formato JSON

['+12345678900', '+12345678901'];

Scopri come usare il codice nel tuo browser senza installare alcun software.

Inoltre, puoi trovare diversi linguaggi che puoi testare su Replit.com:

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c/groups/12036302981363@g.us/participants"
payload = ["+12345678901", "+12345678902"]
headers = {
"Content-Type": "application/json", 
"Token": "API_TOKEN_GOES_HERE"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c/groups/1203630298136@g.us/participants", 
CURLOPT_RETURNTRANSFER => true, 
CURLOPT_ENCODING => "", 
CURLOPT_MAXREDIRS => 10, 
CURLOPT_TIMEOUT => 30, 
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, 
CURLOPT_CUSTOMREQUEST => "DELETE", 
CURLOPT_POSTFIELDS => json_encode([
'+12345678901', 
'+12345678902'
]), 
CURLOPT_HTTPHEADER => [
"Content-Type: application/json", 
"Token: API_TOKEN_GOES_HERE"
], 
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if($err) {
echo "cURL Error #:".$err;
} else {
echo $response;
package main
import(
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url:= "https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c89/groups/1203630298136@g.us/participants"
payload:= strings.NewReader("[\"+12345678901\", \"+12345678902\"]")
req, _:= http.NewRequest("DELETE", url, payload)
req.Header.Add("Content-Type", "application/json")
req.Header.Add("Token", "API_TOKEN_GOES_HERE")
res, _:= http.DefaultClient.Do(req)
defer res.Body.Close()
body, _:= io.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
// This code requires you to have installed RestSharp package.
// Documentation: https://restsharp.dev
// Installation: https://www.nuget.org/packages/RestSharp
var client = new RestClient("https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c/groups/12036302981363@g.us/participants");
var request = new RestRequest(Method.DELETE);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Token", "API_TOKEN_GOES_HERE");
request.AddParameter("application/json", "[\"+12345678901\", \"+12345678902\"]", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

require 'uri' require 'net/http'

url = URI("https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c8/groups/12036302981363@g.us/participants")

http = Net::HTTP.new(url.host, url.port) http.use_ssl = true

request = Net::HTTP::Delete.new(url) request["Content-Type"] = 'application/json' request["Token"] = 'API_TOKEN_GOES_HERE' request.body = "[\"+12345678901\",\"+12345678902\"]"

response = http.request(request) puts response.read_body

// This code requires you to have installed Unirest package.
// Documentation: https://kong.github.io/unirest-java/#requests
// Installation: http://kong.github.io/unirest-java/
HttpResponse<String> response = Unirest.delete("https://api.wassenger.com/v1/devices/61b37a069cba0c15d6c/groups/12036302981363@g.us/participants")
.header("Content-Type", "application/json")
.header("Token", "API_TOKEN_GOES_HERE")
.body("[\"+12345678901\", \"+12345678902\"]")
.asString();

🖥️ Cerchi un esempio di codice? Vai al tester API live e ottieni esempi di codice pronti all'uso in 15+ linguaggi di programmazione, inclusi Python, JavaScript, PHP, C#, Java, Ruby, Go, Powershell, cURL e altri.

Test API dal vivo

Puoi testare l'API dal vivo e sperimentare direttamente dal tuo browser.

Una volta terminati i test, ottieni l'esempio di codice auto-generato nel linguaggio di programmazione preferito e sarai pronto a partire.

Prova il tester API live

🤩 🤖 Wassenger è una piattaforma di comunicazione completa e una soluzione API per WhatsApp. Esplora oltre 100 casi d'uso API e automatizza qualsiasi cosa su WhatsApp iscrivendoti per una prova gratuita e iniziando in pochi minuti**!**

Domande frequenti

Come posso gestire i contatti in un gruppo?

Devi semplicemente inviare più richieste API, una per ciascun gruppo di destinazione.

Ad esempio, se vuoi aggiornare 10 gruppi, dovresti inviare 10 richieste HTTPS indipendenti all'API, una per ogni metodo (POST, PATCH o DELETE).

Non esiste un'opzione per gestire gruppi diversi in un'unica richiesta API.

Quanti contatti posso gestire contemporaneamente?

Per prevenire problemi di elaborazione o errori, non è consigliato gestire più di 10 partecipanti alla volta per richiesta API (aggiungere, eliminare, promuovere o declassare).

Ulteriori risorse utili

Documentazione API

Per maggiori dettagli sull'endpoint API, consulta la nostra documentazione. Troverai tutti i dettagli sui parametri di richiesta accettati, le possibili risposte di successo o errore e esempi di codice pronti all'uso in più linguaggi di programmazione.

https://app.wassenger.com/docs/#tag/Groups

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free