Referencia (endpoints)Acciones de grupo

Cambiar la descripción de un grupo

Sirve para cambiar la descripción de un grupo, de hasta 2048 caracteres, o borrarla dejándola vacía (con un número oficial no se puede borrar).

PUT
/v1/groups/{group}/description

Permiso requerido: Grupos y campañas → Administrar grupos

Nota: Asíncrona: responde 202 con action_id; consulta el resultado en GET /groups/actions/{action}. Hasta 2048 caracteres. Con un número QR, una descripción vacía la borra; con un número oficial responde 422 validation_failed, porque WhatsApp no permite borrar la descripción de un grupo oficial. Se ejecuta al ritmo de las campañas del número.

Autorización

http
headerAuthorizationBearer <clave>

Tu clave de API de Funnelchat, en la cabecera Authorization: Bearer de cada llamada.

Parámetros de la ruta

group*string

Cuerpo del pedido

application/json
  1. body

Cuerpo de PUT /groups/{group}/description: una descripción vacía la borra, salvo con un número oficial, en el que WhatsApp no permite borrarla. Los campos que no figuran se ignoran.

device_id*string

Id opaco: un texto que empieza con dev_. Se usa tal como llega; no se arma ni se interpreta.

Patrón^dev_[A-Za-z0-9]{23}$
description*|
Largolength <= 2048

Cuerpo de la respuesta

ApiGroupActionAcceptedResource

application/json
  1. response
action_id*string
status*string
curl -X PUT "https://example.com/v1/groups/string/description" \  -H "Content-Type: application/json" \  -d '{    "device_id": "dev_Ac7Ku7iIZDXJTjdCu0UB1mX",    "description": "string"  }'
{  "action_id": "string",  "status": "queued"}

Esto es lo que se copia para tu IA

Cargando…