API d'envoi à plusieurs numéros

Envoyez le même message WhatsApp à plusieurs numéros de téléphone et groupes en une seule requête. Utilisez-la pour de petites diffusions comme des newsletters, des offres et des annonces.

Wbiztool crée un message par destinataire et renvoie un msg_id pour chacun : vous pouvez ainsi vérifier leur statut individuellement.

Exemple rapide#

curl -X POST https://wbiztool.com/api/v1/send_msg/multi/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210,9812345670,Sales Team Mumbai",
    "msg": "Our Diwali sale starts tomorrow. Get 20% off on all orders!"
  }'

import requests

response = requests.post(
    "https://wbiztool.com/api/v1/send_msg/multi/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "msg_type": 0,
        "country_code": "91",
        "phone": ",".join(["9876543210", "9812345670", "Sales Team Mumbai"]),
        "msg": "Our Diwali sale starts tomorrow. Get 20% off on all orders!",
    },
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 400

if result.get("status") == 1:
    for item in result["messages"]:
        print(item["contact"], "->", item["msg_id"])
else:
    print("Failed:", result.get("message", "no message in response"))

// 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/multi/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    client_id: 12345,
    api_key: "YOUR_API_KEY",
    whatsapp_client: 678,
    msg_type: 0,
    country_code: "91",
    phone: ["9876543210", "9812345670", "Sales Team Mumbai"].join(","),
    msg: "Our Diwali sale starts tomorrow. Get 20% off on all orders!",
  }),
});
const result = await response.json(); // read the body even when the HTTP code is 400

if (result.status === 1) {
  for (const item of result.messages) {
    console.log(item.contact, "->", item.msg_id);
  }
} else {
  console.error("Failed:", result.message ?? "no message in response");
}

<?php
$payload = [
    'client_id'       => 12345,
    'api_key'         => 'YOUR_API_KEY',
    'whatsapp_client' => 678,
    'msg_type'        => 0,
    'country_code'    => '91',
    'phone'           => implode(',', ['9876543210', '9812345670', 'Sales Team Mumbai']),
    'msg'             => 'Our Diwali sale starts tomorrow. Get 20% off on all orders!',
];

$ch = curl_init('https://wbiztool.com/api/v1/send_msg/multi/');
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) {
    foreach ($result['messages'] as $item) {
        echo $item['contact'] . ' -> ' . $item['msg_id'] . PHP_EOL;
    }
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no message in response');
}

Remplacez 12345, YOUR_API_KEY et 678 par vos propres valeurs. Consultez Authentification pour savoir où les trouver.

Paramètres de la requête#

curl -X POST https://wbiztool.com/api/v1/send_msg/multi/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 1,
    "country_code": "91",
    "phone": "9876543210,9812345670",
    "img_url": "https://example.com/offers/diwali-sale.jpg",
    "msg": "Our Diwali sale starts tomorrow."
  }'

Comment les destinataires sont interprétés#

Wbiztool découpe phone au niveau des virgules, supprime les espaces autour de chaque élément, puis détermine la nature de chaque élément :

• Uniquement des chiffres (un + ou des zéros en tête sont acceptés) : traité comme un numéro de téléphone. country_code est ajouté sauf si le numéro commence déjà par celui-ci ; le numéro doit ensuite comporter de 6 à 15 chiffres.
• Tout le reste : traité comme un nom de groupe WhatsApp, trouvé de la même manière que dans Envoyer à un groupe.
• Un groupe dont le nom ne contient que des chiffres (par exemple 2024) est traité comme un numéro de téléphone, et les noms de groupe contenant des virgules ne peuvent pas être utilisés avec cet endpoint. Utilisez Envoyer à un groupe dans ces cas.

Autres points à connaître :

• Les numéros trop courts ou trop longs après l'ajout de l'indicatif pays sont ignorés sans avertissement. Ils n'apparaissent pas dans la réponse et ne reçoivent pas de msg_id.
• Les doublons ne sont pas supprimés. Un numéro listé deux fois reçoit deux messages.
• Si un numéro local commence par les mêmes chiffres que country_code (par exemple 9123456780 avec country_code 91), l'indicatif n'est pas ajouté. Envoyez ces numéros avec l'indicatif pays déjà inclus (919123456780).
• Les URL des images et des fichiers ne sont pas vérifiées lorsque vous appelez l'API. Elles sont téléchargées au moment de l'envoi de chaque message : un lien cassé fait donc échouer les messages plus tard, et non la requête. Les mêmes règles d'envoi que pour l'envoi de messages s'appliquent : les images de plus de 16 Mo et les vidéos de plus de 64 Mo échouent, l'audio WAV et OGG n'est pas pris en charge, et .pdf est ajouté aux fichiers (msg_type 2) sans extension prise en charge. Consultez Envoyer des images et des fichiers.

Crédits#

L'ensemble du lot est comparé à vos crédits restants avant toute création. Chaque élément non vide de phone est compté, y compris ceux qui sont ignorés par la suite. Si ce nombre dépasse vos crédits restants, aucun message n'est créé et vous obtenez :

{
  "message": "Not enough credits: 120 messages requested, 85 credits remaining",
  "status": 0
}

Les messages en file d'attente mais pas encore envoyés sont également déduits de vos crédits restants. Divisez les longues listes en requêtes plus petites ou rechargez votre forfait. Pour les grandes campagnes, téléversez plutôt un tableur depuis la page Campagnes.

Réponse#

Une requête réussie renvoie le code HTTP 200 :

{
  "msg_ids": [9817263, 9817264, 9817265],
  "messages": [
    { "msg_id": 9817263, "contact": "919876543210", "is_group": false },
    { "msg_id": 9817264, "contact": "919812345670", "is_group": false },
    { "msg_id": 9817265, "contact": "Sales Team Mumbai", "is_group": true }
  ],
  "message": "Successfully created 3 messages",
  "status": 1
}

Comparez messages avec la liste que vous avez envoyée pour repérer les numéros ignorés, et vérifiez que is_group vaut false pour chaque élément censé être un numéro de téléphone.

Erreurs#

La plupart des erreurs renvoient le code HTTP 200 avec status à 0 : vérifiez donc toujours status dans le corps. Sauf pour les erreurs HTTP 400 et 403, les réponses (y compris celles qui réussissent) sont du JSON envoyé avec Content-Type: text/html : analysez donc le corps vous-même au lieu de compter sur la détection automatique du JSON (par exemple dans les outils no-code) :

{ "message": "Invalid whatsapp client", "status": 0 }

Conseils#

• Envoyez phone sous forme de chaîne : joignez votre liste avec des virgules. Un tableau JSON renvoie {}.
• N'utilisez pas pour l'instant send_bulk_messages du client Python : il envoie la liste sous le nom phones, que cet endpoint ignore. Appelez directement l'endpoint comme dans les exemples ci-dessus.
• Suivez chaque message : enregistrez chaque msg_id de messages, ou transmettez un webhook pour être notifié de l'envoi ou de l'échec de chacun.
• Gardez votre numéro connecté : chaque message est envoyé depuis votre numéro WhatsApp, qui doit donc rester connecté dans les paramètres WhatsApp jusqu'à ce que tout le lot soit parti.
• Texte différent pour chaque personne : cet endpoint envoie le même msg à tout le monde. Appelez Envoyer un message une fois par destinataire pour personnaliser chaque message.