Ajouter ou supprimer des participants des groupes WhatsApp avec l'API

12 août 2024

Apprenez à ajouter ou supprimer des participants « automatiquement » aux groupes WhatsApp. Boostez votre marque et augmentez vos ventes.

Dans la suite de notre série d'articles sur les conseils pour les groupes WhatsApp avec Wassenger’s API, aujourd'hui nous allons vous montrer comment vous pouvez augmenter vos ventes en ajoutant ou supprimant des participants des groupes et vous aider à catégoriser vos clients dans différents groupes pour maintenir votre entreprise à jour et optimisée.

  • Apprenez à créer un groupe via notre API ici
  • Apprenez à gérer les groupes WhatsApp ici

🤩 🤖 Wassenger est une solution API complète pour WhatsApp. Inscrivez-vous pour un essai gratuit de 7 jours et commencez en quelques minutes !

Exigences

  • Avoir un numéro WhatsApp déjà lié à la plateforme et en ligne.
  • Récupérer l'ID unique de votre numéro fourni dans Wassenger depuis ici.
  • ID WhatsApp du groupe (WID) que vous pouvez trouver de deux manières :

Comment obtenir l'ID WhatsApp du groupe

Vous pouvez obtenir l'ID WhatsApp du groupe en utilisant l'une de ces méthodes :

  1. Web : allez dans paramètres du numéro > Groupes > Copiez le WID du groupe.
  2. API : interrogez les groupes disponibles sur votre numéro en utilisant cet endpoint.

Endpoint API

Nous utiliserons l'endpoint API suivant pour gérer les participants du groupe :

Ajouter des participants

Préparer la requête

URL cible de l'API en utilisant la méthode POST pour ajouter des participants

Testez l'API directement dans votre navigateur en cliquant ici

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

En-têtes HTTPS requis > Obtenez votre clé API ici

Content-Type: application/json
Token: $API_TOKEN

Utilisez le corps en format JSON

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

Ajouter des participants en utilisant du code

Découvrez comment utiliser le code dans votre navigateur sans installer de logiciel.

Vous pouvez également trouver différents langages que vous pouvez tester sur 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 est une plateforme de communication et une solution API complète pour WhatsApp. Explorez plus de 100 cas d'utilisation API et automatisez tout sur WhatsApp en vous inscrivant pour un essai gratuit et en commençant en quelques minutes**!**

Supprimer des participants

Préparer la requête

URL cible de l'API en utilisant la méthode DELETE pour supprimer des participants

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

En-têtes HTTPS requis > Obtenez votre clé API ici

Content-Type: application/json
Token: $API_TOKEN

Utilisez le corps en format JSON

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

Découvrez comment utiliser le code dans votre navigateur sans installer de logiciel.

Vous pouvez également trouver différents langages que vous pouvez tester sur 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();

🖥️ Vous cherchez un exemple de code ? Allez sur le testeur API en direct et récupérez des exemples de code prêts à l'emploi dans plus de 15 langages de programmation, y compris Python, JavaScript, PHP, C#, Java, Ruby, Go, Powershell, cURL et plus encore.

Test en direct de l'API

Vous pouvez tester l'API en direct et jouer avec elle directement depuis votre navigateur.

Une fois vos tests terminés, récupérez l'exemple de code auto-généré dans le langage de programmation de votre choix et vous serez prêt à démarrer.

Tentez le testeur API en direct

🤩 🤖 Wassenger est une plateforme de communication et une solution API complète pour WhatsApp. Explorez plus de 100 cas d'utilisation API et automatisez tout sur WhatsApp en vous inscrivant pour un essai gratuit et en commençant en quelques minutes**!**

FAQ

Comment puis-je gérer les contacts dans un groupe ?

Il vous suffit d'envoyer plusieurs requêtes API, une par groupe cible.

Par exemple, si vous souhaitez mettre à jour 10 groupes, vous devez envoyer 10 requêtes HTTPS indépendantes à l'API, une par méthode (POST, PATCH ou DELETE).

Il n'y a pas d'option pour gérer différents groupes dans une seule requête API.

Combien de contacts puis-je gérer en une seule fois ?

Pour éviter des problèmes de traitement ou des erreurs, il n'est pas recommandé de gérer plus de 10 participants à la fois par requête API (ajout, suppression, promotion ou rétrogradation).

Ressources utiles supplémentaires

Documentation de l'API

Pour plus de détails sur l'endpoint API, veuillez consulter notre documentation. Vous y trouverez tous les détails sur les paramètres de requête acceptés, les réponses de succès ou d'erreur possibles et des exemples de code prêts à l'emploi dans plusieurs langages de programmation.

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

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free