Referencia (endpoints)Acciones de grupo

Aprobar solicitudes para unirse

Sirve para aprobar, por el teléfono de cada persona, las solicitudes para unirse a un grupo de un número oficial, si caben en los lugares libres. El resultado dice cómo salió cada una.

POST
/v1/groups/{group}/join-requests/approve

Permiso requerido: Grupos y campañas → Administrar grupos

Nota: Asíncrona: responde 202 con action_id; consulta el resultado en GET /groups/actions/{action}. Solo números oficiales con la versión preliminar de grupos de la API oficial y con la habilitación de decisiones; si no, 422 provider_unsupported. Verifica que los teléfonos entren en los lugares libres del grupo (capacity_full). El resultado es por persona.

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/join-requests/approve" \  -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…