Crear un grupo de WhatsApp por API (groups)

Descripción del caso de uso

Este escenario usa la API groups con operación create para aprovisionar un grupo de WhatsApp nombrado para difusiones de equipo. No se requiere ventana de sesión de 24 horas porque la llamada es una acción de gestión de canal.

Ejemplo de plantilla

Grupo interno creado para difusión de ventas — comparte el enlace de invitación con tu equipo.

Cuándo usarlo

Usa este escenario cuando ventas o marketing necesitan un grupo de WhatsApp dedicado para difusión interna y coordinación de campañas, y crear grupos a mano en la app Business no escala entre canales ni con automatización. Encaja para desarrolladores que conectan eventos de CRM o admin, equipos pequeños que levantan un canal de difusión con nombre, y agencias que aprovisionan grupos de campaña para clientes sin pasos manuales de administración.

Flujo de trabajo

1. Disparador

   Un evento de admin o CRM dispara el aprovisionamiento del grupo de equipo.

   evento · disparado

2. Capturar evento

   groups create establece el nombre del grupo y la descripción de difusión interna.

   POST /groups

3. Construir y enviar

   La API devuelve metadatos del grupo incluyendo el enlace de invitación.

   POST /groups

4. Entregado

   Tu sistema comparte la URL de invitación con miembros autorizados del equipo.

   entregado

Implementación técnica

Requisitos previos

1. Clave API de 1MSG · Cómo obtener la clave API
2. Cuenta de WhatsApp Business · Cómo conectar WABA
3. Ventana de sesión de 24 horas abierta · Cómo funciona la ventana de 24 horas
4. Opt-in del cliente · Cómo gestionar el consentimiento

Ejemplos de código

#!/usr/bin/env bash
set -euo pipefail

# === Configuration (replace "___" placeholders) ===
API_BASE_URL="https://api.1msg.io"        # production 1MSG API base URL
CHANNEL_ID="___"                           # channel ID from 1MSG dashboard
API_TOKEN="___"                            # channel JWT token (Bearer)



URL="${API_BASE_URL%/}/${CHANNEL_ID}/groups"

read -r -d '' PAYLOAD <<JSON || true
{
  "groupName": "Sales team Q1",
  "description": "Internal broadcast"
}
JSON

RESPONSE="$(curl -s -w '\n%{http_code}' -X POST "$URL" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d "$PAYLOAD")"

HTTP_CODE="$(printf '%s' "$RESPONSE" | tail -n1)"
BODY="$(printf '%s' "$RESPONSE" | sed '$d')"

case "$BODY" in
  *'"created":true'*) ok=1 ;;
  *) ok=0 ;;
esac

if [ "$HTTP_CODE" -ge 200 ] && [ "$HTTP_CODE" -lt 300 ] && [ "$ok" -eq 1 ]; then
  echo "$BODY"
else
  echo "$BODY" >&2
  exit 1
fi

Respuesta y estado de entrega

HTTP 2xx y JSON "created": true significan que el grupo existe. Guarda chatID: con él envías mensajes al grupo.

{
  "created": true,
  "chatID": "[email protected]",
  "invite_link": "https://chat.whatsapp.com/<LINK_ID>"
}

Estados de entrega y webhooks →