Aller au contenu
WbizTool

Envoyez des messages à un groupe WhatsApp avec l’API

Publiez des annonces d’équipe, des nouvelles de votre communauté et des rapports quotidiens dans un groupe WhatsApp depuis votre propre code. Votre numéro WhatsApp relié les envoie à n’importe quel groupe dont il est membre, désigné par le nom exact du groupe.

Essai gratuit

Essai gratuit : 50 messages sur n’importe quelle période de 30 jours, sans carte bancaire.

Comment ça marche

  1. Obtenez votre clé API et reliez votre numéro

    Inscrivez-vous, puis reliez votre numéro WhatsApp sur la page Numéros WhatsApp avec un code QR ou un code de connexion, comme WhatsApp Web. Dans Paramètres → Clés API, créez une clé et copiez votre Client ID (le guide des clés API ci-dessous montre où). L’ID affiché sur la carte du numéro (par exemple ID 678) est votre whatsapp_client.

  2. Vérifiez que votre numéro est dans le groupe

    Le numéro d’envoi doit être membre du groupe, et administrateur si seuls les administrateurs peuvent y écrire. Notez le nom du groupe exactement comme WhatsApp l’affiche, émojis et ponctuation compris.

  3. Envoyez au groupe

    Faites un POST vers https://wbiztool.com/api/v1/send_msg/group/ avec group_name et msg. Une réponse avec "status": 1 et un msg_id signifie que le message est en file d’attente.

  4. Vérifiez qu’il est parti

    Le groupe est recherché au moment où le message est envoyé, pas lors de l’appel à l’API. Consultez le statut du message ou un webhook : un nom erroné y échoue avec Group not found.

Exemples de code Messages de groupe

Envoyer un texte à un groupe (cURL)
curl -X POST https://wbiztool.com/api/v1/send_msg/group/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "group_name": "Sales Team Mumbai",
    "msg": "Reminder: *weekly review* starts at 4 PM today."
  }'
Python (requests)
import requests

response = requests.post(
    "https://wbiztool.com/api/v1/send_msg/group/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "msg_type": 0,
        "group_name": "Sales Team Mumbai",
        "msg": "Reminder: *weekly review* starts at 4 PM today.",
    },
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 400

if result.get("status") == 1:
    print("Queued with msg_id", result["msg_id"])
else:
    print("Failed:", result.get("message"))
Python (client officiel)
from wbiztool_client import WbizToolClient

client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)

result = client.send_message_to_group(
    group_name="Sales Team Mumbai",
    msg="Reminder: weekly review starts at 4 PM today.",
    whatsapp_client=678,
)
print(result)
Node.js (fetch) : une image depuis une URL
// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/send_msg/group/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    client_id: 12345,
    api_key: "YOUR_API_KEY",
    whatsapp_client: 678,
    msg_type: 1,
    group_name: "Sales Team Mumbai",
    img_url: "https://example.com/reports/weekly-sales.png",
    msg: "This week's sales summary",
  }),
});
console.log(await response.json());
PHP (extension cURL)
<?php
$payload = [
    'client_id'       => 12345,
    'api_key'         => 'YOUR_API_KEY',
    'whatsapp_client' => 678,
    'msg_type'        => 0,
    'group_name'      => 'Sales Team Mumbai',
    'msg'             => 'Reminder: *weekly review* starts at 4 PM today.',
];

$ch = curl_init('https://wbiztool.com/api/v1/send_msg/group/');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($result['status'] ?? 0) === 1) {
    echo 'Queued with msg_id ' . $result['msg_id'];
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no response');
}

Ce que vous pouvez faire

  • Textes, images et fichiers

    msg_type 0 envoie du texte, 1 une image depuis img_url et 2 un fichier depuis file_url, ou téléversez le fichier en multipart form data dans un champ nommé file.

  • Choisi par le nom du groupe

    Aucun ID de groupe à chercher : group_name est le nom exact du groupe dans WhatsApp. Écrivez-le avec les mêmes majuscules et minuscules que dans WhatsApp ; les noms partiels ne correspondent pas.

  • Planifier un message de groupe

    L’API de planification de message (/api/v1/schedule_msg/) accepte group_name à la place de phone, avec une date, une heure et un fuseau horaire.

  • Groupes et numéros dans une seule requête

    L’envoi à plusieurs numéros accepte des noms de groupes mêlés à des numéros de téléphone : un seul appel peut donc atteindre plusieurs groupes.

  • Statut par webhook

    Passez webhook pour recevoir un POST avec le msg_id et SENT ou FAILED, ou appelez l’endpoint de statut du message avec le msg_id.

Bon à savoir

  • L’envoi à un groupe WhatsApp via l’API (group_name au lieu de phone) fonctionne avec tous les forfaits, essai gratuit compris.
  • Le nom du groupe n’est pas vérifié lors de l’appel à l’API : "status": 1 signifie seulement que le message est en file d’attente. Un nom qui ne correspond pas exactement, un contact portant le même nom, ou un groupe réservé aux administrateurs où votre numéro ne peut pas écrire échoue plus tard avec Group not found.
  • Si deux groupes portent exactement le même nom, le message part vers le premier dans les résultats de recherche de WhatsApp. Donnez à chaque groupe un nom unique, et mettez à jour group_name si quelqu’un renomme le groupe.
  • Chaque message de groupe compte comme un message dans les 1 000 par jour du numéro, dans le cadre de l’usage raisonnable.
  • Les messages partent de votre propre numéro WhatsApp, donc les règles de WhatsApp s’appliquent : écrivez aux personnes qui s’attendent à avoir de vos nouvelles.

Questions fréquentes

Comment trouver l’ID d’un groupe WhatsApp ?
Vous n’en avez pas besoin. L’API trouve le groupe par son nom : envoyez group_name exactement comme WhatsApp l’affiche, émojis et ponctuation compris, depuis un numéro membre du groupe.
Quels forfaits peuvent envoyer à des groupes via l’API ?
Tous les forfaits, essai gratuit compris. Un message de groupe compte comme un message, comme un message vers un numéro de téléphone.
Pourquoi mon message de groupe a-t-il échoué avec Group not found ?
Le nom ne correspondait exactement à aucun groupe, un contact porte le même nom, votre numéro n’est pas dans le groupe, ou seuls les administrateurs peuvent écrire et votre numéro n’en fait pas partie. Vérifiez l’orthographe et les majuscules exactes dans WhatsApp.
Puis-je planifier un message vers un groupe ?
Oui. Faites un POST vers /api/v1/schedule_msg/ avec group_name au lieu de phone, plus date (jj/mm/aaaa), time (HH:MM) et timezone.
Ai-je besoin de l’API WhatsApp Business ou d’une validation Meta ?
Non. WbizTool envoie depuis votre propre numéro WhatsApp ou WhatsApp Business, relié comme WhatsApp Web. Pas de validation Meta, et aucun modèle de message à faire approuver.

Lire les guides

Voir aussi

Envoyez votre premier message WhatsApp automatisé dès aujourd'hui

Créez un compte, scannez le QR code et envoyez un message en moins de cinq minutes.

Essai gratuit

Forfaits payants à partir de 25 $ par mois aux États-Unis. Tarifs