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.
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.
httpAuthorizationBearer <clave>Tu clave de API de Funnelchat, en la cabecera Authorization: Bearer de cada llamada.
application/json- 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*stringId opaco: un texto que empieza con dev_. Se usa tal como llega; no se arma ni se interpreta.
^dev_[A-Za-z0-9]{23}$name*string1 <= length <= 100description?|length <= 2048join_approval_required?booleanparticipants*array<>1 <= items <= 100ApiGroupActionAcceptedResource
application/json- response
action_id*stringstatus*stringcurl -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"}Acciones de grupo
Crear un grupo, sumar y sacar participantes y administradores, cambiar su nombre, descripción, foto y ajustes, su link de invitación y las solicitudes para unirse, y ver cómo salió cada acción.
Sumar participantes a un grupo POST
Ú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.