Grupos WhatsApp

Enviar mensajes a grupos de WhatsApp

Para enviar un mensaje a un grupo de WhatsApp se utiliza el mismo endpoint de envio individual POST /api/send/whatsapp, pero en lugar de un numero de telefono, el parametro recipient debe contener el ID del grupo en formato @g.us.

120363012345678@g.us

Ejemplo de envio a grupo

Usa el endpoint POST /api/send/whatsapp con el ID del grupo como recipient:

# Enviar mensaje de texto a un grupo de WhatsApp
curl -X POST //whatsboost.netapi/send/whatsapp \
  -d "secret=TU_API_KEY" \
  -d "recipient=120363012345678@g.us" \
  -d "account=WA_ACCOUNT_UNIQUE" \
  -d "message=Recordatorio: reunion de equipo manana a las 10:00." \
  -d "type=text" \
  -d "priority=2"

# Enviar imagen a un grupo
curl -X POST //whatsboost.netapi/send/whatsapp \
  -d "secret=TU_API_KEY" \
  -d "recipient=120363012345678@g.us" \
  -d "account=WA_ACCOUNT_UNIQUE" \
  -d "message=Agenda de la reunion" \
  -d "type=media" \
  -d "media_type=image" \
  -d "media_url=https://ejemplo.com/agenda.jpg"

<?php
/**
 * Enviar mensaje a un grupo de WhatsApp
 */

$ch = curl_init("//whatsboost.netapi/send/whatsapp");

curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_POSTFIELDS     => [
        "secret"    => "TU_API_KEY",
        "recipient" => "120363012345678@g.us",  // ID del grupo
        "account"   => "WA_ACCOUNT_UNIQUE",
        "message"   => "Recordatorio: reunion de equipo manana a las 10:00.",
        "type"      => "text",
        "priority"  => 2
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result["status"] === 200) {
    echo "Mensaje enviado al grupo! ID: " . $result["data"] . PHP_EOL;
} else {
    echo "Error: " . $result["message"] . PHP_EOL;
}

Como obtener el ID de grupo

Existen dos formas de obtener los IDs de los grupos de WhatsApp de una cuenta vinculada:

Listar grupos de una cuenta

GET /api/get/wa.groups

Devuelve la lista completa de grupos de WhatsApp a los que pertenece una cuenta vinculada. Incluye el ID del grupo (gid) y su nombre.

URL completa del endpoint:

GET //whatsboost.netapi/get/wa.groups?secret=TU_API_KEY&unique=WA_ACCOUNT_UNIQUE

Parametros

Respuesta exitosa

Devuelve un array con los grupos disponibles. Cada grupo incluye su gid (ID de grupo WhatsApp) y name (nombre del grupo):

{
  "status": 200,
  "message": "WhatsApp groups retrieved!",
  "data": [
    {
      "gid": "120363012345678@g.us",
      "name": "Equipo de ventas"
    },
    {
      "gid": "120363087654321@g.us",
      "name": "Soporte tecnico"
    },
    {
      "gid": "120363011223344@g.us",
      "name": "Marketing y comunicacion"
    }
  ]
}

Respuesta con error

{
  "status": 400,
  "message": "Invalid WhatsApp account!",
  "data": false
}

Ejemplos

# Listar todos los grupos de una cuenta de WhatsApp
curl -X GET "//whatsboost.netapi/get/wa.groups?secret=TU_API_KEY&unique=WA_ACCOUNT_UNIQUE"

<?php
/**
 * Listar grupos de WhatsApp de una cuenta vinculada
 */

$apiKey  = "TU_API_KEY";
$unique  = "WA_ACCOUNT_UNIQUE";

$ch = curl_init("//whatsboost.netapi/get/wa.groups?secret=" . $apiKey . "&unique=" . $unique);

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 15
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result["status"] === 200) {
    echo "Grupos encontrados: " . count($result["data"]) . PHP_EOL;

    foreach ($result["data"] as $grupo) {
        echo "  - " . $grupo["name"] . " (" . $grupo["gid"] . ")" . PHP_EOL;
    }
} else {
    echo "Error: " . $result["message"] . PHP_EOL;
}

Diferencia entre grupos de contactos y grupos de WhatsApp

Es importante distinguir entre dos conceptos diferentes que pueden causar confusion:

Documentacion relacionada