Referencia (endpoints)Acciones de grupo

Crear un grupo

Sirve para crear un grupo de WhatsApp desde uno de tus números, con su nombre, su descripción y hasta 20 participantes. Se hace después, al ritmo del número: con el action_id ves cómo salió y su link de invitación.

POST
/v1/groups

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 participantes iniciales, sin contar al propio número. Con un número QR la descripción se pone justo después de crear el grupo, y las creaciones respetan la espera entre creaciones del número. El resultado trae el grupo y su link de invitación. Con un número oficial, join_approval_required: true crea el grupo pidiendo aprobación para entrar (no se puede cambiar después); con un número QR responde 422 provider_unsupported.

Autorización

http
headerAuthorizationBearer <clave>

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

Cuerpo del pedido

application/json
  1. body

Cuerpo de POST /groups: device_id, name, description opcional y participants (con un número QR, de 1 al máximo permitido, teléfonos distintos y nunca el del propio número que crea el grupo). Los teléfonos se normalizan y se quitan los repetidos antes de contarlos. 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}$
name*string
Largo1 <= length <= 100
description?|
Largolength <= 2048
join_approval_required?boolean
participants*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" \  -H "Content-Type: application/json" \  -d '{    "device_id": "dev_Ac7Ku7iIZDXJTjdCu0UB1mX",    "name": "string",    "participants": [      "string"    ]  }'
{  "action_id": "string",  "status": "queued"}

Esto es lo que se copia para tu IA

Cargando…