Referencia (endpoints)Acciones de grupo

Sumar participantes a un grupo

Úsalo para sumar a un grupo hasta 20 personas por su teléfono. Con un número por QR entran directo; con uno oficial, cada una recibe una invitación. El resultado dice cómo salió cada una.

POST
/v1/groups/{group}/participants

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. Con un número QR cada teléfono se agrega por separado, uno tras otro, al ritmo de las campañas. El resultado informa cada persona como added o failed.

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" \  -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…