Vai al contenuto
WbizTool

Invia messaggi a un gruppo WhatsApp con l'API

Pubblica annunci per il team, aggiornamenti per la community e report giornalieri in un gruppo WhatsApp dal tuo codice. Il tuo numero WhatsApp collegato li invia a qualsiasi gruppo di cui è membro, scelto tramite il nome esatto del gruppo.

Inizia gratis

Prova gratuita: 50 messaggi in qualsiasi arco di 30 giorni, senza carta.

Come funziona

  1. Ottieni la chiave API e collega il tuo numero

    Registrati, poi collega il tuo numero WhatsApp nella pagina Numeri WhatsApp con un codice QR o un codice di abbinamento, come WhatsApp Web. In Impostazioni → Chiavi API, crea una chiave e copia il tuo Client ID (la guida Chiavi API qui sotto mostra dove). L'ID sulla scheda del numero (come ID 678) è il tuo whatsapp_client.

  2. Assicurati che il tuo numero sia nel gruppo

    Il numero da cui invii deve essere membro del gruppo, e amministratore se lì possono scrivere solo gli amministratori. Annota il nome del gruppo esattamente come lo mostra WhatsApp, emoji e punteggiatura compresi.

  3. Invia al gruppo

    Fai una POST a https://wbiztool.com/api/v1/send_msg/group/ con group_name e msg. Una risposta con "status": 1 e un msg_id significa che il messaggio è in coda.

  4. Controlla che sia partito

    Il gruppo viene cercato quando il messaggio viene inviato, non quando chiami l'API. Controlla Stato del messaggio o un webhook: un nome sbagliato fallisce lì con Group not found.

Esempi di codice Messaggi ai gruppi

Invia un testo a un gruppo (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 ufficiale)
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): un'immagine da un 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 (estensione 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');
}

Cosa puoi fare

  • Testi, immagini e file

    msg_type 0 invia testo, 1 un'immagine da img_url e 2 un file da file_url, oppure carica il file come multipart form data in un campo chiamato file.

  • Scelto tramite il nome del gruppo

    Non c'è nessun ID di gruppo da cercare: group_name è il nome esatto del gruppo in WhatsApp. Scrivilo con le stesse maiuscole e minuscole che mostra WhatsApp; i nomi parziali non corrispondono.

  • Pianifica un messaggio a un gruppo

    Pianifica messaggio (/api/v1/schedule_msg/) accetta group_name al posto di phone, con una data, un'ora e un fuso orario.

  • Gruppi e numeri in una sola richiesta

    Invia a più numeri accetta nomi di gruppi insieme a numeri di telefono, quindi una chiamata può raggiungere più gruppi.

  • Stato via webhook

    Passa webhook per ricevere una POST con il msg_id e SENT o FAILED, oppure chiama Stato del messaggio con il msg_id.

Buono a sapersi

  • L'invio a un gruppo WhatsApp tramite API (group_name al posto di phone) funziona con ogni piano, compresa la prova gratuita.
  • Il nome del gruppo non viene controllato quando chiami l'API, quindi "status": 1 significa solo che il messaggio è in coda. Un nome che non corrisponde esattamente, un contatto con lo stesso nome o un gruppo riservato agli amministratori in cui il tuo numero non può scrivere falliscono in seguito con Group not found.
  • Se due gruppi hanno esattamente lo stesso nome, il messaggio va al primo nei risultati di ricerca di WhatsApp. Dai a ogni gruppo un nome unico, e aggiorna group_name se qualcuno rinomina il gruppo.
  • Ogni messaggio a un gruppo conta come un messaggio nei 1.000 al giorno del numero con uso corretto.
  • I messaggi partono dal tuo numero WhatsApp, quindi valgono le regole di WhatsApp: scrivi a persone che si aspettano di sentirti.

Domande

Come trovo l'ID di un gruppo WhatsApp?
Non ti serve. L'API trova il gruppo tramite il nome: invia group_name esattamente come lo mostra WhatsApp, emoji e punteggiatura compresi, da un numero che fa parte del gruppo.
Quali piani possono inviare ai gruppi tramite API?
Tutti, compresa la prova gratuita. Un messaggio a un gruppo conta come un messaggio, come quello a un numero di telefono.
Perché il mio messaggio al gruppo è fallito con Group not found?
Il nome non corrispondeva esattamente a un gruppo, un contatto ha lo stesso nome, il tuo numero non è nel gruppo, oppure possono scrivere solo gli amministratori e il tuo numero non lo è. Controlla in WhatsApp la grafia esatta e le maiuscole.
Posso pianificare un messaggio a un gruppo?
Sì. Fai una POST a /api/v1/schedule_msg/ con group_name al posto di phone, più date (gg/mm/aaaa), time (HH:MM) e timezone.
Mi servono la WhatsApp Business API o l'approvazione di Meta?
No. WbizTool invia dal tuo numero WhatsApp o WhatsApp Business, collegato come WhatsApp Web. Non serve l'approvazione di Meta e non ci sono template di messaggio da far approvare.

Leggi le guide

Pagine correlate

Invia oggi il tuo primo messaggio WhatsApp automatizzato

Crea un account, scansiona il codice QR e invia un messaggio in meno di cinque minuti.

Inizia gratis

I piani a pagamento partono da $25 al mese negli USA. Prezzi