Referencia (endpoints)Acciones de grupo

Sacar participantes de un grupo

Sirve para sacar de un grupo hasta 20 personas por su teléfono, en una sola operación de WhatsApp. El resultado dice, persona por persona, si salió.

POST
/v1/groups/{group}/participants/remove

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 20 teléfonos por pedido, sacados en una sola operación de WhatsApp. No admite el teléfono del propio número que ejecuta.

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 las acciones de grupo que reciben una lista de teléfonos (device_id y phones). Los teléfonos se normalizan y se quitan los repetidos antes de contarlos contra el máximo por pedido. 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}$
phones*array<>
Elementos1 <= items <= 100

Cuerpo de la respuesta

ApiGroupActionAcceptedResource

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

Esto es lo que se copia para tu IA

Cargando…